size_t pblStringBuilderAppend

( PblStringBuilder* stringBuilder,
  const char* format, ... )

Appends a variable string defined by the format parameter to the end of the data of the string builder.

Documentation

Appends a variable string defined by the format parameter to the end of the data of the string builder.

This function will append at most 4096 bytes of data to the string buffer. If you need to append more bytes, use the function pblStringBuilderAppendN.

For the possible values of the format parameter, see the documentation of the printf(3) family of functions.

This function has a time complexity of O(N), with N being the length of the string being appended.

Parameters:

stringBuilder - The string builder to use
format - The format of the arguments to append

Returns:

size_t rc >= 0: The length of the string builder.
size_t rc == -1: An error, see pbl_errno:
PBL_ERROR_OUT_OF_MEMORY - Out of memory.
PBL_ERROR_PARAM_FORMAT - Parameter format is not valid.

Alphabetic index