1/*
2 * Copyright (c) 2000, 2007, 2010 Apple Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23/*-
24 * Copyright (c) 1990, 1993
25 *	The Regents of the University of California.  All rights reserved.
26 *
27 * Redistribution and use in source and binary forms, with or without
28 * modification, are permitted provided that the following conditions
29 * are met:
30 * 1. Redistributions of source code must retain the above copyright
31 *    notice, this list of conditions and the following disclaimer.
32 * 2. Redistributions in binary form must reproduce the above copyright
33 *    notice, this list of conditions and the following disclaimer in the
34 *    documentation and/or other materials provided with the distribution.
35 * 3. All advertising materials mentioning features or use of this software
36 *    must display the following acknowledgement:
37 *	This product includes software developed by the University of
38 *	California, Berkeley and its contributors.
39 * 4. Neither the name of the University nor the names of its contributors
40 *    may be used to endorse or promote products derived from this software
41 *    without specific prior written permission.
42 *
43 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
47 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * SUCH DAMAGE.
54 *
55 *	@(#)string.h	8.1 (Berkeley) 6/2/93
56 */
57
58#ifndef _STRING_H_
59#define	_STRING_H_
60
61#include <_types.h>
62#include <sys/cdefs.h>
63#include <Availability.h>
64#include <sys/_types/_size_t.h>
65#include <sys/_types/_null.h>
66
67/* ANSI-C */
68
69__BEGIN_DECLS
70void	*memchr(const void *, int, size_t);
71int	 memcmp(const void *, const void *, size_t);
72void	*memcpy(void *, const void *, size_t);
73void	*memmove(void *, const void *, size_t);
74void	*memset(void *, int, size_t);
75char	*strcat(char *, const char *);
76char	*strchr(const char *, int);
77int	 strcmp(const char *, const char *);
78int	 strcoll(const char *, const char *);
79char	*strcpy(char *, const char *);
80size_t	 strcspn(const char *, const char *);
81//Begin-Libc
82#ifndef LIBC_ALIAS_STRERROR
83//End-Libc
84char	*strerror(int) __DARWIN_ALIAS(strerror);
85//Begin-Libc
86#else /* LIBC_ALIAS_STRERROR */
87char	*strerror(int) LIBC_ALIAS(strerror);
88#endif /* !LIBC_ALIAS_STRERROR */
89//End-Libc
90size_t	 strlen(const char *);
91char	*strncat(char *, const char *, size_t);
92int	 strncmp(const char *, const char *, size_t);
93char	*strncpy(char *, const char *, size_t);
94char	*strpbrk(const char *, const char *);
95char	*strrchr(const char *, int);
96size_t	 strspn(const char *, const char *);
97char	*strstr(const char *, const char *);
98char	*strtok(char *, const char *);
99size_t	 strxfrm(char *, const char *, size_t);
100__END_DECLS
101
102
103
104/* Additional functionality provided by:
105 * POSIX.1c-1995,
106 * POSIX.1i-1995,
107 * and the omnibus ISO/IEC 9945-1: 1996
108 */
109
110#if __DARWIN_C_LEVEL >= 199506L
111__BEGIN_DECLS
112char	*strtok_r(char *, const char *, char **);
113__END_DECLS
114#endif /* __DARWIN_C_LEVEL >= 199506L */
115
116
117
118/* Additional functionality provided by:
119 * POSIX.1-2001
120 */
121
122#if __DARWIN_C_LEVEL >= 200112L
123__BEGIN_DECLS
124int	 strerror_r(int, char *, size_t);
125char	*strdup(const char *);
126void	*memccpy(void *, const void *, int, size_t);
127__END_DECLS
128#endif /* __DARWIN_C_LEVEL >= 200112L */
129
130
131
132/* Additional functionality provided by:
133 * POSIX.1-2008
134 */
135
136#if __DARWIN_C_LEVEL >= 200809L
137__BEGIN_DECLS
138char	*stpcpy(char *, const char *);
139char    *stpncpy(char *, const char *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
140char	*strndup(const char *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
141size_t   strnlen(const char *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
142char	*strsignal(int sig);
143__END_DECLS
144#endif /* __DARWIN_C_LEVEL >= 200809L */
145
146/* C11 Annex K */
147
148#if defined(__STDC_WANT_LIB_EXT1__) && __STDC_WANT_LIB_EXT1__ >= 1
149#include <sys/_types/_rsize_t.h>
150#include <sys/_types/_errno_t.h>
151
152__BEGIN_DECLS
153errno_t	memset_s(void *, rsize_t, int, rsize_t) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
154__END_DECLS
155#endif
156
157/* Darwin extensions */
158
159#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
160#include <sys/_types/_ssize_t.h>
161
162__BEGIN_DECLS
163void	*memmem(const void *, size_t, const void *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
164void     memset_pattern4(void *, const void *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
165void     memset_pattern8(void *, const void *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
166void     memset_pattern16(void *, const void *, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
167
168char	*strcasestr(const char *, const char *);
169char	*strnstr(const char *, const char *, size_t);
170size_t	 strlcat(char *, const char *, size_t);
171size_t	 strlcpy(char *, const char *, size_t);
172void	 strmode(int, char *);
173char	*strsep(char **, const char *);
174
175/* SUS places swab() in unistd.h.  It is listed here for source compatibility */
176void	 swab(const void * __restrict, void * __restrict, ssize_t);
177__END_DECLS
178
179/* Some functions historically defined in string.h were placed in strings.h
180 * by SUS.  We are using "strings.h" instead of <strings.h> to avoid an issue
181 * where /Developer/Headers/FlatCarbon/Strings.h could be included instead on
182 * case-insensitive file systems.
183 */
184#include "strings.h"
185#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
186
187
188#ifdef _USE_EXTENDED_LOCALES_
189#include <xlocale/_string.h>
190#endif /* _USE_EXTENDED_LOCALES_ */
191
192#if defined (__GNUC__) && _FORTIFY_SOURCE > 0 && !defined (__cplusplus)
193/* Security checking functions.  */
194#include <secure/_string.h>
195#endif
196
197#endif /* _STRING_H_ */
198