xref: /titanic_52/usr/src/head/string.h (revision 23a1ccea6aac035f084a7a4cdc968687d1b02daf)
17c478bd9Sstevel@tonic-gate /*
27c478bd9Sstevel@tonic-gate  * CDDL HEADER START
37c478bd9Sstevel@tonic-gate  *
47c478bd9Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
59acbbeafSnn35248  * Common Development and Distribution License (the "License").
69acbbeafSnn35248  * You may not use this file except in compliance with the License.
77c478bd9Sstevel@tonic-gate  *
87c478bd9Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bd9Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
107c478bd9Sstevel@tonic-gate  * See the License for the specific language governing permissions
117c478bd9Sstevel@tonic-gate  * and limitations under the License.
127c478bd9Sstevel@tonic-gate  *
137c478bd9Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
147c478bd9Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bd9Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
167c478bd9Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
177c478bd9Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
187c478bd9Sstevel@tonic-gate  *
197c478bd9Sstevel@tonic-gate  * CDDL HEADER END
207c478bd9Sstevel@tonic-gate  */
217c478bd9Sstevel@tonic-gate 
227c478bd9Sstevel@tonic-gate /*
23*23a1cceaSRoger A. Faulkner  * Copyright (c) 1989, 2010, Oracle and/or its affiliates. All rights reserved.
247c478bd9Sstevel@tonic-gate  */
257c478bd9Sstevel@tonic-gate 
26*23a1cceaSRoger A. Faulkner /*	Copyright (c) 1988 AT&T	*/
27*23a1cceaSRoger A. Faulkner /*	  All Rights Reserved  	*/
28*23a1cceaSRoger A. Faulkner 
297c478bd9Sstevel@tonic-gate #ifndef _STRING_H
307c478bd9Sstevel@tonic-gate #define	_STRING_H
317c478bd9Sstevel@tonic-gate 
327c478bd9Sstevel@tonic-gate #include <iso/string_iso.h>
337c478bd9Sstevel@tonic-gate 
347c478bd9Sstevel@tonic-gate /*
357c478bd9Sstevel@tonic-gate  * Allow global visibility for symbols defined in
367c478bd9Sstevel@tonic-gate  * C++ "std" namespace in <iso/string_iso.h>.
377c478bd9Sstevel@tonic-gate  */
387c478bd9Sstevel@tonic-gate #if __cplusplus >= 199711L
397c478bd9Sstevel@tonic-gate using std::size_t;
407c478bd9Sstevel@tonic-gate using std::memchr;
417c478bd9Sstevel@tonic-gate using std::memcmp;
427c478bd9Sstevel@tonic-gate using std::memcpy;
437c478bd9Sstevel@tonic-gate using std::memmove;
447c478bd9Sstevel@tonic-gate using std::memset;
457c478bd9Sstevel@tonic-gate using std::strcat;
467c478bd9Sstevel@tonic-gate using std::strchr;
477c478bd9Sstevel@tonic-gate using std::strcmp;
487c478bd9Sstevel@tonic-gate using std::strcoll;
497c478bd9Sstevel@tonic-gate using std::strcpy;
507c478bd9Sstevel@tonic-gate using std::strcspn;
517c478bd9Sstevel@tonic-gate using std::strerror;
527c478bd9Sstevel@tonic-gate using std::strlen;
537c478bd9Sstevel@tonic-gate using std::strncat;
547c478bd9Sstevel@tonic-gate using std::strncmp;
557c478bd9Sstevel@tonic-gate using std::strncpy;
567c478bd9Sstevel@tonic-gate using std::strpbrk;
577c478bd9Sstevel@tonic-gate using std::strrchr;
587c478bd9Sstevel@tonic-gate using std::strspn;
597c478bd9Sstevel@tonic-gate using std::strstr;
607c478bd9Sstevel@tonic-gate using std::strtok;
617c478bd9Sstevel@tonic-gate using std::strxfrm;
627c478bd9Sstevel@tonic-gate #endif
637c478bd9Sstevel@tonic-gate 
647c478bd9Sstevel@tonic-gate #ifdef	__cplusplus
657c478bd9Sstevel@tonic-gate extern "C" {
667c478bd9Sstevel@tonic-gate #endif
677c478bd9Sstevel@tonic-gate 
687c478bd9Sstevel@tonic-gate #if defined(__STDC__)
697c478bd9Sstevel@tonic-gate 
707c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || \
717c478bd9Sstevel@tonic-gate 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
727c478bd9Sstevel@tonic-gate 	defined(_XPG6) || defined(_REENTRANT)
737c478bd9Sstevel@tonic-gate extern int strerror_r(int, char *, size_t);
747c478bd9Sstevel@tonic-gate #endif
757c478bd9Sstevel@tonic-gate 
767c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || \
777c478bd9Sstevel@tonic-gate 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
787c478bd9Sstevel@tonic-gate 	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_REENTRANT)
797c478bd9Sstevel@tonic-gate extern char *strtok_r(char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
807c478bd9Sstevel@tonic-gate 	char **_RESTRICT_KYWD);
817c478bd9Sstevel@tonic-gate #endif
827c478bd9Sstevel@tonic-gate 
837c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || !defined(_STRICT_STDC) || \
847c478bd9Sstevel@tonic-gate 	defined(__XOPEN_OR_POSIX)
857c478bd9Sstevel@tonic-gate extern void *memccpy(void *_RESTRICT_KYWD, const void *_RESTRICT_KYWD,
867c478bd9Sstevel@tonic-gate 		int, size_t);
877c478bd9Sstevel@tonic-gate #endif
887c478bd9Sstevel@tonic-gate 
897c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || \
907c478bd9Sstevel@tonic-gate 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
91*23a1cceaSRoger A. Faulkner 	/* || defined(_XPG7) */
927c478bd9Sstevel@tonic-gate extern int strcasecmp(const char *, const char *);
937c478bd9Sstevel@tonic-gate extern int strncasecmp(const char *, const char *, size_t);
94*23a1cceaSRoger A. Faulkner extern char *stpcpy(char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD);
95*23a1cceaSRoger A. Faulkner extern char *stpncpy(char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD, size_t);
96*23a1cceaSRoger A. Faulkner extern char *strndup(const char *, size_t);
97*23a1cceaSRoger A. Faulkner extern size_t strnlen(const char *, size_t);
98*23a1cceaSRoger A. Faulkner extern char *strsignal(int);
99*23a1cceaSRoger A. Faulkner #endif
100*23a1cceaSRoger A. Faulkner 
101*23a1cceaSRoger A. Faulkner #if defined(__EXTENSIONS__) || \
102*23a1cceaSRoger A. Faulkner 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
103*23a1cceaSRoger A. Faulkner extern int uucopy(const void *_RESTRICT_KYWD, void *_RESTRICT_KYWD, size_t);
104*23a1cceaSRoger A. Faulkner extern int uucopystr(const void *_RESTRICT_KYWD, void *_RESTRICT_KYWD, size_t);
105*23a1cceaSRoger A. Faulkner extern int ffs(int);
106*23a1cceaSRoger A. Faulkner extern int ffsl(long);
107*23a1cceaSRoger A. Faulkner extern int ffsll(long long);
108*23a1cceaSRoger A. Faulkner extern int fls(int);
109*23a1cceaSRoger A. Faulkner extern int flsl(long);
110*23a1cceaSRoger A. Faulkner extern int flsll(long long);
111*23a1cceaSRoger A. Faulkner extern void *memmem(const void *, size_t, const void *, size_t);
112*23a1cceaSRoger A. Faulkner extern char *strcasestr(const char *, const char *);
113*23a1cceaSRoger A. Faulkner extern char *strnstr(const char *, const char *, size_t);
1147c478bd9Sstevel@tonic-gate extern size_t strlcpy(char *, const char *, size_t);
1157c478bd9Sstevel@tonic-gate extern size_t strlcat(char *, const char *, size_t);
116b811a51aSVladimir Kotal extern char *strsep(char **stringp, const char *delim);
117*23a1cceaSRoger A. Faulkner extern char *strchrnul(const char *, int);
1187c478bd9Sstevel@tonic-gate #endif /* defined(__EXTENSIONS__)... */
1197c478bd9Sstevel@tonic-gate 
1207c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || \
1217c478bd9Sstevel@tonic-gate 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
1227c478bd9Sstevel@tonic-gate 	defined(_XPG4_2)
1237c478bd9Sstevel@tonic-gate extern char *strdup(const char *);
1247c478bd9Sstevel@tonic-gate #endif
1257c478bd9Sstevel@tonic-gate 
126*23a1cceaSRoger A. Faulkner #if defined(__EXTENSIONS__) || \
127*23a1cceaSRoger A. Faulkner 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
128*23a1cceaSRoger A. Faulkner #if defined(__GNUC__)
129*23a1cceaSRoger A. Faulkner 
130*23a1cceaSRoger A. Faulkner /*
131*23a1cceaSRoger A. Faulkner  * gcc provides this inlining facility but Studio C does not.
132*23a1cceaSRoger A. Faulkner  * We should use it exclusively once Studio C also provides it.
133*23a1cceaSRoger A. Faulkner  */
134*23a1cceaSRoger A. Faulkner extern void *__builtin_alloca(size_t);
135*23a1cceaSRoger A. Faulkner 
136*23a1cceaSRoger A. Faulkner #define	strdupa(s)							\
137*23a1cceaSRoger A. Faulkner 	(__extension__(							\
138*23a1cceaSRoger A. Faulkner 	{								\
139*23a1cceaSRoger A. Faulkner 	char *__str = (char *)(s);					\
140*23a1cceaSRoger A. Faulkner 	strcpy((char *)__builtin_alloca(strlen(__str) + 1), __str);	\
141*23a1cceaSRoger A. Faulkner 	}))
142*23a1cceaSRoger A. Faulkner 
143*23a1cceaSRoger A. Faulkner #define	strndupa(s, n)							\
144*23a1cceaSRoger A. Faulkner 	(__extension__(							\
145*23a1cceaSRoger A. Faulkner 	{								\
146*23a1cceaSRoger A. Faulkner 	char *__str = (char *)(s);					\
147*23a1cceaSRoger A. Faulkner 	size_t __len = strnlen(__str, (n));				\
148*23a1cceaSRoger A. Faulkner 	(__str = strncpy((char *)__builtin_alloca(__len + 1),		\
149*23a1cceaSRoger A. Faulkner 	    __str, __len),						\
150*23a1cceaSRoger A. Faulkner 	__str[__len] = '\0', __str);					\
151*23a1cceaSRoger A. Faulkner 	}))
152*23a1cceaSRoger A. Faulkner 
153*23a1cceaSRoger A. Faulkner #else	/* __GNUC__ */
154*23a1cceaSRoger A. Faulkner 
155*23a1cceaSRoger A. Faulkner #if defined(unix)	/* excludes c99 */
156*23a1cceaSRoger A. Faulkner /*
157*23a1cceaSRoger A. Faulkner  * Studio C currently can't do the gcc-style inlining,
158*23a1cceaSRoger A. Faulkner  * so we use thread-local storage instead.
159*23a1cceaSRoger A. Faulkner  */
160*23a1cceaSRoger A. Faulkner extern void *__builtin_alloca(size_t);
161*23a1cceaSRoger A. Faulkner extern __thread char *__strdupa_str;
162*23a1cceaSRoger A. Faulkner extern __thread size_t __strdupa_len;
163*23a1cceaSRoger A. Faulkner 
164*23a1cceaSRoger A. Faulkner #define	strdupa(s)							\
165*23a1cceaSRoger A. Faulkner 	(__strdupa_str = (char *)(s), 					\
166*23a1cceaSRoger A. Faulkner 	strcpy((char *)__builtin_alloca(strlen(__strdupa_str) + 1),	\
167*23a1cceaSRoger A. Faulkner 	    __strdupa_str))
168*23a1cceaSRoger A. Faulkner 
169*23a1cceaSRoger A. Faulkner #define	strndupa(s, n)							\
170*23a1cceaSRoger A. Faulkner 	(__strdupa_str = (char *)(s),					\
171*23a1cceaSRoger A. Faulkner 	__strdupa_len = strnlen(__strdupa_str, (n)),			\
172*23a1cceaSRoger A. Faulkner 	__strdupa_str = strncpy((char *)__builtin_alloca(__strdupa_len + 1), \
173*23a1cceaSRoger A. Faulkner 	    __strdupa_str, __strdupa_len),				\
174*23a1cceaSRoger A. Faulkner 	__strdupa_str[__strdupa_len] = '\0', __strdupa_str)
175*23a1cceaSRoger A. Faulkner #endif	/* unix */
176*23a1cceaSRoger A. Faulkner 
177*23a1cceaSRoger A. Faulkner #endif	/* __GNUC__ */
178*23a1cceaSRoger A. Faulkner #endif	/* __EXTENSIONS__ ... */
179*23a1cceaSRoger A. Faulkner 
1807c478bd9Sstevel@tonic-gate #else	/* __STDC__ */
1817c478bd9Sstevel@tonic-gate 
1827c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || \
1837c478bd9Sstevel@tonic-gate 	defined(_XPG6) || defined(_REENTRANT)
1847c478bd9Sstevel@tonic-gate extern int strerror_r();
1857c478bd9Sstevel@tonic-gate #endif
1867c478bd9Sstevel@tonic-gate 
1877c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || \
1887c478bd9Sstevel@tonic-gate 	(_POSIX_C_SOURCE - 0 >= 199506L) || defined(_REENTRANT)
1897c478bd9Sstevel@tonic-gate extern char *strtok_r();
1907c478bd9Sstevel@tonic-gate #endif
1917c478bd9Sstevel@tonic-gate 
1927c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || !defined(_STRICT_STDC) || \
1937c478bd9Sstevel@tonic-gate 	defined(__XOPEN_OR_POSIX)
1947c478bd9Sstevel@tonic-gate extern void *memccpy();
1957c478bd9Sstevel@tonic-gate #endif
1967c478bd9Sstevel@tonic-gate 
197*23a1cceaSRoger A. Faulkner #if defined(__EXTENSIONS__) || \
198*23a1cceaSRoger A. Faulkner 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
199*23a1cceaSRoger A. Faulkner 	/* || defined(_XPG7) */
2007c478bd9Sstevel@tonic-gate extern int strcasecmp();
2017c478bd9Sstevel@tonic-gate extern int strncasecmp();
202*23a1cceaSRoger A. Faulkner extern char *stpcpy();
203*23a1cceaSRoger A. Faulkner extern char *stpncpy();
204*23a1cceaSRoger A. Faulkner extern char *strndup();
205*23a1cceaSRoger A. Faulkner extern size_t strnlen();
206*23a1cceaSRoger A. Faulkner extern char *strsignal();
207*23a1cceaSRoger A. Faulkner #endif
208*23a1cceaSRoger A. Faulkner 
209*23a1cceaSRoger A. Faulkner #if defined(__EXTENSIONS__) || \
210*23a1cceaSRoger A. Faulkner 	(!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))
211*23a1cceaSRoger A. Faulkner extern int uucopy();
212*23a1cceaSRoger A. Faulkner extern int uucopystr();
213*23a1cceaSRoger A. Faulkner extern int ffs();
214*23a1cceaSRoger A. Faulkner extern int ffsl();
215*23a1cceaSRoger A. Faulkner extern int ffsll();
216*23a1cceaSRoger A. Faulkner extern int fls();
217*23a1cceaSRoger A. Faulkner extern int flsl();
218*23a1cceaSRoger A. Faulkner extern int flsll();
219*23a1cceaSRoger A. Faulkner extern char *strcasestr();
220*23a1cceaSRoger A. Faulkner extern char *strnstr();
2217c478bd9Sstevel@tonic-gate extern size_t strlcpy();
2227c478bd9Sstevel@tonic-gate extern size_t strlcat();
223b811a51aSVladimir Kotal extern char *strsep();
224*23a1cceaSRoger A. Faulkner extern char *strchrnul();
2257c478bd9Sstevel@tonic-gate #endif /* defined(__EXTENSIONS__) ... */
2267c478bd9Sstevel@tonic-gate 
2277c478bd9Sstevel@tonic-gate #if defined(__EXTENSIONS__) || !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2)
2287c478bd9Sstevel@tonic-gate extern char *strdup();
2297c478bd9Sstevel@tonic-gate #endif
2307c478bd9Sstevel@tonic-gate 
2317c478bd9Sstevel@tonic-gate #endif	/* __STDC__ */
2327c478bd9Sstevel@tonic-gate 
2337c478bd9Sstevel@tonic-gate #ifdef	__cplusplus
2347c478bd9Sstevel@tonic-gate }
2357c478bd9Sstevel@tonic-gate #endif
2367c478bd9Sstevel@tonic-gate 
2377c478bd9Sstevel@tonic-gate #endif	/* _STRING_H */
238