4 * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * * Neither the name of Intel Corporation nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37 * String-related functions as replacement for libc equivalents
40 #ifndef _RTE_STRING_FNS_H_
41 #define _RTE_STRING_FNS_H_
53 * Safer version of snprintf that writes up to buflen characters to
54 * the output buffer and ensures that the resultant string is null-terminated,
55 * that is, it writes at most buflen-1 actual string characters to buffer. The
56 * return value is the number of characters which should be written to the
57 * buffer, so string truncation can be detected by the caller by checking if
58 * the return value is greater than or equal to the buflen.
61 * The buffer into which the output is to be written
64 * The size of the output buffer
67 * The format string to be printed to the buffer
70 * The number of characters written to the buffer, or if the string has been
71 * truncated, the number of characters which would have been written had the
72 * buffer been sufficiently big.
76 rte_snprintf(char *buffer, int buflen, const char *format, ...)
81 if (buffer == NULL && buflen != 0)
90 len = vsnprintf(buffer, buflen, format, ap);
92 if (len >= buflen && buflen > 0)
93 buffer[buflen - 1] = '\0';
104 * Takes string "string" parameter and splits it at character "delim"
105 * up to maxtokens-1 times - to give "maxtokens" resulting tokens. Like
106 * strtok or strsep functions, this modifies its input string, by replacing
107 * instances of "delim" with '\\0'. All resultant tokens are returned in the
108 * "tokens" array which must have enough entries to hold "maxtokens".
111 * The input string to be split into tokens
114 * The max length of the input buffer
117 * The array to hold the pointers to the tokens in the string
120 * The number of elements in the tokens array. At most, maxtokens-1 splits
121 * of the string will be done.
124 * The character on which the split of the data will be done
127 * The number of tokens in the tokens array.
130 rte_strsplit(char *string, int stringlen,
131 char **tokens, int maxtokens, char delim)
134 int tokstart = 1; /* first token is right at start of string */
136 if (string == NULL || tokens == NULL)
139 for (i = 0; i < stringlen; i++) {
140 if (string[i] == '\0' || tok >= maxtokens)
144 tokens[tok++] = &string[i];
146 if (string[i] == delim) {
163 #endif /* RTE_STRING_FNS_H */