1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2019 Intel Corporation
8 * String-related functions as replacement for libc equivalents
11 #ifndef _RTE_STRING_FNS_H_
12 #define _RTE_STRING_FNS_H_
21 #include <rte_common.h>
24 * Takes string "string" parameter and splits it at character "delim"
25 * up to maxtokens-1 times - to give "maxtokens" resulting tokens. Like
26 * strtok or strsep functions, this modifies its input string, by replacing
27 * instances of "delim" with '\\0'. All resultant tokens are returned in the
28 * "tokens" array which must have enough entries to hold "maxtokens".
31 * The input string to be split into tokens
34 * The max length of the input buffer
37 * The array to hold the pointers to the tokens in the string
40 * The number of elements in the tokens array. At most, maxtokens-1 splits
41 * of the string will be done.
44 * The character on which the split of the data will be done
47 * The number of tokens in the tokens array.
50 rte_strsplit(char *string, int stringlen,
51 char **tokens, int maxtokens, char delim);
55 * DPDK-specific version of strlcpy for systems without
56 * libc or libbsd copies of the function
59 rte_strlcpy(char *dst, const char *src, size_t size)
61 return (size_t)snprintf(dst, size, "%s", src);
66 * DPDK-specific version of strlcat for systems without
67 * libc or libbsd copies of the function
70 rte_strlcat(char *dst, const char *src, size_t size)
72 size_t l = strnlen(dst, size);
74 return l + rte_strlcpy(&dst[l], src, size - l);
75 return l + strlen(src);
78 /* pull in a strlcpy function */
79 #ifdef RTE_EXEC_ENV_FREEBSD
80 #ifndef __BSD_VISIBLE /* non-standard functions are hidden */
81 #define strlcpy(dst, src, size) rte_strlcpy(dst, src, size)
82 #define strlcat(dst, src, size) rte_strlcat(dst, src, size)
85 #else /* non-BSD platforms */
87 #include <bsd/string.h>
89 #else /* no BSD header files, create own */
90 #define strlcpy(dst, src, size) rte_strlcpy(dst, src, size)
91 #define strlcat(dst, src, size) rte_strlcat(dst, src, size)
93 #endif /* RTE_USE_LIBBSD */
97 * Copy string src to buffer dst of size dsize.
98 * At most dsize-1 chars will be copied.
99 * Always NUL-terminates, unless (dsize == 0).
100 * Returns number of bytes copied (terminating NUL-byte excluded) on success ;
101 * negative errno on error.
104 * The destination string.
107 * The input string to be copied.
110 * Length in bytes of the destination buffer.
113 * The number of bytes copied on success
114 * -E2BIG if the destination buffer is too small.
117 rte_strscpy(char *dst, const char *src, size_t dsize);
123 #endif /* RTE_STRING_FNS_H */