lib/eal/include/rte_string_fns.h - main - phprus/github_dpdk

lib/eal/include/rte_string_fns.h
188 строк5 KB
Bruce Richardson
eal: add basename function for common path manipulation
15 окт 2025, 15:58
15 окт 2025, 15:58b8a75ec
/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2010-2019 Intel Corporation
 */

/**
 * @file
 *
 * String-related functions as replacement for libc equivalents
 */

#ifndef _RTE_STRING_FNS_H_
#define _RTE_STRING_FNS_H_

#include <ctype.h>
#include <stdio.h>
#include <string.h>

#include <rte_common.h>
#include <rte_compat.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * 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".
 *
 * @param string
 *   The input string to be split into tokens
 *
 * @param stringlen
 *   The max length of the input buffer
 *
 * @param tokens
 *   The array to hold the pointers to the tokens in the string
 *
 * @param maxtokens
 *   The number of elements in the tokens array. At most, maxtokens-1 splits
 *   of the string will be done.
 *
 * @param delim
 *   The character on which the split of the data will be done
 *
 * @return
 *   The number of tokens in the tokens array.
 */
int
rte_strsplit(char *string, int stringlen,
             char **tokens, int maxtokens, char delim);

/**
 * @internal
 * DPDK-specific version of strlcpy for systems without
 * libc or libbsd copies of the function
 */
static inline size_t
rte_strlcpy(char *dst, const char *src, size_t size)
{
	return (size_t)snprintf(dst, size, "%s", src);
}

/**
 * @internal
 * DPDK-specific version of strlcat for systems without
 * libc or libbsd copies of the function
 */
static inline size_t
rte_strlcat(char *dst, const char *src, size_t size)
{
	size_t l = strnlen(dst, size);
	if (l < size)
		return l + rte_strlcpy(&dst[l], src, size - l);
	return l + strlen(src);
}

#ifdef __cplusplus
}
#endif

/* pull in a strlcpy function */
#ifdef RTE_EXEC_ENV_FREEBSD
#ifndef __BSD_VISIBLE /* non-standard functions are hidden */
#define strlcpy(dst, src, size) rte_strlcpy(dst, src, size)
#define strlcat(dst, src, size) rte_strlcat(dst, src, size)
#endif

#else /* non-BSD platforms */
#ifdef RTE_USE_LIBBSD
#include <bsd/string.h>

#else /* no BSD header files, create own */
#define strlcpy(dst, src, size) rte_strlcpy(dst, src, size)
#define strlcat(dst, src, size) rte_strlcat(dst, src, size)

#endif /* RTE_USE_LIBBSD */
#endif /* FREEBSD */

#ifdef __cplusplus
extern "C" {
#endif

/**
 * Copy string src to buffer dst of size dsize.
 * At most dsize-1 chars will be copied.
 * Always NUL-terminates, unless (dsize == 0).
 *
 * @param dst
 *   The destination string.
 *
 * @param src
 *   The input string to be copied.
 *
 * @param dsize
 *   Length in bytes of the destination buffer.
 *
 * @return
 *   The number of bytes copied (terminating NUL-byte excluded) on success.
 *   -E2BIG if the destination buffer is too small.
 *   rte_errno is set.
 */
ssize_t
rte_strscpy(char *dst, const char *src, size_t dsize);

/**
 * @warning
 * @b EXPERIMENTAL: this API may change without prior notice.
 *
 * Search for the first non whitespace character.
 *
 * @param src
 *   The input string to be analysed.
 *
 * @return
 *  The address of the first non whitespace character.
 */
__rte_experimental
static inline const char *
rte_str_skip_leading_spaces(const char *src)
{
	const char *p = src;

	while (isspace(*p))
		p++;

	return p;
}

/**
 * @warning
 * @b EXPERIMENTAL: this API may change without prior notice.
 *
 * Provides the final component of a path, similar to POSIX basename function.
 *
 * This API provides the similar behaviour on all platforms, Linux, BSD, Windows,
 * hiding the implementation differences.
 * - It does not modify the input path.
 * - The output buffer is passed as an argument, and the result is copied into it.
 * - Expected output is the last component of the path, or the path itself if
 *   it does not contain a directory separator.
 * - If the final component is too long to fit in the output buffer, it will be truncated.
 * - For empty or NULL input paths, output buffer will contain the string ".".
 * - Supports up to PATH_MAX (BSD/Linux) or _MAX_PATH (Windows) characters in the input path.
 *
 * @param path
 *   The input path string. Not modified by this function.
 * @param buf
 *   The buffer to hold the resultant basename.
 *   Must be large enough to hold the result, otherwise basename will be truncated.
 * @param buflen
 *   The size of the buffer in bytes.
 * @return
 *   The number of bytes that were written to buf (excluding the terminating '\0').
 *   If the return value is >= buflen, truncation occurred.
 *   Return (size_t)-1 on error (Windows only)
 */
__rte_experimental
size_t
rte_basename(const char *path, char *buf, size_t buflen);

#ifdef __cplusplus
}
#endif

#endif /* RTE_STRING_FNS_H */