4 * Copyright(c) 2010-2013 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.
38 * Definitions of warnings for use of various insecure functions
41 #ifndef _RTE_STRING_FNS_H_
42 #define _RTE_STRING_FNS_H_
54 * Safer version of snprintf that writes up to buflen characters to
55 * the output buffer and ensures that the resultant string is null-terminated,
56 * that is, it writes at most buflen-1 actual string characters to buffer. The
57 * return value is the number of characters which should be written to the
58 * buffer, so string truncation can be detected by the caller by checking if
59 * the return value is greater than or equal to the buflen.
62 * The buffer into which the output is to be written
65 * The size of the output buffer
68 * The format string to be printed to the buffer
71 * The number of characters written to the buffer, or if the string has been
72 * truncated, the number of characters which would have been written had the
73 * buffer been sufficiently big.
77 rte_snprintf(char *buffer, int buflen, const char *format, ...)
82 if (buffer == NULL && buflen != 0)
91 len = vsnprintf(buffer, buflen, format, ap);
93 if (len >= buflen && buflen > 0)
94 buffer[buflen - 1] = '\0';
105 * Takes string "string" parameter and splits it at character "delim"
106 * up to maxtokens-1 times - to give "maxtokens" resulting tokens. Like
107 * strtok or strsep functions, this modifies its input string, by replacing
108 * instances of "delim" with '\0'. All resultant tokens are returned in the
109 * "tokens" array which must have enough entries to hold "maxtokens".
112 * The input string to be split into tokens
115 * The max length of the input buffer
118 * The array to hold the pointers to the tokens in the string
121 * The number of elements in the tokens array. At most, maxtokens-1 splits
122 * of the string will be done.
125 * The character on which the split of the data will be done
128 * The number of tokens in the tokens array.
131 rte_strsplit(char *string, int stringlen,
132 char **tokens, int maxtokens, char delim)
135 int tokstart = 1; /* first token is right at start of string */
137 if (string == NULL || tokens == NULL)
140 for (i = 0; i < stringlen; i++) {
141 if (string[i] == '\0' || tok >= maxtokens)
145 tokens[tok++] = &string[i];
147 if (string[i] == delim) {
164 #endif /* RTE_STRING_FNS_H */