xref: /freebsd/contrib/llvm-project/libcxx/include/string.h (revision 577b62c2bacc7dfa228591ca3da361e1bc398301)
1 // -*- C++ -*-
2 //===----------------------------------------------------------------------===//
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
110