]> git.saurik.com Git - apple/libc.git/blame_incremental - include/string.h
Libc-1082.50.1.tar.gz
[apple/libc.git] / include / string.h
... / ...
CommitLineData
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_ */