2010-05-11 19:42:16 +00:00
|
|
|
// -*- C++ -*-
|
2021-11-17 21:25:01 +00:00
|
|
|
//===----------------------------------------------------------------------===//
|
2010-05-11 19:42:16 +00:00
|
|
|
//
|
2019-01-19 08:50:56 +00:00
|
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
2010-05-11 19:42:16 +00:00
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#ifndef _LIBCPP_CSTRING
|
|
|
|
#define _LIBCPP_CSTRING
|
|
|
|
|
|
|
|
/*
|
|
|
|
cstring synopsis
|
|
|
|
|
|
|
|
Macros:
|
|
|
|
|
|
|
|
NULL
|
2010-08-22 00:02:43 +00:00
|
|
|
|
2010-05-11 19:42:16 +00:00
|
|
|
namespace std
|
|
|
|
{
|
|
|
|
|
|
|
|
Types:
|
|
|
|
|
|
|
|
size_t
|
|
|
|
|
|
|
|
void* memcpy(void* restrict s1, const void* restrict s2, size_t n);
|
|
|
|
void* memmove(void* s1, const void* s2, size_t n);
|
|
|
|
char* strcpy (char* restrict s1, const char* restrict s2);
|
|
|
|
char* strncpy(char* restrict s1, const char* restrict s2, size_t n);
|
|
|
|
char* strcat (char* restrict s1, const char* restrict s2);
|
|
|
|
char* strncat(char* restrict s1, const char* restrict s2, size_t n);
|
|
|
|
int memcmp(const void* s1, const void* s2, size_t n);
|
|
|
|
int strcmp (const char* s1, const char* s2);
|
|
|
|
int strncmp(const char* s1, const char* s2, size_t n);
|
|
|
|
int strcoll(const char* s1, const char* s2);
|
|
|
|
size_t strxfrm(char* restrict s1, const char* restrict s2, size_t n);
|
|
|
|
const void* memchr(const void* s, int c, size_t n);
|
|
|
|
void* memchr( void* s, int c, size_t n);
|
|
|
|
const char* strchr(const char* s, int c);
|
|
|
|
char* strchr( char* s, int c);
|
|
|
|
size_t strcspn(const char* s1, const char* s2);
|
|
|
|
const char* strpbrk(const char* s1, const char* s2);
|
|
|
|
char* strpbrk( char* s1, const char* s2);
|
|
|
|
const char* strrchr(const char* s, int c);
|
|
|
|
char* strrchr( char* s, int c);
|
|
|
|
size_t strspn(const char* s1, const char* s2);
|
|
|
|
const char* strstr(const char* s1, const char* s2);
|
|
|
|
char* strstr( char* s1, const char* s2);
|
|
|
|
char* strtok(char* restrict s1, const char* restrict s2);
|
|
|
|
void* memset(void* s, int c, size_t n);
|
|
|
|
char* strerror(int errnum);
|
|
|
|
size_t strlen(const char* s);
|
|
|
|
|
|
|
|
} // std
|
|
|
|
|
|
|
|
*/
|
|
|
|
|
2022-03-25 16:55:36 +00:00
|
|
|
#include <__assert> // all public C++ headers provide the assertion handler
|
2010-05-11 19:42:16 +00:00
|
|
|
#include <__config>
|
2022-12-07 17:31:14 +00:00
|
|
|
#include <__type_traits/is_constant_evaluated.h>
|
2022-08-08 21:03:56 +00:00
|
|
|
|
2010-05-11 19:42:16 +00:00
|
|
|
#include <string.h>
|
|
|
|
|
2022-08-08 21:03:56 +00:00
|
|
|
#ifndef _LIBCPP_STRING_H
|
|
|
|
# error <cstring> tried including <string.h> but didn't find libc++'s <string.h> header. \
|
|
|
|
This usually means that your header search paths are not configured properly. \
|
|
|
|
The header search paths should contain the C++ Standard Library headers before \
|
|
|
|
any C Standard Library, and you are probably using compiler flags that make that \
|
|
|
|
not be the case.
|
|
|
|
#endif
|
|
|
|
|
2011-10-17 20:05:10 +00:00
|
|
|
#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
|
2022-02-02 01:16:40 +00:00
|
|
|
# pragma GCC system_header
|
2011-10-17 20:05:10 +00:00
|
|
|
#endif
|
2010-05-11 19:42:16 +00:00
|
|
|
|
|
|
|
_LIBCPP_BEGIN_NAMESPACE_STD
|
|
|
|
|
[libc++] Use the using_if_exists attribute when provided
As discussed on cfe-dev [1], use the using_if_exists Clang attribute when
the compiler supports it. This makes it easier to port libc++ on top of
new platforms that don't fully support the C Standard library.
Previously, libc++ would fail to build when trying to import a missing
declaration in a <cXXXX> header. With the attribute, the declaration will
simply not be imported into namespace std, and hence it won't be available
for libc++ to use. In many cases, the declarations were *not* actually
required for libc++ to work (they were only surfaced for users to use
them as std::XXXX), so not importing them into namespace std is acceptable.
The same thing could be achieved by conscious usage of `#ifdef` along
with platform detection, however that quickly creates a maintenance
problem as libc++ is ported to new platforms. Furthermore, this problem
is exacerbated when mixed with vendor internal-only platforms, which can
lead to difficulties maintaining a downstream fork of the library.
For the time being, we only use the using_if_exists attribute when it
is supported. At some point in the future, we will start removing #ifdef
paths that are unnecessary when the attribute is supported, and folks
who need those #ifdef paths will be required to use a compiler that
supports the attribute.
[1]: http://lists.llvm.org/pipermail/cfe-dev/2020-June/066038.html
Differential Revision: https://reviews.llvm.org/D90257
2021-06-02 14:41:37 +00:00
|
|
|
using ::size_t _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::memcpy _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::memmove _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strcpy _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strncpy _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strcat _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strncat _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::memcmp _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strcmp _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strncmp _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strcoll _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strxfrm _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::memchr _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strchr _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strcspn _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strpbrk _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strrchr _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strspn _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strstr _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strtok _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::memset _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strerror _LIBCPP_USING_IF_EXISTS;
|
|
|
|
using ::strlen _LIBCPP_USING_IF_EXISTS;
|
2015-10-29 23:32:29 +00:00
|
|
|
|
2010-05-11 19:42:16 +00:00
|
|
|
_LIBCPP_END_NAMESPACE_STD
|
|
|
|
|
2021-04-20 16:03:32 +00:00
|
|
|
#endif // _LIBCPP_CSTRING
|