xref: /freebsd/include/string.h (revision ef36b3f75658d201edb495068db5e1be49593de5)
1 /*-
2  * Copyright (c) 1990, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the University nor the names of its contributors
14  *    may be used to endorse or promote products derived from this software
15  *    without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  *	@(#)string.h	8.1 (Berkeley) 6/2/93
30  * $FreeBSD$
31  */
32 
33 #ifndef _STRING_H_
34 #define	_STRING_H_
35 
36 #include <sys/cdefs.h>
37 #include <sys/_null.h>
38 #include <sys/_types.h>
39 
40 /*
41  * Prototype functions which were historically defined in <string.h>, but
42  * are required by POSIX to be prototyped in <strings.h>.
43  */
44 #if __BSD_VISIBLE
45 #include <strings.h>
46 #endif
47 
48 #ifndef _SIZE_T_DECLARED
49 typedef	__size_t	size_t;
50 #define	_SIZE_T_DECLARED
51 #endif
52 
53 __BEGIN_DECLS
54 #if __XSI_VISIBLE >= 600
55 void	*memccpy(void * __restrict, const void * __restrict, int, size_t);
56 #endif
57 void	*memchr(const void *, int, size_t) __pure;
58 #if __BSD_VISIBLE
59 void	*memrchr(const void *, int, size_t) __pure;
60 #endif
61 int	 memcmp(const void *, const void *, size_t) __pure;
62 void	*memcpy(void * __restrict, const void * __restrict, size_t);
63 #if __BSD_VISIBLE
64 void	*memmem(const void *, size_t, const void *, size_t) __pure;
65 #endif
66 void	*memmove(void *, const void *, size_t);
67 void	*memset(void *, int, size_t);
68 #if __POSIX_VISIBLE >= 200809
69 char	*stpcpy(char * __restrict, const char * __restrict);
70 char	*stpncpy(char * __restrict, const char * __restrict, size_t);
71 #endif
72 #if __BSD_VISIBLE
73 char	*strcasestr(const char *, const char *) __pure;
74 #endif
75 char	*strcat(char * __restrict, const char * __restrict);
76 char	*strchr(const char *, int) __pure;
77 #if __BSD_VISIBLE
78 char	*strchrnul(const char*, int) __pure;
79 #endif
80 int	 strcmp(const char *, const char *) __pure;
81 int	 strcoll(const char *, const char *);
82 char	*strcpy(char * __restrict, const char * __restrict);
83 size_t	 strcspn(const char *, const char *) __pure;
84 #if __POSIX_VISIBLE >= 200112 || __XSI_VISIBLE
85 char	*strdup(const char *) __malloc_like;
86 #endif
87 char	*strerror(int);
88 #if __POSIX_VISIBLE >= 200112
89 int	 strerror_r(int, char *, size_t);
90 #endif
91 #if __BSD_VISIBLE
92 size_t	 strlcat(char * __restrict, const char * __restrict, size_t);
93 size_t	 strlcpy(char * __restrict, const char * __restrict, size_t);
94 #endif
95 size_t	 strlen(const char *) __pure;
96 #if __BSD_VISIBLE
97 void	 strmode(int, char *);
98 #endif
99 char	*strncat(char * __restrict, const char * __restrict, size_t);
100 int	 strncmp(const char *, const char *, size_t) __pure;
101 char	*strncpy(char * __restrict, const char * __restrict, size_t);
102 #if __POSIX_VISIBLE >= 200809
103 char	*strndup(const char *, size_t) __malloc_like;
104 size_t	 strnlen(const char *, size_t) __pure;
105 #endif
106 #if __BSD_VISIBLE
107 char	*strnstr(const char *, const char *, size_t) __pure;
108 #endif
109 char	*strpbrk(const char *, const char *) __pure;
110 char	*strrchr(const char *, int) __pure;
111 #if __BSD_VISIBLE
112 char	*strsep(char **, const char *);
113 #endif
114 #if __POSIX_VISIBLE >= 200809
115 char	*strsignal(int);
116 #endif
117 size_t	 strspn(const char *, const char *) __pure;
118 char	*strstr(const char *, const char *) __pure;
119 char	*strtok(char * __restrict, const char * __restrict);
120 #if __POSIX_VISIBLE >= 199506 || __XSI_VISIBLE >= 500
121 char	*strtok_r(char *, const char *, char **);
122 #endif
123 size_t	 strxfrm(char * __restrict, const char * __restrict, size_t);
124 #if __BSD_VISIBLE
125 
126 #ifndef _SWAB_DECLARED
127 #define _SWAB_DECLARED
128 
129 #ifndef _SSIZE_T_DECLARED
130 typedef	__ssize_t	ssize_t;
131 #define	_SSIZE_T_DECLARED
132 #endif /* _SIZE_T_DECLARED */
133 
134 void	 swab(const void * __restrict, void * __restrict, ssize_t);
135 #endif /* _SWAB_DECLARED */
136 
137 int	 timingsafe_bcmp(const void *, const void *, size_t);
138 int	 timingsafe_memcmp(const void *, const void *, size_t);
139 #endif /* __BSD_VISIBLE */
140 
141 #if __POSIX_VISIBLE >= 200809 || defined(_XLOCALE_H_)
142 #include <xlocale/_string.h>
143 #endif
144 
145 #if __EXT1_VISIBLE
146 
147 #ifndef _RSIZE_T_DEFINED
148 #define _RSIZE_T_DEFINED
149 typedef size_t rsize_t;
150 #endif
151 
152 #ifndef _ERRNO_T_DEFINED
153 #define _ERRNO_T_DEFINED
154 typedef int errno_t;
155 #endif
156 
157 /* ISO/IEC 9899:2011 K.3.7.4.1.1 */
158 errno_t memset_s(void *, rsize_t, int, rsize_t);
159 #endif /* __EXT1_VISIBLE */
160 __END_DECLS
161 
162 #endif /* _STRING_H_ */
163