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
16Macros:
17
18 NULL
19
20Types:
21
22 size_t
23
24void* memcpy(void* restrict s1, const void* restrict s2, size_t n);
25void* memmove(void* s1, const void* s2, size_t n);
26char* strcpy (char* restrict s1, const char* restrict s2);
27char* strncpy(char* restrict s1, const char* restrict s2, size_t n);
28char* strcat (char* restrict s1, const char* restrict s2);
29char* strncat(char* restrict s1, const char* restrict s2, size_t n);
30int memcmp(const void* s1, const void* s2, size_t n);
31int strcmp (const char* s1, const char* s2);
32int strncmp(const char* s1, const char* s2, size_t n);
33int strcoll(const char* s1, const char* s2);
34size_t strxfrm(char* restrict s1, const char* restrict s2, size_t n);
35const void* memchr(const void* s, int c, size_t n);
36 void* memchr( void* s, int c, size_t n);
37const char* strchr(const char* s, int c);
38 char* strchr( char* s, int c);
39size_t strcspn(const char* s1, const char* s2);
40const char* strpbrk(const char* s1, const char* s2);
41 char* strpbrk( char* s1, const char* s2);
42const char* strrchr(const char* s, int c);
43 char* strrchr( char* s, int c);
44size_t strspn(const char* s1, const char* s2);
45const char* strstr(const char* s1, const char* s2);
46 char* strstr( char* s1, const char* s2);
47char* strtok(char* restrict s1, const char* restrict s2);
48void* memset(void* s, int c, size_t n);
49char* strerror(int errnum);
50size_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)
71extern "C++" {
72inline _LIBCPP_INLINE_VISIBILITY
73char* __libcpp_strchr(const char* __s, int __c) {return (char*)strchr(__s, __c);}
74inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
75const char* strchr(const char* __s, int __c) {return __libcpp_strchr(__s, __c);}
76inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
77 char* strchr( char* __s, int __c) {return __libcpp_strchr(__s, __c);}
78
79inline _LIBCPP_INLINE_VISIBILITY
80char* __libcpp_strpbrk(const char* __s1, const char* __s2) {return (char*)strpbrk(__s1, __s2);}
81inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
82const char* strpbrk(const char* __s1, const char* __s2) {return __libcpp_strpbrk(__s1, __s2);}
83inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
84 char* strpbrk( char* __s1, const char* __s2) {return __libcpp_strpbrk(__s1, __s2);}
85
86inline _LIBCPP_INLINE_VISIBILITY
87char* __libcpp_strrchr(const char* __s, int __c) {return (char*)strrchr(__s, __c);}
88inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
89const char* strrchr(const char* __s, int __c) {return __libcpp_strrchr(__s, __c);}
90inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
91 char* strrchr( char* __s, int __c) {return __libcpp_strrchr(__s, __c);}
92
93inline _LIBCPP_INLINE_VISIBILITY
94void* __libcpp_memchr(const void* __s, int __c, size_t __n) {return (void*)memchr(__s, __c, __n);}
95inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
96const void* memchr(const void* __s, int __c, size_t __n) {return __libcpp_memchr(__s, __c, __n);}
97inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
98 void* memchr( void* __s, int __c, size_t __n) {return __libcpp_memchr(__s, __c, __n);}
99
100inline _LIBCPP_INLINE_VISIBILITY
101char* __libcpp_strstr(const char* __s1, const char* __s2) {return (char*)strstr(__s1, __s2);}
102inline _LIBCPP_INLINE_VISIBILITY _LIBCPP_PREFERRED_OVERLOAD
103const char* strstr(const char* __s1, const char* __s2) {return __libcpp_strstr(__s1, __s2);}
104inline _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