Libc-1439.100.3.tar.gz

[apple/libc.git] / include / string.h

diff --git a/include/string.h b/include/string.h
index 98c37d1436c4f61972473b03714e12bed6b66f02..479c759af86171a288e9d7ed1f7c3950e724af6a 100644 (file)
--- a/include/string.h
+++ b/include/string.h
@@ -1,15 +1,15 @@
 /*
 /*

- * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000, 2007, 2010 Apple Inc. All rights reserved.

  *
  * @APPLE_LICENSE_HEADER_START@
  *
  * @APPLE_LICENSE_HEADER_START@

- * 
+ *

  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
  * compliance with the License. Please obtain a copy of the License at
  * http://www.opensource.apple.com/apsl/ and read it before using this
  * file.
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
  * compliance with the License. Please obtain a copy of the License at
  * http://www.opensource.apple.com/apsl/ and read it before using this
  * file.

- * 
+ *

  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,


@@ -17,7 +17,7 @@
  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  * Please see the License for the specific language governing rights and
  * limitations under the License.
  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  * Please see the License for the specific language governing rights and
  * limitations under the License.

- * 
+ *

  * @APPLE_LICENSE_HEADER_END@
  */
 /*-
  * @APPLE_LICENSE_HEADER_END@
  */
 /*-


@@ -57,84 +57,155 @@
 
 #ifndef _STRING_H_
 #define        _STRING_H_
 
 #ifndef _STRING_H_
 #define        _STRING_H_

+

 #include <_types.h>
 #include <_types.h>

+#include <sys/cdefs.h>
+#include <Availability.h>
+#include <sys/_types/_size_t.h>
+#include <sys/_types/_null.h>
+
+/* ANSI-C */
+
+__BEGIN_DECLS
+void   *memchr(const void *__s, int __c, size_t __n);
+int     memcmp(const void *__s1, const void *__s2, size_t __n);
+void   *memcpy(void *__dst, const void *__src, size_t __n);
+void   *memmove(void *__dst, const void *__src, size_t __len);
+void   *memset(void *__b, int __c, size_t __len);
+#ifndef UNIFDEF_DRIVERKIT
+char   *strcat(char *__s1, const char *__s2);
+#endif /* UNIFDEF_DRIVERKIT */
+char   *strchr(const char *__s, int __c);
+int     strcmp(const char *__s1, const char *__s2);
+int     strcoll(const char *__s1, const char *__s2);
+#ifndef UNIFDEF_DRIVERKIT
+char   *strcpy(char *__dst, const char *__src);
+#endif /* UNIFDEF_DRIVERKIT */
+size_t  strcspn(const char *__s, const char *__charset);
+//Begin-Libc
+#ifndef LIBC_ALIAS_STRERROR
+//End-Libc
+char   *strerror(int __errnum) __DARWIN_ALIAS(strerror);
+//Begin-Libc
+#else /* LIBC_ALIAS_STRERROR */
+char   *strerror(int __errnum) LIBC_ALIAS(strerror);
+#endif /* !LIBC_ALIAS_STRERROR */
+//End-Libc
+size_t  strlen(const char *__s);
+char   *strncat(char *__s1, const char *__s2, size_t __n);
+int     strncmp(const char *__s1, const char *__s2, size_t __n);
+char   *strncpy(char *__dst, const char *__src, size_t __n);
+char   *strpbrk(const char *__s, const char *__charset);
+char   *strrchr(const char *__s, int __c);
+size_t  strspn(const char *__s, const char *__charset);
+char   *strstr(const char *__big, const char *__little);
+char   *strtok(char *__str, const char *__sep);
+size_t  strxfrm(char *__s1, const char *__s2, size_t __n);
+__END_DECLS
+
+
+
+/* Additional functionality provided by:
+ * POSIX.1c-1995,
+ * POSIX.1i-1995,
+ * and the omnibus ISO/IEC 9945-1: 1996
+ */
+
+#if __DARWIN_C_LEVEL >= 199506L
+__BEGIN_DECLS
+char   *strtok_r(char *__str, const char *__sep, char **__lasts);
+__END_DECLS
+#endif /* __DARWIN_C_LEVEL >= 199506L */
+
+
+
+/* Additional functionality provided by:
+ * POSIX.1-2001
+ */
+
+#if __DARWIN_C_LEVEL >= 200112L
+__BEGIN_DECLS
+int     strerror_r(int __errnum, char *__strerrbuf, size_t __buflen);
+char   *strdup(const char *__s1);
+void   *memccpy(void *__dst, const void *__src, int __c, size_t __n);
+__END_DECLS
+#endif /* __DARWIN_C_LEVEL >= 200112L */
+

 
 

-#ifndef        _SIZE_T
-#define        _SIZE_T
-typedef        __darwin_size_t         size_t;
-#endif

 
 

-#ifndef _POSIX_C_SOURCE                /* For swab */
-#ifndef _SSIZE_T
-#define _SSIZE_T
-typedef __darwin_ssize_t       ssize_t;
+/* Additional functionality provided by:
+ * POSIX.1-2008
+ */
+
+#if __DARWIN_C_LEVEL >= 200809L
+__BEGIN_DECLS
+#ifndef UNIFDEF_DRIVERKIT
+char   *stpcpy(char *__dst, const char *__src);
+#endif /* UNIFDEF_DRIVERKIT */
+char    *stpncpy(char *__dst, const char *__src, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+char   *strndup(const char *__s1, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+size_t   strnlen(const char *__s1, size_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+char   *strsignal(int __sig);
+__END_DECLS
+#endif /* __DARWIN_C_LEVEL >= 200809L */
+
+/* C11 Annex K */
+
+#if defined(__STDC_WANT_LIB_EXT1__) && __STDC_WANT_LIB_EXT1__ >= 1
+#include <sys/_types/_rsize_t.h>
+#include <sys/_types/_errno_t.h>
+
+__BEGIN_DECLS
+errno_t        memset_s(void *__s, rsize_t __smax, int __c, rsize_t __n) __OSX_AVAILABLE_STARTING(__MAC_10_9, __IPHONE_7_0);
+__END_DECLS

 #endif
 #endif

-#endif /* ! _POSIX_C_SOURCE */

 
 

-#ifndef NULL
-#define NULL __DARWIN_NULL
-#endif /* ! NULL */
+/* Darwin extensions */

 
 

-#include <sys/cdefs.h>
+#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
+#include <sys/_types/_ssize_t.h>

 
 __BEGIN_DECLS
 
 __BEGIN_DECLS

-void   *memchr(const void *, int, size_t);
-int     memcmp(const void *, const void *, size_t);
-void   *memcpy(void *, const void *, size_t);
-void   *memmove(void *, const void *, size_t);
-void   *memset(void *, int, size_t);
-#ifndef _POSIX_C_SOURCE
-char   *stpcpy(char *, const char *);
-char   *strcasestr(const char *, const char *);
-#endif /* !_POSIX_C_SOURCE */
-char   *strcat(char *, const char *);
-char   *strchr(const char *, int);
-int     strcmp(const char *, const char *);
-int     strcoll(const char *, const char *);
-char   *strcpy(char *, const char *);
-size_t  strcspn(const char *, const char *);
-char   *strerror(int);
-int     strerror_r(int, char *, size_t);
-size_t  strlen(const char *);
-char   *strncat(char *, const char *, size_t);
-int     strncmp(const char *, const char *, size_t);
-char   *strncpy(char *, const char *, size_t);
-#ifndef _POSIX_C_SOURCE
-char   *strnstr(const char *, const char *, size_t);
-#endif /* !_POSIX_C_SOURCE */
-char   *strpbrk(const char *, const char *);
-char   *strrchr(const char *, int);
-size_t  strspn(const char *, const char *);
-char   *strstr(const char *, const char *);
-char   *strtok(char *, const char *);
-size_t  strxfrm(char *, const char *, size_t);
-
-/* Nonstandard routines */
-#ifndef _ANSI_SOURCE
-void   *memccpy(void *, const void *, int, size_t);
-char   *strtok_r(char *, const char *, char **);
-char   *strdup(const char *);
-#ifndef _POSIX_C_SOURCE
-int     bcmp(const void *, const void *, size_t);
-void    bcopy(const void *, void *, size_t);
-void    bzero(void *, size_t);
-int     ffs(int);
-char   *index(const char *, int);
-char   *rindex(const char *, int);
-int     strcasecmp(const char *, const char *);
-size_t  strlcat(char *, const char *, size_t);
-size_t  strlcpy(char *, const char *, size_t);
-void    strmode(int, char *);
-int     strncasecmp(const char *, const char *, size_t);
-char   *strsep(char **, const char *);
-char   *strsignal(int sig);
+void   *memmem(const void *__big, size_t __big_len, const void *__little, size_t __little_len) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
+void     memset_pattern4(void *__b, const void *__pattern4, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
+void     memset_pattern8(void *__b, const void *__pattern8, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
+void     memset_pattern16(void *__b, const void *__pattern16, size_t __len) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_3_0);
+
+char   *strcasestr(const char *__big, const char *__little);
+char   *strnstr(const char *__big, const char *__little, size_t __len);
+size_t  strlcat(char *__dst, const char *__source, size_t __size);
+size_t  strlcpy(char *__dst, const char *__source, size_t __size);
+void    strmode(int __mode, char *__bp);
+char   *strsep(char **__stringp, const char *__delim);
+
+/* SUS places swab() in unistd.h.  It is listed here for source compatibility */

 void    swab(const void * __restrict, void * __restrict, ssize_t);
 void    swab(const void * __restrict, void * __restrict, ssize_t);

-#endif /* !_POSIX_C_SOURCE */
-#endif         /* !_ANSI_SOURCE */
+
+__OSX_AVAILABLE(10.12.1) __IOS_AVAILABLE(10.1)
+__TVOS_AVAILABLE(10.0.1) __WATCHOS_AVAILABLE(3.1)
+int    timingsafe_bcmp(const void *__b1, const void *__b2, size_t __len);
+
+__OSX_AVAILABLE(10.16) __IOS_AVAILABLE(14.0)
+__TVOS_AVAILABLE(14.0) __WATCHOS_AVAILABLE(7.0)
+int     strsignal_r(int __sig, char *__strsignalbuf, size_t __buflen);

 __END_DECLS
 
 __END_DECLS
 

+/* Some functions historically defined in string.h were placed in strings.h
+ * by SUS.  We are using "strings.h" instead of <strings.h> to avoid an issue
+ * where /Developer/Headers/FlatCarbon/Strings.h could be included instead on
+ * case-insensitive file systems.
+ */
+#include "strings.h"
+#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
+
+

 #ifdef _USE_EXTENDED_LOCALES_
 #include <xlocale/_string.h>
 #endif /* _USE_EXTENDED_LOCALES_ */
 
 #ifdef _USE_EXTENDED_LOCALES_
 #include <xlocale/_string.h>
 #endif /* _USE_EXTENDED_LOCALES_ */
 

+#if defined (__GNUC__) && _FORTIFY_SOURCE > 0 && !defined (__cplusplus)
+/* Security checking functions.  */
+#include <secure/_string.h>
+#endif
+

 #endif /* _STRING_H_ */
 #endif /* _STRING_H_ */