libstdc++
cstring
Go to the documentation of this file.
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