xref: /aosp_15_r20/bionic/libc/include/strings.h (revision 8d67ca893c1523eb926b9080dbe4e2ffd2a27ba1)
1 /*	$NetBSD: strings.h,v 1.10 2005/02/03 04:39:32 perry Exp $	*/
2 
3 /*-
4  * Copyright (c) 1998 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software contributed to The NetBSD Foundation
8  * by Klaus Klein.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *        This product includes software developed by the NetBSD
21  *        Foundation, Inc. and its contributors.
22  * 4. Neither the name of The NetBSD Foundation nor the names of its
23  *    contributors may be used to endorse or promote products derived
24  *    from this software without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
27  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
28  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
30  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
31  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
32  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
33  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
34  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36  * POSSIBILITY OF SUCH DAMAGE.
37  */
38 
39 #pragma once
40 
41 /**
42  * @file strings.h
43  * @brief Extra string functions.
44  */
45 
46 #include <sys/cdefs.h>
47 
48 #include <sys/types.h>
49 #include <xlocale.h>
50 
51 #include <bits/strcasecmp.h>
52 
53 #if !defined(__BIONIC_STRINGS_INLINE)
54 #define __BIONIC_STRINGS_INLINE static __inline
55 #endif
56 
57 #undef ffs
58 #undef ffsl
59 #undef ffsll
60 
61 __BEGIN_DECLS
62 
63 /** Deprecated. Use memmove() instead. */
64 #define bcopy(b1, b2, len) __bionic_bcopy((b1), (b2), (len))
__bionic_bcopy(const void * _Nonnull b1,void * _Nonnull b2,size_t len)65 static __inline __always_inline void __bionic_bcopy(const void* _Nonnull b1, void* _Nonnull b2, size_t len) {
66   __builtin_memmove(b2, b1, len);
67 }
68 
69 /** Deprecated. Use memset() instead. */
70 #define bzero(b, len) __bionic_bzero((b), (len))
__bionic_bzero(void * _Nonnull b,size_t len)71 static __inline __always_inline void __bionic_bzero(void* _Nonnull b, size_t len) {
72   __builtin_memset(b, 0, len);
73 }
74 
75 /**
76  * [ffs(3)](https://man7.org/linux/man-pages/man3/ffs.3.html) finds the
77  * first set bit in `__n`.
78  *
79  * Returns 0 if no bit is set, or the index of the lowest set bit (counting
80  * from 1) otherwise.
81  */
ffs(int __n)82 __BIONIC_STRINGS_INLINE int ffs(int __n) {
83   return __builtin_ffs(__n);
84 }
85 
86 /**
87  * [ffsl(3)](https://man7.org/linux/man-pages/man3/ffsl.3.html) finds the
88  * first set bit in `__n`.
89  *
90  * Returns 0 if no bit is set, or the index of the lowest set bit (counting
91  * from 1) otherwise.
92  */
ffsl(long __n)93 __BIONIC_STRINGS_INLINE int ffsl(long __n) {
94   return __builtin_ffsl(__n);
95 }
96 
97 /**
98  * [ffsll(3)](https://man7.org/linux/man-pages/man3/ffsll.3.html) finds the
99  * first set bit in `__n`.
100  *
101  * Returns 0 if no bit is set, or the index of the lowest set bit (counting
102  * from 1) otherwise.
103  */
ffsll(long long __n)104 __BIONIC_STRINGS_INLINE int ffsll(long long __n) {
105   return __builtin_ffsll(__n);
106 }
107 
108 #if defined(__BIONIC_INCLUDE_FORTIFY_HEADERS)
109 #include <bits/fortify/strings.h>
110 #endif
111 
112 __END_DECLS
113