nghttp2_hpack_encoder_write
===========================

Synopsis
--------

*#include <nghttp2v2/nghttp2.h>*

.. function:: int nghttp2_hpack_encoder_write(nghttp2_hpack_encoder *enc, nghttp2_buf *buf, const nghttp2_nv *nva, size_t nvlen)

    
    `nghttp2_hpack_encoder_write` encodes the *nva* of *nvlen* elements
    into *buf*.
    
    This function expands *buf* as necessary to store the result.
    :member:`buf->last <nghttp2_buf.last>` will be adjusted when data
    is written.  *buf* can be empty buffer, that is initialized by
    `nghttp2_buf_init`.  If :member:`buf->begin <nghttp2_buf.begin>` is
    not ``NULL``, it must be allocated by the same memory allocator
    passed to `nghttp2_hpack_encoder_new`.
    
    After this function returns, it is safe to delete the *nva*.
    
    This function returns 0 if it succeeds, or one of the following
    negative error codes:
    
    :macro:`NGHTTP2_ERR_NOMEM`
        Out of memory.
    :macro:`NGHTTP2_ERR_HPACK_FATAL`
        Encoding process has failed.