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_STR_ADVANCE

NAME

    #define SILC_STR_ADVANCE ...

DESCRIPTION

Advance the buffer to the end of the data after the formatting is done. In normal operation when the formatted data is written the buffer is positioned at the start of the data. With SILC_STR_ADVANCE the buffer will be positioned at the end of the data. This makes it easy to add new data immediately after the previously added data. The SILC_STR_ADVANCE may also be used in unformatting.

EXAMPLE

    do {
      len = read(fd, buf, sizeof(buf));
      if (len > 0)
        // Add read data to the buffer
        silc_buffer_format(buffer,
                           SILC_STR_ADVANCE,
                           SILC_STR_DATA(buf, len),
                           SILC_STR_END);
    } while (len > 0);

    // Move to beginning of buffer
    silc_buffer_start(buffer);