Buffer Format Interface SilcBufferFormatFunc SilcBufferUnformatFunc silc_buffer_format silc_buffer_sformat silc_buffer_format_vp silc_buffer_sformat_vp silc_buffer_unformat silc_buffer_sunformat silc_buffer_unformat_vp silc_buffer_sunformat_vp silc_buffer_strformat silc_buffer_sstrformat SILC_STR_SINT8 SILC_STR_UINT8 SILC_STR_SINT16 SILC_STR_UINT16 SILC_STR_SINT32 SILC_STR_UINT32 SILC_STR_SINT64 SILC_STR_UINT64 SILC_STR_STRING SILC_STR_*_STRING SILC_STR_*_NSTRING SILC_STR_DATA SILC_STR_BUFFER SILC_STR_REPLACE SILC_STR_FUNC SilcBufferRegexFlags SILC_STR_REGEX SILC_STR_DELETE SILC_STR_OFFSET SILC_STR_OFFSET_START SILC_STR_OFFSET_END SILC_STR_ADVANCE SILC_STR_END SILC_STRFMT_END

silc_buffer_sstrformat

SYNOPSIS

    int silc_buffer_strformat(SilcStack stack, SilcBuffer dst, ...);

DESCRIPTION

Formats a buffer from variable argument list of strings. Each string must be NULL-terminated and the variable argument list must be end with SILC_STRFMT_END argument. This allows that a string in the list can be NULL, in which case it is skipped. This automatically allocates the space for the buffer data but `dst' must be already allocated by the caller. This function is equivalent to silc_buffer_strformat but allocates memory from `stack'. Returns -1 if system is out of memory and sets silc_errno.

Note that this call consumes the `stack'. The caller should push the stack before calling the function and pop it later.