strdup.h File Reference

#include <string.h>
#include "rcutils/allocator.h"
#include "rcutils/macros.h"
#include "rcutils/visibility_control.h"

Go to the source code of this file.

Functions
char *	rcutils_strdup (const char *str, rcutils_allocator_t allocator)
	Return a duplicated string with an allocator, or null if an error occurs. More...
char *	rcutils_strndup (const char *str, size_t string_length, rcutils_allocator_t allocator)
	Return a duplicated string with an allocator, or null if an error occurs. More...

Function Documentation

rcutils_strdup()

char* rcutils_strdup	(	const char *	str,
		rcutils_allocator_t	allocator
	)

Return a duplicated string with an allocator, or null if an error occurs.

This function is identical to rcutils_strndup() except the length of the c string does not have to be given and therefore the c string must be null terminated.

See also

rcutils_strndup()

Parameters

[in]	str	null terminated c string to be duplicated
[in]	allocator	the allocator to use for allocation

Returns

duplicated string or null if there is an error

rcutils_strndup()

char* rcutils_strndup	(	const char *	str,
		size_t	string_length,
		rcutils_allocator_t	allocator
	)

Return a duplicated string with an allocator, or null if an error occurs.

This function can fail and return null if memory cannot be allocated or if the input c string pointer is null. In both cases no error message is set. The returned string should be deallocated using the given allocator when it is no longer needed.

The string_length given does not include the null terminating character. Therefore a string_length of 0 will still result in a duplicated string, but the string will be an empty string of strlen 0, but it still must be deallocated. All returned strings are null terminated.

Parameters

[in]	str	null terminated c string to be duplicated
[in]	string_length	length of the string to duplicate
[in]	allocator	the allocator to use for allocation

Returns

duplicated string or null if there is an error