xref: /aosp_15_r20/external/flac/include/share/safe_str.h (revision 600f14f40d737144c998e2ec7a483122d3776fbc)
1*600f14f4SXin Li /* libFLAC - Free Lossless Audio Codec library
2*600f14f4SXin Li  * Copyright (C) 2013-2023  Xiph.Org Foundation
3*600f14f4SXin Li  *
4*600f14f4SXin Li  * Redistribution and use in source and binary forms, with or without
5*600f14f4SXin Li  * modification, are permitted provided that the following conditions
6*600f14f4SXin Li  * are met:
7*600f14f4SXin Li  *
8*600f14f4SXin Li  * - Redistributions of source code must retain the above copyright
9*600f14f4SXin Li  * notice, this list of conditions and the following disclaimer.
10*600f14f4SXin Li  *
11*600f14f4SXin Li  * - Redistributions in binary form must reproduce the above copyright
12*600f14f4SXin Li  * notice, this list of conditions and the following disclaimer in the
13*600f14f4SXin Li  * documentation and/or other materials provided with the distribution.
14*600f14f4SXin Li  *
15*600f14f4SXin Li  * - Neither the name of the Xiph.org Foundation nor the names of its
16*600f14f4SXin Li  * contributors may be used to endorse or promote products derived from
17*600f14f4SXin Li  * this software without specific prior written permission.
18*600f14f4SXin Li  *
19*600f14f4SXin Li  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20*600f14f4SXin Li  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21*600f14f4SXin Li  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22*600f14f4SXin Li  * A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR
23*600f14f4SXin Li  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
24*600f14f4SXin Li  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25*600f14f4SXin Li  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
26*600f14f4SXin Li  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
27*600f14f4SXin Li  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
28*600f14f4SXin Li  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
29*600f14f4SXin Li  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30*600f14f4SXin Li  */
31*600f14f4SXin Li 
32*600f14f4SXin Li /* Safe string handling functions to replace things like strcpy, strncpy,
33*600f14f4SXin Li  * strcat, strncat etc.
34*600f14f4SXin Li  * All of these functions guarantee a correctly NUL terminated string but
35*600f14f4SXin Li  * the string may be truncated if the destination buffer was too short.
36*600f14f4SXin Li  */
37*600f14f4SXin Li 
38*600f14f4SXin Li #ifndef FLAC__SHARE_SAFE_STR_H
39*600f14f4SXin Li #define FLAC__SHARE_SAFE_STR_H
40*600f14f4SXin Li 
41*600f14f4SXin Li static inline char *
safe_strncat(char * dest,const char * src,size_t dest_size)42*600f14f4SXin Li safe_strncat(char *dest, const char *src, size_t dest_size)
43*600f14f4SXin Li {
44*600f14f4SXin Li 	char * ret;
45*600f14f4SXin Li 
46*600f14f4SXin Li 	if (dest_size < 1)
47*600f14f4SXin Li 		return dest;
48*600f14f4SXin Li 
49*600f14f4SXin Li 	/* Assume dist has space for a term character .. */
50*600f14f4SXin Li 	ret = strncat(dest, src, dest_size - strlen (dest));
51*600f14f4SXin Li 	/* .. but set it explicitly. */
52*600f14f4SXin Li 	dest [dest_size - 1] = 0;
53*600f14f4SXin Li 
54*600f14f4SXin Li 	return ret;
55*600f14f4SXin Li }
56*600f14f4SXin Li 
57*600f14f4SXin Li static inline char *
safe_strncpy(char * dest,const char * src,size_t dest_size)58*600f14f4SXin Li safe_strncpy(char *dest, const char *src, size_t dest_size)
59*600f14f4SXin Li {
60*600f14f4SXin Li 	char * ret;
61*600f14f4SXin Li 
62*600f14f4SXin Li 	if (dest_size < 1)
63*600f14f4SXin Li 		return dest;
64*600f14f4SXin Li 
65*600f14f4SXin Li 	ret = strncpy(dest, src, dest_size - 1);
66*600f14f4SXin Li 	dest [dest_size - 1] = 0;
67*600f14f4SXin Li 
68*600f14f4SXin Li 	return ret;
69*600f14f4SXin Li }
70*600f14f4SXin Li 
71*600f14f4SXin Li #endif /* FLAC__SHARE_SAFE_STR_H */
72