---
name: "rte_string_fns.h"
section: "3"
platform: "linux"
package: "dpdk-doc"
version: "24.11.4-0+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rte_string_fns.h"
---

# rte\_string\_fns.h(3)

## NAME

rte\_string\_fns.h

## SYNOPSIS

`#include <ctype.h>`\
 `#include <stdio.h>`\
 `#include <string.h>`\
 `#include <rte_common.h>`\
 `#include <rte_compat.h>`\

### Functions

int **rte\_strsplit** (char \*string, int stringlen, char \*\*tokens, int maxtokens, char delim)\
 ssize\_t **rte\_strscpy** (char \*dst, const char \*src, size\_t dsize)\
 static \_\_rte\_experimental const char \* **rte\_str\_skip\_leading\_spaces** (const char \*src)\

## Detailed Description

String-related functions as replacement for libc equivalents

Definition in file **rte\_string\_fns.h**.

## Function Documentation

### int rte\_strsplit (char \* string, int stringlen, char \*\* tokens, int maxtokens, char delim)

Takes string 'string' parameter and splits it at character 'delim' up to maxtokens-1 times - to give 'maxtokens' resulting tokens. Like strtok or strsep functions, this modifies its input string, by replacing instances of 'delim' with '\\0'. All resultant tokens are returned in the 'tokens' array which must have enough entries to hold 'maxtokens'.

**Parameters**

*string* The input string to be split into tokens\
 *stringlen* The max length of the input buffer\
 *tokens* The array to hold the pointers to the tokens in the string\
 *maxtokens* The number of elements in the tokens array. At most, maxtokens-1 splits of the string will be done.\
 *delim* The character on which the split of the data will be done

**Returns**

The number of tokens in the tokens array.

### ssize\_t rte\_strscpy (char \* dst, const char \* src, size\_t dsize)

Copy string src to buffer dst of size dsize. At most dsize-1 chars will be copied. Always NUL-terminates, unless (dsize == 0).

**Parameters**

*dst* The destination string.\
 *src* The input string to be copied.\
 *dsize* Length in bytes of the destination buffer.

**Returns**

The number of bytes copied (terminating NUL-byte excluded) on success. -E2BIG if the destination buffer is too small. rte\_errno is set.

### static \_\_rte\_experimental const char \* rte\_str\_skip\_leading\_spaces (const char \* src)` [inline]`, ` [static]`

**Warning**

**EXPERIMENTAL:** this API may change without prior notice.

Search for the first non whitespace character.

**Parameters**

*src* The input string to be analysed.

**Returns**

The address of the first non whitespace character.

Definition at line **142** of file **rte\_string\_fns.h**.

## Author

Generated automatically by Doxygen for DPDK from the source code.