Home | History | Annotate | Line # | Download | only in include
string.h revision 1.58
      1 /*	$NetBSD: string.h,v 1.58 2024/12/09 12:09:02 nros Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1990, 1993
      5  *	The Regents of the University of California.  All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  * 3. Neither the name of the University nor the names of its contributors
     16  *    may be used to endorse or promote products derived from this software
     17  *    without specific prior written permission.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     29  * SUCH DAMAGE.
     30  *
     31  *	@(#)string.h	8.1 (Berkeley) 6/2/93
     32  */
     33 
     34 #ifndef _STRING_H_
     35 #define	_STRING_H_
     36 #include <machine/ansi.h>
     37 
     38 #ifdef	_BSD_SIZE_T_
     39 typedef	_BSD_SIZE_T_	size_t;
     40 #undef	_BSD_SIZE_T_
     41 #endif
     42 
     43 #include <sys/null.h>
     44 
     45 #include <sys/cdefs.h>
     46 #include <sys/featuretest.h>
     47 
     48 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
     49 #  ifndef __LOCALE_T_DECLARED
     50 typedef struct _locale		*locale_t;
     51 #  define __LOCALE_T_DECLARED
     52 #  endif
     53 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
     54 
     55 __BEGIN_DECLS
     56 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE) || \
     57     (__STDC_VERSION__ - 0 >= 202311L) || defined(_ISOC23_SOURCE)
     58 void	*memccpy(void *, const void *, int, size_t);
     59 #endif /* _XOPEN_SOURCE || _NETBSD_SOURCE || _ISOC23_SOURCE */
     60 void	*memchr(const void *, int, size_t);
     61 int	 memcmp(const void *, const void *, size_t);
     62 void	*memcpy(void * __restrict, const void * __restrict, size_t);
     63 #if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
     64 void	*memmem(const void *, size_t, const void *, size_t);
     65 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
     66 void	*memmove(void *, const void *, size_t);
     67 void	*memset(void *, int, size_t);
     68 #if (__STDC_VERSION__ - 0 >= 202311L) || defined(_ISOC23_SOURCE) || \
     69     defined(_NETBSD_SOURCE)
     70 void	*memset_explicit(void *, int, size_t);
     71 #endif
     72 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
     73 char	*stpcpy(char * __restrict, const char * __restrict);
     74 char	*stpncpy(char * __restrict, const char * __restrict, size_t);
     75 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
     76 char	*strcat(char * __restrict, const char * __restrict);
     77 char	*strchr(const char *, int);
     78 int	 strcmp(const char *, const char *);
     79 int	 strcoll(const char *, const char *);
     80 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
     81 int	 strcoll_l(const char *, const char *, locale_t);
     82 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
     83 char	*strcpy(char * __restrict, const char * __restrict);
     84 size_t	 strcspn(const char *, const char *);
     85 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_XOPEN_SOURCE) || \
     86     defined(_NETBSD_SOURCE) || (__STDC_VERSION__ - 0 >= 202311L) || \
     87     defined(_ISOC23_SOURCE)
     88 char	*strdup(const char *);
     89 #endif /* _POSIX_C_SOURCE || _XOPEN_SOURCE || _NETBSD_SOURCE ||
     90         * _ISOC23_SOURCE
     91         */
     92 __aconst char *strerror(int);
     93 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
     94 __aconst char *strerror_l(int, locale_t);
     95 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
     96 #if (_POSIX_C_SOURCE - 0 >= 200112L) || \
     97     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
     98 int	 strerror_r(int, char *, size_t);
     99 #endif /* _POSIX_C_SOURCE || _REENTRANT || _NETBSD_SOURCE */
    100 #if (_POSIX_C_SOURCE - 0 >= 202405L) || defined(_NETBSD_SOURCE)
    101 size_t	 strlcat(char * __restrict, const char * __restrict, size_t);
    102 size_t	 strlcpy(char * __restrict, const char * __restrict, size_t);
    103 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
    104 size_t	 strlen(const char *);
    105 char	*strncat(char * __restrict, const char * __restrict, size_t);
    106 int	 strncmp(const char *, const char *, size_t);
    107 char	*strncpy(char * __restrict, const char * __restrict, size_t);
    108 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE) || \
    109     (__STDC_VERSION__ - 0 >= 202311L) || defined(_ISOC23_SOURCE)
    110 char	*strndup(const char *, size_t);
    111 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE || _ISOC23_SOURCE */
    112 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
    113 size_t	strnlen(const char *, size_t);
    114 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
    115 char	*strpbrk(const char *, const char *);
    116 char	*strrchr(const char *, int);
    117 #if (_POSIX_C_SOURCE - 0 >= 200809L) || defined(_NETBSD_SOURCE)
    118 #ifndef __STRSIGNAL_DECLARED
    119 #define __STRSIGNAL_DECLARED
    120 /* also in unistd.h */
    121 __aconst char *strsignal(int);
    122 #endif /* __STRSIGNAL_DECLARED */
    123 #endif
    124 size_t	 strspn(const char *, const char *);
    125 char	*strstr(const char *, const char *);
    126 char	*strtok(char * __restrict, const char * __restrict);
    127 #if (_POSIX_C_SOURCE - 0 >= 200112L) || \
    128     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
    129 char	*strtok_r(char *, const char *, char **);
    130 #endif /* _POSIX_C_SOURCE || _REENTRANT || _NETBSD_SOURCE */
    131 size_t	 strxfrm(char * __restrict, const char * __restrict, size_t);
    132 #if (_POSIX_C_SOURCE - 0) >= 200809L || defined(_NETBSD_SOURCE)
    133 size_t	 strxfrm_l(char * __restrict, const char * __restrict, size_t,
    134 	    locale_t);
    135 #endif /* _POSIX_C_SOURCE || _NETBSD_SOURCE */
    136 __END_DECLS
    137 
    138 #if defined(_NETBSD_SOURCE)
    139 #include <strings.h>		/* for backwards-compatibility */
    140 __BEGIN_DECLS
    141 char	*strcasestr(const char *, const char *);
    142 char	*strchrnul(const char *, int);
    143 char	*strsep(char **, const char *);
    144 char	*stresep(char **, const char *, int);
    145 char	*strnstr(const char *, const char *, size_t);
    146 void	*memrchr(const void *, int, size_t);
    147 void	*mempcpy(void * __restrict, const void * __restrict, size_t);
    148 void	*explicit_memset(void *, int, size_t);
    149 int	consttime_memequal(const void *, const void *, size_t);
    150 __END_DECLS
    151 #endif /* _NETBSD_SOURCE */
    152 
    153 #if _FORTIFY_SOURCE > 0
    154 #include <ssp/string.h>
    155 #endif
    156 #endif /* !defined(_STRING_H_) */
    157