mirror of
https://sourceware.org/git/glibc.git
synced 2024-11-24 02:03:35 +08:00
7b037c095e
* string/string.h [__USE_MISC]: Include strings.h. (__bzero, bcmp, bcopy, bzero, index, rindex) (strcasecmp, strncasecmp, strcasecmp_l, strncasecmp_l) (ffs, ffsl, ffsll): Don't declare. * string/strings.h: Do not suppress the file if string.h has already been included. (bcmp, bcopy, bzero, strcasecmp, strncasecmp): Add __nonnull annotations. (index, rindex): Define inline forwarders even if __CORRECT_ISO_CPP_STRING_H_PROTO is defined. (ffs): Use __attribute_const__. (ffsl, ffsll): Declare here. (strcasecmp_l, strncasecmp_l): Correct comments; these functions have now been standardized. * include/string.h (__bzero): Declare here.
148 lines
4.6 KiB
C
148 lines
4.6 KiB
C
/* Copyright (C) 1991-2017 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _STRINGS_H
|
|
#define _STRINGS_H 1
|
|
|
|
#include <features.h>
|
|
#define __need_size_t
|
|
#include <stddef.h>
|
|
|
|
/* Tell the caller that we provide correct C++ prototypes. */
|
|
#if defined __cplusplus && __GNUC_PREREQ (4, 4)
|
|
# define __CORRECT_ISO_CPP_STRINGS_H_PROTO
|
|
#endif
|
|
|
|
__BEGIN_DECLS
|
|
|
|
#if defined __USE_MISC || !defined __USE_XOPEN2K8
|
|
/* Compare N bytes of S1 and S2 (same as memcmp). */
|
|
extern int bcmp (const void *__s1, const void *__s2, size_t __n)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2));
|
|
|
|
/* Copy N bytes of SRC to DEST (like memmove, but args reversed). */
|
|
extern void bcopy (const void *__src, void *__dest, size_t __n)
|
|
__THROW __nonnull ((1, 2));
|
|
|
|
/* Set N bytes of S to 0. */
|
|
extern void bzero (void *__s, size_t __n) __THROW __nonnull ((1));
|
|
|
|
/* Find the first occurrence of C in S (same as strchr). */
|
|
# ifdef __CORRECT_ISO_CPP_STRINGS_H_PROTO
|
|
extern "C++"
|
|
{
|
|
extern char *index (char *__s, int __c)
|
|
__THROW __asm ("index") __attribute_pure__ __nonnull ((1));
|
|
extern const char *index (const char *__s, int __c)
|
|
__THROW __asm ("index") __attribute_pure__ __nonnull ((1));
|
|
|
|
# if defined __OPTIMIZE__
|
|
__extern_always_inline char *
|
|
index (char *__s, int __c) __THROW
|
|
{
|
|
return __builtin_index (__s, __c);
|
|
}
|
|
|
|
__extern_always_inline const char *
|
|
index (const char *__s, int __c) __THROW
|
|
{
|
|
return __builtin_index (__s, __c);
|
|
}
|
|
# endif
|
|
}
|
|
# else
|
|
extern char *index (const char *__s, int __c)
|
|
__THROW __attribute_pure__ __nonnull ((1));
|
|
# endif
|
|
|
|
/* Find the last occurrence of C in S (same as strrchr). */
|
|
# ifdef __CORRECT_ISO_CPP_STRINGS_H_PROTO
|
|
extern "C++"
|
|
{
|
|
extern char *rindex (char *__s, int __c)
|
|
__THROW __asm ("rindex") __attribute_pure__ __nonnull ((1));
|
|
extern const char *rindex (const char *__s, int __c)
|
|
__THROW __asm ("rindex") __attribute_pure__ __nonnull ((1));
|
|
|
|
# if defined __OPTIMIZE__
|
|
__extern_always_inline char *
|
|
rindex (char *__s, int __c) __THROW
|
|
{
|
|
return __builtin_rindex (__s, __c);
|
|
}
|
|
|
|
__extern_always_inline const char *
|
|
rindex (const char *__s, int __c) __THROW
|
|
{
|
|
return __builtin_rindex (__s, __c);
|
|
}
|
|
# endif
|
|
}
|
|
# else
|
|
extern char *rindex (const char *__s, int __c)
|
|
__THROW __attribute_pure__ __nonnull ((1));
|
|
# endif
|
|
#endif
|
|
|
|
#if defined __USE_MISC || !defined __USE_XOPEN2K8 || defined __USE_XOPEN2K8XSI
|
|
/* Return the position of the first bit set in I, or 0 if none are set.
|
|
The least-significant bit is position 1, the most-significant 32. */
|
|
extern int ffs (int __i) __THROW __attribute_const__;
|
|
#endif
|
|
|
|
/* The following two functions are non-standard but necessary for non-32 bit
|
|
platforms. */
|
|
# ifdef __USE_GNU
|
|
extern int ffsl (long int __l) __THROW __attribute_const__;
|
|
__extension__ extern int ffsll (long long int __ll)
|
|
__THROW __attribute_const__;
|
|
# endif
|
|
|
|
/* Compare S1 and S2, ignoring case. */
|
|
extern int strcasecmp (const char *__s1, const char *__s2)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2));
|
|
|
|
/* Compare no more than N chars of S1 and S2, ignoring case. */
|
|
extern int strncasecmp (const char *__s1, const char *__s2, size_t __n)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2));
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
# include <xlocale.h>
|
|
|
|
/* Compare S1 and S2, ignoring case, using collation rules from LOC. */
|
|
extern int strcasecmp_l (const char *__s1, const char *__s2, __locale_t __loc)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2, 3));
|
|
|
|
/* Compare no more than N chars of S1 and S2, ignoring case, using
|
|
collation rules from LOC. */
|
|
extern int strncasecmp_l (const char *__s1, const char *__s2,
|
|
size_t __n, __locale_t __loc)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2, 4));
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#if __GNUC_PREREQ (3,4) && __USE_FORTIFY_LEVEL > 0 \
|
|
&& defined __fortify_function
|
|
/* Functions with security checks. */
|
|
# if defined __USE_MISC || !defined __USE_XOPEN2K8
|
|
# include <bits/strings_fortified.h>
|
|
# endif
|
|
#endif
|
|
|
|
#endif /* strings.h */
|