silc_buffer_sappend

SYNOPSIS

    static inline
    SilcBool silc_buffer_sappend(SilcStack stack, SilcBuffer sb,
                                 SilcUInt32 size)

DESCRIPTION

Appends the current data area by the amount of `size'. The tail area of the buffer remains intact and contains the same data than the old tail area (the data is copied to the new tail area). After appending there is now `size' bytes more free area in the data area. Returns FALSE if system is out of memory.

This routine use SilcStack are memory source. If `stack' is NULL reverts back to normal allocating routine.

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

EXAMPLE

    Before appending:
    ---------------------------------
    | head  | data           | tail |
    ---------------------------------

    After appending:
    ------------------------------------
    | head  | data               | tail |
    -------------------------------------

    silc_buffer_append(sb, 5);