95c6cd753f
Historically we've made a few mistakes where they haven't matched the right number. And most non-Googlers are much more familiar with the numbers, so it seems to make sense to rely more on them. Especially in header files, which we actually expect real people to have to read from time to time. Test: treehugger Change-Id: I0d4a97454ee108de1d32f21df285315c5488d886
234 lines
8.6 KiB
C
234 lines
8.6 KiB
C
/*
|
|
* Copyright (C) 2008 The Android Open Source Project
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
|
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _STRING_H
|
|
#define _STRING_H
|
|
|
|
#include <sys/cdefs.h>
|
|
#include <stddef.h>
|
|
#include <xlocale.h>
|
|
|
|
#include <bits/strcasecmp.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
#if defined(__USE_BSD)
|
|
#include <strings.h>
|
|
#endif
|
|
|
|
void* memccpy(void* __dst, const void* __src, int __stop_char, size_t __n);
|
|
void* memchr(const void* __s, int __ch, size_t __n) __attribute_pure__;
|
|
#if defined(__cplusplus)
|
|
extern "C++" void* memrchr(void* __s, int __ch, size_t __n) __RENAME(memrchr) __attribute_pure__;
|
|
extern "C++" const void* memrchr(const void* __s, int __ch, size_t __n) __RENAME(memrchr) __attribute_pure__;
|
|
#else
|
|
void* memrchr(const void* __s, int __ch, size_t __n) __attribute_pure__;
|
|
#endif
|
|
int memcmp(const void* __lhs, const void* __rhs, size_t __n) __attribute_pure__;
|
|
void* memcpy(void*, const void*, size_t);
|
|
#if defined(__USE_GNU)
|
|
void* mempcpy(void* __dst, const void* __src, size_t __n) __INTRODUCED_IN(23);
|
|
#endif
|
|
void* memmove(void* __dst, const void* __src, size_t __n);
|
|
void* memset(void* __dst, int __ch, size_t __n);
|
|
void* memmem(const void* __haystack, size_t __haystack_size, const void* __needle, size_t __needle_size) __attribute_pure__;
|
|
|
|
char* strchr(const char* __s, int __ch) __attribute_pure__;
|
|
char* __strchr_chk(const char* __s, int __ch, size_t __n) __INTRODUCED_IN(18);
|
|
#if defined(__USE_GNU)
|
|
#if defined(__cplusplus)
|
|
extern "C++" char* strchrnul(char* __s, int __ch) __RENAME(strchrnul) __attribute_pure__ __INTRODUCED_IN(24);
|
|
extern "C++" const char* strchrnul(const char* __s, int __ch) __RENAME(strchrnul) __attribute_pure__ __INTRODUCED_IN(24);
|
|
#else
|
|
char* strchrnul(const char* __s, int __ch) __attribute_pure__ __INTRODUCED_IN(24);
|
|
#endif
|
|
#endif
|
|
|
|
char* strrchr(const char* __s, int __ch) __attribute_pure__;
|
|
char* __strrchr_chk(const char* __s, int __ch, size_t __n) __INTRODUCED_IN(18);
|
|
|
|
size_t strlen(const char* __s) __attribute_pure__;
|
|
size_t __strlen_chk(const char* __s, size_t __n) __INTRODUCED_IN(17);
|
|
|
|
int strcmp(const char* __lhs, const char* __rhs) __attribute_pure__;
|
|
char* stpcpy(char* __dst, const char* __src) __INTRODUCED_IN(21);
|
|
char* strcpy(char* __dst, const char* __src);
|
|
char* strcat(char* __dst, const char* __src);
|
|
char* strdup(const char* __s);
|
|
|
|
char* strstr(const char* __haystack, const char* __needle) __attribute_pure__;
|
|
#if defined(__cplusplus)
|
|
extern "C++" char* strcasestr(char*, const char*) __RENAME(strcasestr) __attribute_pure__;
|
|
extern "C++" const char* strcasestr(const char*, const char*) __RENAME(strcasestr) __attribute_pure__;
|
|
#else
|
|
char* strcasestr(const char* __haystack, const char* __needle) __attribute_pure__;
|
|
#endif
|
|
char* strtok(char* __s, const char* __delimiter);
|
|
char* strtok_r(char* __s, const char* __delimiter, char** __pos_ptr);
|
|
|
|
char* strerror(int __errno_value);
|
|
char* strerror_l(int __errno_value, locale_t __l) __INTRODUCED_IN(23);
|
|
#if defined(__USE_GNU) && __ANDROID_API__ >= 23
|
|
char* strerror_r(int __errno_value, char* __buf, size_t __n) __RENAME(__gnu_strerror_r) __INTRODUCED_IN(23);
|
|
#else /* POSIX */
|
|
int strerror_r(int __errno_value, char* __buf, size_t __n);
|
|
#endif
|
|
|
|
size_t strnlen(const char* __s, size_t __n) __attribute_pure__;
|
|
char* strncat(char* __dst, const char* __src, size_t __n);
|
|
char* strndup(const char* __s, size_t __n);
|
|
int strncmp(const char* __lhs, const char* __rhs, size_t __n) __attribute_pure__;
|
|
char* stpncpy(char* __dst, const char* __src, size_t __n) __INTRODUCED_IN(21);
|
|
char* strncpy(char* __dst, const char* __src, size_t __n);
|
|
|
|
size_t strlcat(char* __dst, const char* __src, size_t __n);
|
|
size_t strlcpy(char* __dst, const char* __src, size_t __n);
|
|
|
|
size_t strcspn(const char* __s, const char* __reject) __attribute_pure__;
|
|
char* strpbrk(const char* __s, const char* __accept) __attribute_pure__;
|
|
char* strsep(char** __s_ptr, const char* __delimiter);
|
|
size_t strspn(const char* __s, const char* __accept);
|
|
|
|
char* strsignal(int __signal);
|
|
|
|
int strcoll(const char* __lhs, const char* __rhs) __attribute_pure__;
|
|
size_t strxfrm(char* __dst, const char* __src, size_t __n);
|
|
|
|
#if __ANDROID_API__ >= 21
|
|
int strcoll_l(const char* __lhs, const char* __rhs, locale_t __l) __attribute_pure__ __INTRODUCED_IN(21);
|
|
size_t strxfrm_l(char* __dst, const char* __src, size_t __n, locale_t __l) __INTRODUCED_IN(21);
|
|
#else
|
|
// Implemented as static inlines before 21.
|
|
#endif
|
|
|
|
#if defined(__USE_GNU) && !defined(basename)
|
|
/*
|
|
* glibc has a basename in <string.h> that's different to the POSIX one in <libgen.h>.
|
|
* It doesn't modify its argument, and in C++ it's const-correct.
|
|
*/
|
|
#if defined(__cplusplus)
|
|
extern "C++" char* basename(char* __path) __RENAME(__gnu_basename) __INTRODUCED_IN(23);
|
|
extern "C++" const char* basename(const char* __path) __RENAME(__gnu_basename) __INTRODUCED_IN(23);
|
|
#else
|
|
char* basename(const char* __path) __RENAME(__gnu_basename) __INTRODUCED_IN(23);
|
|
#endif
|
|
#endif
|
|
|
|
#if defined(__BIONIC_INCLUDE_FORTIFY_HEADERS)
|
|
#include <bits/fortify/string.h>
|
|
#endif
|
|
|
|
/* Const-correct overloads. Placed after FORTIFY so we call those functions, if possible. */
|
|
#if defined(__cplusplus)
|
|
/*
|
|
* Use two enable_ifs so these overloads don't conflict with + are preferred over libcxx's. This can
|
|
* be reduced to 1 after libcxx recognizes that we have const-correct overloads.
|
|
*/
|
|
#define __prefer_this_overload __enable_if(true, "preferred overload") __enable_if(true, "")
|
|
extern "C++" {
|
|
inline __always_inline
|
|
void* __bionic_memchr(const void* const s __pass_object_size, int c, size_t n) {
|
|
return memchr(s, c, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
const void* memchr(const void* const s __pass_object_size, int c, size_t n)
|
|
__prefer_this_overload {
|
|
return __bionic_memchr(s, c, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
void* memchr(void* const s __pass_object_size, int c, size_t n) __prefer_this_overload {
|
|
return __bionic_memchr(s, c, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* __bionic_strchr(const char* const s __pass_object_size, int c) {
|
|
return strchr(s, c);
|
|
}
|
|
|
|
inline __always_inline
|
|
const char* strchr(const char* const s __pass_object_size, int c)
|
|
__prefer_this_overload {
|
|
return __bionic_strchr(s, c);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* strchr(char* const s __pass_object_size, int c)
|
|
__prefer_this_overload {
|
|
return __bionic_strchr(s, c);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* __bionic_strrchr(const char* const s __pass_object_size, int c) {
|
|
return strrchr(s, c);
|
|
}
|
|
|
|
inline __always_inline
|
|
const char* strrchr(const char* const s __pass_object_size, int c) __prefer_this_overload {
|
|
return __bionic_strrchr(s, c);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* strrchr(char* const s __pass_object_size, int c) __prefer_this_overload {
|
|
return __bionic_strrchr(s, c);
|
|
}
|
|
|
|
/* Functions with no FORTIFY counterpart. */
|
|
inline __always_inline
|
|
char* __bionic_strstr(const char* h, const char* n) { return strstr(h, n); }
|
|
|
|
inline __always_inline
|
|
const char* strstr(const char* h, const char* n) __prefer_this_overload {
|
|
return __bionic_strstr(h, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* strstr(char* h, const char* n) __prefer_this_overload {
|
|
return __bionic_strstr(h, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
char* __bionic_strpbrk(const char* h, const char* n) { return strpbrk(h, n); }
|
|
|
|
inline __always_inline
|
|
char* strpbrk(char* h, const char* n) __prefer_this_overload {
|
|
return __bionic_strpbrk(h, n);
|
|
}
|
|
|
|
inline __always_inline
|
|
const char* strpbrk(const char* h, const char* n) __prefer_this_overload {
|
|
return __bionic_strpbrk(h, n);
|
|
}
|
|
}
|
|
#undef __prefer_this_overload
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#endif
|