stdlib_ext.h revision 8bf1194fe59ab6a4905efd0ff00cd6b7462247e1
1/* Copyright (c) 2008-2011 Freescale Semiconductor, Inc.
2 * All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are met:
6 *     * Redistributions of source code must retain the above copyright
7 *       notice, this list of conditions and the following disclaimer.
8 *     * Redistributions in binary form must reproduce the above copyright
9 *       notice, this list of conditions and the following disclaimer in the
10 *       documentation and/or other materials provided with the distribution.
11 *     * Neither the name of Freescale Semiconductor nor the
12 *       names of its contributors may be used to endorse or promote products
13 *       derived from this software without specific prior written permission.
14 *
15 *
16 * ALTERNATIVELY, this software may be distributed under the terms of the
17 * GNU General Public License ("GPL") as published by the Free Software
18 * Foundation, either version 2 of that License or (at your option) any
19 * later version.
20 *
21 * THIS SOFTWARE IS PROVIDED BY Freescale Semiconductor ``AS IS'' AND ANY
22 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
24 * DISCLAIMED. IN NO EVENT SHALL Freescale Semiconductor BE LIABLE FOR ANY
25 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
26 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
28 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 */
32
33
34#ifndef __STDLIB_EXT_H
35#define __STDLIB_EXT_H
36
37
38#if (defined(NCSW_LINUX)) && defined(__KERNEL__)
39#include "stdarg_ext.h"
40#include "std_ext.h"
41
42
43/**
44 * strtoul - convert a string to an uint32_t
45 * @cp: The start of the string
46 * @endp: A pointer to the end of the parsed string will be placed here
47 * @base: The number base to use
48 */
49uint32_t strtoul(const char *cp,char **endp,uint32_t base);
50
51/**
52 * strtol - convert a string to a int32_t
53 * @cp: The start of the string
54 * @endp: A pointer to the end of the parsed string will be placed here
55 * @base: The number base to use
56 */
57long strtol(const char *cp,char **endp,uint32_t base);
58
59/**
60 * strtoull - convert a string to an uint64_t
61 * @cp: The start of the string
62 * @endp: A pointer to the end of the parsed string will be placed here
63 * @base: The number base to use
64 */
65uint64_t strtoull(const char *cp,char **endp,uint32_t base);
66
67/**
68 * strtoll - convert a string to a int64 long
69 * @cp: The start of the string
70 * @endp: A pointer to the end of the parsed string will be placed here
71 * @base: The number base to use
72 */
73long long strtoll(const char *cp,char **endp,uint32_t base);
74
75/**
76 * atoi - convert a character to a int
77 * @s: The start of the string
78 */
79int atoi(const char *s);
80
81/**
82 * strnlen - Find the length of a length-limited string
83 * @s: The string to be sized
84 * @count: The maximum number of bytes to search
85 */
86size_t strnlen(const char * s, size_t count);
87
88/**
89 * strlen - Find the length of a string
90 * @s: The string to be sized
91 */
92size_t strlen(const char * s);
93
94/**
95 * strtok - Split a string into tokens
96 * @s: The string to be searched
97 * @ct: The characters to search for
98 *
99 * WARNING: strtok is deprecated, use strsep instead.
100 */
101char * strtok(char * s,const char * ct);
102
103/**
104 * strncpy - Copy a length-limited, %NUL-terminated string
105 * @dest: Where to copy the string to
106 * @src: Where to copy the string from
107 * @count: The maximum number of bytes to copy
108 *
109 * Note that unlike userspace strncpy, this does not %NUL-pad the buffer.
110 * However, the result is not %NUL-terminated if the source exceeds
111 * @count bytes.
112 */
113char * strncpy(char * dest,const char *src,size_t count);
114
115/**
116 * strcpy - Copy a %NUL terminated string
117 * @dest: Where to copy the string to
118 * @src: Where to copy the string from
119 */
120char * strcpy(char * dest,const char *src);
121
122/**
123 * vsscanf - Unformat a buffer into a list of arguments
124 * @buf:    input buffer
125 * @fmt:    format of buffer
126 * @args:    arguments
127 */
128int vsscanf(const char * buf, const char * fmt, va_list args);
129
130/**
131 * vsnprintf - Format a string and place it in a buffer
132 * @buf: The buffer to place the result into
133 * @size: The size of the buffer, including the trailing null space
134 * @fmt: The format string to use
135 * @args: Arguments for the format string
136 *
137 * Call this function if you are already dealing with a va_list.
138 * You probably want snprintf instead.
139 */
140int vsnprintf(char *buf, size_t size, const char *fmt, va_list args);
141
142/**
143 * vsprintf - Format a string and place it in a buffer
144 * @buf: The buffer to place the result into
145 * @fmt: The format string to use
146 * @args: Arguments for the format string
147 *
148 * Call this function if you are already dealing with a va_list.
149 * You probably want sprintf instead.
150 */
151int vsprintf(char *buf, const char *fmt, va_list args);
152
153#elif defined(NCSW_FREEBSD)
154#include <sys/param.h>
155#include <sys/kernel.h>
156#include <sys/libkern.h>
157
158#else
159#include <stdlib.h>
160#include <stdio.h>
161#endif /* defined(NCSW_LINUX) && defined(__KERNEL__) */
162
163#include "std_ext.h"
164
165
166#endif /* __STDLIB_EXT_H */
167