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 *__s, int __c, size_t __n);
71int memcmp(const void *__s1, const void *__s2, size_t __n);
72void *memcpy(void *__dst, const void *__src, size_t __n);
73void *memmove(void *__dst, const void *__src, size_t __len);
74void *memset(void *__b, int __c, size_t __len);
75char *strcat(char *__s1, const char *__s2);
76char *strchr(const char *__s, int __c);
77int strcmp(const char *__s1, const char *__s2);
78int strcoll(const char *__s1, const char *__s2);
79char *strcpy(char *__dst, const char *__src);
80size_t strcspn(const char *__s, const char *__charset);
81char *strerror(int __errnum) __DARWIN_ALIAS(strerror);
82size_t strlen(const char *__s);
83char *strncat(char *__s1, const char *__s2, size_t __n);
84int strncmp(const char *__s1, const char *__s2, size_t __n);
85char *strncpy(char *__dst, const char *__src, size_t __n);
86char *strpbrk(const char *__s, const char *__charset);
87char *strrchr(const char *__s, int __c);
88size_t strspn(const char *__s, const char *__charset);
89char *strstr(const char *__big, const char *__little);
90char *strtok(char *__str, const char *__sep);
91size_t strxfrm(char *__s1, const char *__s2, size_t __n);
92__END_DECLS
93
94
95
96/* Additional functionality provided by:
97 * POSIX.1c-1995,
98 * POSIX.1i-1995,
99 * and the omnibus ISO/IEC 9945-1: 1996
100 */
101
102#if __DARWIN_C_LEVEL >= 199506L
103__BEGIN_DECLS
104char *strtok_r(char *__str, const char *__sep, char **__lasts);
105__END_DECLS
106#endif /* __DARWIN_C_LEVEL >= 199506L */
107
108
109
110/* Additional functionality provided by:
111 * POSIX.1-2001
112 */
113
114#if __DARWIN_C_LEVEL >= 200112L
115__BEGIN_DECLS
116int strerror_r(int __errnum, char *__strerrbuf, size_t __buflen);
117char *strdup(const char *__s1);
118void *memccpy(void *__dst, const void *__src, int __c, size_t __n);
119__END_DECLS
120#endif /* __DARWIN_C_LEVEL >= 200112L */
121
122
123
124/* Additional functionality provided by:
125 * POSIX.1-2008
126 */
127
128#if __DARWIN_C_LEVEL >= 200809L
129__BEGIN_DECLS
130char *stpcpy(char *__dst, const char *__src);
131char *stpncpy(char *__dst, const char *__src, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
132char *strndup(const char *__s1, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
133size_t strnlen(const char *__s1, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
134char *strsignal(int __sig);
135__END_DECLS
136#endif /* __DARWIN_C_LEVEL >= 200809L */
137
138/* C11 Annex K */
139
140#if defined(__STDC_WANT_LIB_EXT1__) && __STDC_WANT_LIB_EXT1__ >= 1
141#include <sys/_types/_rsize_t.h>
142#include <sys/_types/_errno_t.h>
143
144__BEGIN_DECLS
145errno_t memset_s(void *__s, rsize_t __smax, int __c, rsize_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
146__END_DECLS
147#endif
148
149/* Darwin extensions */
150
151#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
152#include <sys/_types/_ssize_t.h>
153
154__BEGIN_DECLS
155void *memmem(const void *__big, size_t __big_len, const void *__little, size_t __little_len) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
156void memset_pattern4(void *__b, const void *__pattern4, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
157void memset_pattern8(void *__b, const void *__pattern8, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
158void memset_pattern16(void *__b, const void *__pattern16, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
159
160char *strcasestr(const char *__big, const char *__little);
161char *strnstr(const char *__big, const char *__little, size_t __len);
162size_t strlcat(char *__dst, const char *__source, size_t __size);
163size_t strlcpy(char *__dst, const char *__source, size_t __size);
164void strmode(int __mode, char *__bp);
165char *strsep(char **__stringp, const char *__delim);
166
167/* SUS places swab() in unistd.h. It is listed here for source compatibility */
168void swab(const void * __restrict, void * __restrict, ssize_t);
169
170__OSX_AVAILABLE(10.12.1) __IOS_AVAILABLE(10.1)
171__TVOS_AVAILABLE(10.0.1) __WATCHOS_AVAILABLE(3.1)
172int timingsafe_bcmp(const void *__b1, const void *__b2, size_t __len);
173__END_DECLS
174
175/* Some functions historically defined in string.h were placed in strings.h
176 * by SUS. We are using "strings.h" instead of <strings.h> to avoid an issue
177 * where /Developer/Headers/FlatCarbon/Strings.h could be included instead on
178 * case-insensitive file systems.
179 */
180#include "strings.h"
181#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
182
183
184#ifdef _USE_EXTENDED_LOCALES_
185#include <xlocale/_string.h>
186#endif /* _USE_EXTENDED_LOCALES_ */
187
188#if defined (__GNUC__) && _FORTIFY_SOURCE > 0 && !defined (__cplusplus)
189/* Security checking functions. */
190#include <secure/_string.h>
191#endif
192
193#endif /* _STRING_H_ */
194