Function rcutils_char_array_expand_as_needed

Defined in File char_array.h

Function Documentation

rcutils_ret_t rcutils_char_array_expand_as_needed(rcutils_char_array_t *char_array, size_t new_size)

Expand the internal buffer of the char array.

This function is equivalent to rcutils_char_array_resize except that it resizes the internal buffer only when it is not big enough. If the buffer is already big enough for new_size, it returns RCUTILS_RET_OK without doing anything.

Parameters:

char_array – [inout] pointer to the instance of rcutils_char_array_t which is being resized
new_size – [in] the new size of the internal buffer

Returns:

RCUTILS_RET_OK if successful, or

Returns:

RCUTILS_RET_BAD_ALLOC if memory allocation failed, or

Returns:

RCUTILS_RET_ERROR if an unexpected error occurs.