include/string.h

   1 // -*- C++ -*-
   2 //===--------------------------- string.h ---------------------------------===//
   3 //
   4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
   5 // See https://llvm.org/LICENSE.txt for license information.
   6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #ifndef _LIBCPP_STRING_H
  11 #define _LIBCPP_STRING_H
  12
  13 /*
  14     string.h synopsis
  15
  16 Macros:
  17
  18     NULL
  19
  20 Types:
  21
  22     size_t
  23
  24 void* memcpy(void* restrict s1, const void* restrict s2, size_t n);
  25 void* memmove(void* s1, const void* s2, size_t n);
  26 char* strcpy (char* restrict s1, const char* restrict s2);
  27 char* strncpy(char* restrict s1, const char* restrict s2, size_t n);
  28 char* strcat (char* restrict s1, const char* restrict s2);
  29 char* strncat(char* restrict s1, const char* restrict s2, size_t n);
  30 int memcmp(const void* s1, const void* s2, size_t n);
  31 int strcmp (const char* s1, const char* s2);
  32 int strncmp(const char* s1, const char* s2, size_t n);
  33 int strcoll(const char* s1, const char* s2);
  34 size_t strxfrm(char* restrict s1, const char* restrict s2, size_t n);
  35 const void* memchr(const void* s, int c, size_t n);
  36       void* memchr(      void* s, int c, size_t n);
  37 const char* strchr(const char* s, int c);
  38       char* strchr(      char* s, int c);
  39 size_t strcspn(const char* s1, const char* s2);
  40 const char* strpbrk(const char* s1, const char* s2);
  41       char* strpbrk(      char* s1, const char* s2);
  42 const char* strrchr(const char* s, int c);
  43       char* strrchr(      char* s, int c);
  44 size_t strspn(const char* s1, const char* s2);
  45 const char* strstr(const char* s1, const char* s2);
  46       char* strstr(      char* s1, const char* s2);
  47 char* strtok(char* restrict s1, const char* restrict s2);
  48 void* memset(void* s, int c, size_t n);
  49 char* strerror(int errnum);
  50 size_t strlen(const char* s);
  51
  52 */
  53
  54 #include <__config>
  55
  56 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
  57 #pragma GCC system_header
  58 #endif
  59
  60 #include_next <string.h>
  61
  62 // MSVCRT, GNU libc and its derivates may already have the correct prototype in
  63 // <string.h>. This macro can be defined by users if their C library provides
  64 // the right signature.
  65 #if defined(__CORRECT_ISO_CPP_STRING_H_PROTO) || defined(_LIBCPP_MSVCRT) || \
  66     defined(__sun__) || defined(_STRING_H_CPLUSPLUS_98_CONFORMANCE_)
  67 #define _LIBCPP_STRING_H_HAS_CONST_OVERLOADS
  68 #endif
  69
  70 #if defined(__cplusplus) && !defined(_LIBCPP_STRING_H_HAS_CONST_OVERLOADS) && defined(_LIBCPP_PREFERRED_OVERLOAD)
  71 extern "C++" {
  72 inline _LIBCPP_INLINE_VISIBILITY
  73 char* __libcpp_strchr(const char* __s, int __c) {return (char*)strchr(__s, __c);}
  74 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  75 const char* strchr(const char* __s, int __c) {return __libcpp_strchr(__s, __c);}
  76 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  77       char* strchr(      char* __s, int __c) {return __libcpp_strchr(__s, __c);}
  78
  79 inline _LIBCPP_INLINE_VISIBILITY
  80 char* __libcpp_strpbrk(const char* __s1, const char* __s2) {return (char*)strpbrk(__s1, __s2);}
  81 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  82 const char* strpbrk(const char* __s1, const char* __s2) {return __libcpp_strpbrk(__s1, __s2);}
  83 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  84       char* strpbrk(      char* __s1, const char* __s2) {return __libcpp_strpbrk(__s1, __s2);}
  85
  86 inline _LIBCPP_INLINE_VISIBILITY
  87 char* __libcpp_strrchr(const char* __s, int __c) {return (char*)strrchr(__s, __c);}
  88 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  89 const char* strrchr(const char* __s, int __c) {return __libcpp_strrchr(__s, __c);}
  90 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  91       char* strrchr(      char* __s, int __c) {return __libcpp_strrchr(__s, __c);}
  92
  93 inline _LIBCPP_INLINE_VISIBILITY
  94 void* __libcpp_memchr(const void* __s, int __c, size_t __n) {return (void*)memchr(__s, __c, __n);}
  95 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  96 const void* memchr(const void* __s, int __c, size_t __n) {return __libcpp_memchr(__s, __c, __n);}
  97 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
  98       void* memchr(      void* __s, int __c, size_t __n) {return __libcpp_memchr(__s, __c, __n);}
  99
 100 inline _LIBCPP_INLINE_VISIBILITY
 101 char* __libcpp_strstr(const char* __s1, const char* __s2) {return (char*)strstr(__s1, __s2);}
 102 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
 103 const char* strstr(const char* __s1, const char* __s2) {return __libcpp_strstr(__s1, __s2);}
 104 inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
 105       char* strstr(      char* __s1, const char* __s2) {return __libcpp_strstr(__s1, __s2);}
 106 }
 107 #endif
 108
 109 #endif  // _LIBCPP_STRING_H