xref: /netbsd-src/include/string.h (revision f8cf1a9151c7af1cb0bd8b09c13c66bca599c027)
1 /*	$NetBSD: string.h,v 1.57 2024/11/02 02:43:48 riastradh Exp $	*/
2 
3 /*-
4  * Copyright (c) 1990, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the name of the University nor the names of its contributors
16  *    may be used to endorse or promote products derived from this software
17  *    without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  *
31  *	@(#)string.h	8.1 (Berkeley) 6/2/93
32  */
33 
34 #ifndef _STRING_H_
35 #define	_STRING_H_
36 #include <machine/ansi.h>
37 
38 #ifdef	_BSD_SIZE_T_
39 typedef	_BSD_SIZE_T_	size_t;
40 #undef	_BSD_SIZE_T_
41 #endif
42 
43 #include <sys/null.h>
44 
45 #include <sys/cdefs.h>
46 #include <sys/featuretest.h>
47 
48 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
49 #  ifndef __LOCALE_T_DECLARED
50 typedef struct _locale		*locale_t;
51 #  define __LOCALE_T_DECLARED
52 #  endif
53 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
54 
55 __BEGIN_DECLS
56 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
57 void	*memccpy(void *, const void *, int, size_t);
58 #endif /* _XOPEN_SOURCE || _NETBSD_SOURCE */
59 void	*memchr(const void *, int, size_t);
60 int	 memcmp(const void *, const void *, size_t);
61 void	*memcpy(void * __restrict, const void * __restrict, size_t);
62 #if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
63 void	*memmem(const void *, size_t, const void *, size_t);
64 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
65 void	*memmove(void *, const void *, size_t);
66 void	*memset(void *, int, size_t);
67 #if (__STDC_VERSION__ - 0 >= 202311L) || defined(_ISOC23_SOURCE) || \
68     defined(_NETBSD_SOURCE)
69 void	*memset_explicit(void *, int, size_t);
70 #endif
71 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
72 char	*stpcpy(char * __restrict, const char * __restrict);
73 char	*stpncpy(char * __restrict, const char * __restrict, size_t);
74 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
75 char	*strcat(char * __restrict, const char * __restrict);
76 char	*strchr(const char *, int);
77 int	 strcmp(const char *, const char *);
78 int	 strcoll(const char *, const char *);
79 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
80 int	 strcoll_l(const char *, const char *, locale_t);
81 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
82 char	*strcpy(char * __restrict, const char * __restrict);
83 size_t	 strcspn(const char *, const char *);
84 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_XOPEN_SOURCE) || \
85     defined(_NETBSD_SOURCE)
86 char	*strdup(const char *);
87 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE */
88 __aconst char *strerror(int);
89 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
90 __aconst char *strerror_l(int, locale_t);
91 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
92 #if (_POSIX_C_SOURCE - 0 >= 200112L) || \
93     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
94 int	 strerror_r(int, char *, size_t);
95 #endif /* _POSIX_C_SOURCE || _REENTRANT || _NETBSD_SOURCE */
96 #if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
97 size_t	 strlcat(char * __restrict, const char * __restrict, size_t);
98 size_t	 strlcpy(char * __restrict, const char * __restrict, size_t);
99 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
100 size_t	 strlen(const char *);
101 char	*strncat(char * __restrict, const char * __restrict, size_t);
102 int	 strncmp(const char *, const char *, size_t);
103 char	*strncpy(char * __restrict, const char * __restrict, size_t);
104 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
105 char	*strndup(const char *, size_t);
106 size_t	strnlen(const char *, size_t);
107 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
108 char	*strpbrk(const char *, const char *);
109 char	*strrchr(const char *, int);
110 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
111 #ifndef __STRSIGNAL_DECLARED
112 #define __STRSIGNAL_DECLARED
113 /* also in unistd.h */
114 __aconst char *strsignal(int);
115 #endif /* __STRSIGNAL_DECLARED */
116 #endif
117 size_t	 strspn(const char *, const char *);
118 char	*strstr(const char *, const char *);
119 char	*strtok(char * __restrict, const char * __restrict);
120 #if (_POSIX_C_SOURCE - 0 >= 200112L) || \
121     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
122 char	*strtok_r(char *, const char *, char **);
123 #endif /* _POSIX_C_SOURCE || _REENTRANT || _NETBSD_SOURCE */
124 size_t	 strxfrm(char * __restrict, const char * __restrict, size_t);
125 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
126 size_t	 strxfrm_l(char * __restrict, const char * __restrict, size_t,
127 	    locale_t);
128 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
129 __END_DECLS
130 
131 #if defined(_NETBSD_SOURCE)
132 #include <strings.h>		/* for backwards-compatibility */
133 __BEGIN_DECLS
134 char	*strcasestr(const char *, const char *);
135 char	*strchrnul(const char *, int);
136 char	*strsep(char **, const char *);
137 char	*stresep(char **, const char *, int);
138 char	*strnstr(const char *, const char *, size_t);
139 void	*memrchr(const void *, int, size_t);
140 void	*mempcpy(void * __restrict, const void * __restrict, size_t);
141 void	*explicit_memset(void *, int, size_t);
142 int	consttime_memequal(const void *, const void *, size_t);
143 __END_DECLS
144 #endif /* _NETBSD_SOURCE */
145 
146 #if _FORTIFY_SOURCE > 0
147 #include <ssp/string.h>
148 #endif
149 #endif /* !defined(_STRING_H_) */
150