split.h File Reference

#include "rcutils/allocator.h"
#include "rcutils/types.h"
#include "rcutils/visibility_control.h"

Go to the source code of this file.

Functions
rcutils_ret_t	rcutils_split (const char *str, char delimiter, rcutils_allocator_t allocator, rcutils_string_array_t *string_array)
	Split a given string with the specified delimiter. More...
rcutils_ret_t	rcutils_split_last (const char *str, char delimiter, rcutils_allocator_t allocator, rcutils_string_array_t *string_array)
	Split a given string on the last occurrence of the specified delimiter. More...

Function Documentation

rcutils_split()

rcutils_ret_t rcutils_split	(	const char *	str,
		char	delimiter,
		rcutils_allocator_t	allocator,
		rcutils_string_array_t *	string_array
	)

Split a given string with the specified delimiter.

Parameters

[in]	str	string to split
[in]	delimiter	on where to split
[in]	allocator	for allocating new memory for the output array
[out]	string_array	with the split tokens

Returns

RCUTILS_RET_OK if successful, or

RCUTILS_RET_INVALID_ARGUMENT for invalid arguments, or

RCUTILS_RET_BAD_ALLOC if memory allocation fails, or

RCUTILS_RET_ERROR if an unknown error occurs

rcutils_split_last()

rcutils_ret_t rcutils_split_last	(	const char *	str,
		char	delimiter,
		rcutils_allocator_t	allocator,
		rcutils_string_array_t *	string_array
	)

Split a given string on the last occurrence of the specified delimiter.

Parameters

[in]	str	string to split
[in]	delimiter	on where to split
[in]	allocator	for allocating new memory for the output array
[out]	string_array	with the split tokens

Returns

array with split token, NULL in case of error