libstdc++-v3/include/c_global/cstring

   1 // -*- C++ -*- forwarding header.
   2
   3 // Copyright (C) 1997-2024 Free Software Foundation, Inc.
   4 //
   5 // This file is part of the GNU ISO C++ Library.  This library is free
   6 // software; you can redistribute it and/or modify it under the
   7 // terms of the GNU General Public License as published by the
   8 // Free Software Foundation; either version 3, or (at your option)
   9 // any later version.
  10
  11 // This library is distributed in the hope that it will be useful,
  12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 // GNU General Public License for more details.
  15
  16 // Under Section 7 of GPL version 3, you are granted additional
  17 // permissions described in the GCC Runtime Library Exception, version
  18 // 3.1, as published by the Free Software Foundation.
  19
  20 // You should have received a copy of the GNU General Public License and
  21 // a copy of the GCC Runtime Library Exception along with this program;
  22 // see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  23 // <http://www.gnu.org/licenses/>.
  24
  25 /** @file cstring
  26  *  This is a Standard C++ Library file.  You should @c \#include this file
  27  *  in your programs, rather than any of the @a *.h implementation files.
  28  *
  29  *  This is the C++ version of the Standard C Library header @c string.h,
  30  *  and its contents are (mostly) the same as that header, but are all
  31  *  contained in the namespace @c std (except for names which are defined
  32  *  as macros in C).
  33  */
  34
  35 //
  36 // ISO C++ 14882: 20.4.6  C library
  37 //
  38
  39 #pragma GCC system_header
  40
  41 #define __glibcxx_want_freestanding_cstring
  42 #include <bits/version.h>
  43 #include <string.h>
  44
  45 #ifndef _GLIBCXX_CSTRING
  46 #define _GLIBCXX_CSTRING 1
  47
  48 // Get rid of those macros defined in <string.h> in lieu of real functions.
  49 #undef memchr
  50 #undef memcmp
  51 #undef memcpy
  52 #undef memmove
  53 #undef memset
  54 #undef strcat
  55 #undef strchr
  56 #undef strcmp
  57 #undef strcoll
  58 #undef strcpy
  59 #undef strcspn
  60 #undef strerror
  61 #undef strlen
  62 #undef strncat
  63 #undef strncmp
  64 #undef strncpy
  65 #undef strpbrk
  66 #undef strrchr
  67 #undef strspn
  68 #undef strstr
  69 #undef strtok
  70 #undef strxfrm
  71
  72 extern "C++"
  73 {
  74 namespace std _GLIBCXX_VISIBILITY(default)
  75 {
  76 _GLIBCXX_BEGIN_NAMESPACE_VERSION
  77
  78   using ::memchr;
  79   using ::memcmp;
  80   using ::memcpy;
  81   using ::memmove;
  82   using ::memset;
  83   using ::strcat;
  84   using ::strcmp;
  85   using ::strcoll;
  86   using ::strcpy;
  87   using ::strcspn;
  88   using ::strerror;
  89   using ::strlen;
  90   using ::strncat;
  91   using ::strncmp;
  92   using ::strncpy;
  93   using ::strspn;
  94 #if _GLIBCXX_HOSTED || __cplusplus <= 202302L
  95   using ::strtok;
  96 #endif
  97   using ::strxfrm;
  98   using ::strchr;
  99   using ::strpbrk;
 100   using ::strrchr;
 101   using ::strstr;
 102
 103 #ifndef __CORRECT_ISO_CPP_STRING_H_PROTO
 104   inline void*
 105   memchr(void* __s, int __c, size_t __n)
 106   { return __builtin_memchr(__s, __c, __n); }
 107
 108   inline char*
 109   strchr(char* __s, int __n)
 110   { return __builtin_strchr(__s, __n); }
 111
 112   inline char*
 113   strpbrk(char* __s1, const char* __s2)
 114   { return __builtin_strpbrk(__s1, __s2); }
 115
 116   inline char*
 117   strrchr(char* __s, int __n)
 118   { return __builtin_strrchr(__s, __n); }
 119
 120   inline char*
 121   strstr(char* __s1, const char* __s2)
 122   { return __builtin_strstr(__s1, __s2); }
 123 #endif
 124
 125 _GLIBCXX_END_NAMESPACE_VERSION
 126 } // namespace
 127 } // extern "C++"
 128
 129 #endif