RepoMirrors
/
musl
mirror of git://git.musl-libc.org/musl
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
musl/include/string.h

108 lines
3.0 KiB
C
Raw Normal View History

initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifndef _STRING_H
#define _STRING_H
#ifdef __cplusplus
extern "C" {
#endif
default features: make musl usable without feature test macros the old behavior of exposing nothing except plain ISO C can be obtained by defining __STRICT_ANSI__ or using a compiler option (such as -std=c99) that predefines it. the new default featureset is POSIX with XSI plus _BSD_SOURCE. any explicit feature test macros will inhibit the default. installation docs have also been updated to reflect this change.
2012-09-08 03:13:55 +00:00
#include <features.h>
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#undef NULL
#ifdef __cplusplus
#define NULL 0
#else
#define NULL ((void*)0)
#endif
#define __NEED_size_t
more locale_t interfaces (string stuff) and header updates this should be everything except for some functions where the non-_l version isn't even implemented yet (mainly some non-ISO-C wcs* functions).
2012-02-07 02:51:02 +00:00
#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) \
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
|| defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
more locale_t interfaces (string stuff) and header updates this should be everything except for some functions where the non-_l version isn't even implemented yet (mainly some non-ISO-C wcs* functions).
2012-02-07 02:51:02 +00:00
#define __NEED_locale_t
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#include <bits/alltypes.h>
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
void *memcpy (void *__restrict, const void *__restrict, size_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
void *memmove (void *, const void *, size_t);
void *memset (void *, int, size_t);
int memcmp (const void *, const void *, size_t);
void *memchr (const void *, int, size_t);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *strcpy (char *__restrict, const char *__restrict);
char *strncpy (char *__restrict, const char *__restrict, size_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *strcat (char *__restrict, const char *__restrict);
char *strncat (char *__restrict, const char *__restrict, size_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int strcmp (const char *, const char *);
int strncmp (const char *, const char *, size_t);
int strcoll (const char *, const char *);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
size_t strxfrm (char *__restrict, const char *__restrict, size_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
char *strchr (const char *, int);
char *strrchr (const char *, int);
size_t strcspn (const char *, const char *);
size_t strspn (const char *, const char *);
char *strpbrk (const char *, const char *);
char *strstr (const char *, const char *);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *strtok (char *__restrict, const char *__restrict);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
size_t strlen (const char *);
char *strerror (int);
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
#if defined(_BSD_SOURCE) || defined(_GNU_SOURCE)
#include <strings.h>
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - string.h
2011-02-15 01:53:15 +00:00
#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) \
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
|| defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *strtok_r (char *__restrict, const char *__restrict, char **__restrict);
more header cleanup and conformance fixes - string.h
2011-02-15 01:53:15 +00:00
int strerror_r (int, char *, size_t);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *stpcpy(char *__restrict, const char *__restrict);
char *stpncpy(char *__restrict, const char *__restrict, size_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
size_t strnlen (const char *, size_t);
more header cleanup and conformance fixes - string.h
2011-02-15 01:53:15 +00:00
char *strdup (const char *);
char *strndup (const char *, size_t);
fix missing prototype for strsignal
2011-02-27 04:50:26 +00:00
char *strsignal(int);
more locale_t interfaces (string stuff) and header updates this should be everything except for some functions where the non-_l version isn't even implemented yet (mainly some non-ISO-C wcs* functions).
2012-02-07 02:51:02 +00:00
char *strerror_l (int, locale_t);
int strcoll_l (const char *, const char *, locale_t);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
size_t strxfrm_l (char *__restrict, const char *__restrict, size_t, locale_t);
more header cleanup and conformance fixes - string.h
2011-02-15 01:53:15 +00:00
#endif
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
#if defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
void *memccpy (void *__restrict, const void *__restrict, int, size_t);
apply feature test protection to memccpy
2011-02-24 17:36:04 +00:00
#endif
strsep is BSD|GNU, not GNU-only; it's originally from BSD
2012-09-14 01:01:30 +00:00
#if defined(_GNU_SOURCE) || defined(_BSD_SOURCE)
char *strsep(char **, const char *);
more header cleanup and conformance fixes - string.h
2011-02-15 01:53:15 +00:00
size_t strlcat (char *, const char *, size_t);
size_t strlcpy (char *, const char *, size_t);
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifdef _GNU_SOURCE
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
#define strdupa(x) strcpy(alloca(strlen(x)+1),x)
add dummied strverscmp (obnoxious GNU function) programs that use this tend to horribly botch international text support, so it's questionable whether we want to support it even in the long term... for now, it's just a dummy that calls strcmp.
2011-09-12 02:45:56 +00:00
int strverscmp (const char *, const char *);
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
int strcasecmp_l (const char *, const char *, locale_t);
int strncasecmp_l (const char *, const char *, size_t, locale_t);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
char *strchrnul(const char *, int);
prototype for gnu strcasestr (currently a stub)
2011-02-15 21:08:19 +00:00
char *strcasestr(const char *, const char *);
add memmem function (gnu extension) based on strstr. passes gnulib tests and a few quick checks of my own.
2012-10-16 03:02:57 +00:00
void *memmem(const void *, size_t, const void *, size_t);
implement memrchr (nonstandard) and optimize strrchr in terms of it
2011-04-13 12:36:29 +00:00
void *memrchr(const void *, int, size_t);
function signature fix: add const qualifier to mempcpy src arg
2011-04-26 16:28:41 +00:00
void *mempcpy(void *, const void *, size_t);
omit declaration of basename wrongly interpreted as prototype in C++ the non-prototype declaration of basename in string.h is an ugly compromise to avoid breaking 2 types of broken software: 1. programs which assume basename is declared in string.h and thus would suffer from dangerous pointer-truncation if an implicit declaration were used. 2. programs which include string.h with _GNU_SOURCE defined but then declare their own prototype for basename using the incorrect GNU signature for the function (which would clash with a correct prototype). however, since C++ does not have non-prototype declarations and interprets them as prototypes for a function with no arguments, we must omit it when compiling C++ code. thankfully, all known broken apps that suffer from the above issues are written in C, not C++.
2012-05-09 15:47:06 +00:00
#ifndef __cplusplus
replace prototype for basename in string.h with non-prototype declaration GNU programs may expect the GNU version of basename, which has a different prototype (argument is const-qualified) and prototype it themselves too. of course if they're expecting the GNU behavior for the function, they'll still run into problems, but at least this eliminates some compile-time failures.
2012-02-25 04:23:47 +00:00
char *basename();
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#endif
omit declaration of basename wrongly interpreted as prototype in C++ the non-prototype declaration of basename in string.h is an ugly compromise to avoid breaking 2 types of broken software: 1. programs which assume basename is declared in string.h and thus would suffer from dangerous pointer-truncation if an implicit declaration were used. 2. programs which include string.h with _GNU_SOURCE defined but then declare their own prototype for basename using the incorrect GNU signature for the function (which would clash with a correct prototype). however, since C++ does not have non-prototype declarations and interprets them as prototypes for a function with no arguments, we must omit it when compiling C++ code. thankfully, all known broken apps that suffer from the above issues are written in C, not C++.
2012-05-09 15:47:06 +00:00
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifdef __cplusplus
}
#endif
#endif