NAME

       TSMimeHdrFieldCreate - TSMimeHdrFieldCreate API function

SYNOPSIS

          #include <ts/ts.h>

       TSReturnCode TSMimeHdrFieldCreate(TSMBuffer bufp, TSMLoc hdr, TSMLoc *out)

       TSReturnCode TSMimeHdrFieldCreateNamed(TSMBuffer bufp, TSMLoc hdr, const char *name, int name_len, TSMLoc
       *out)

DESCRIPTION

       These  functions  create  MIME fields in a MIME header. The header is specified by the combination of the
       buffer bufp and a location hdr. The header must be either created such as by TSMimeHdrCreate() or  be  an
       existing header found via a function such as TSHttpTxnClientReqGet().

       TSMimeHdrFieldCreate()  creates  a  completely  empty  field  which  must be named before being used in a
       header,  usually  via  TSMimeHdrFieldNameSet().  It   is   almost   always   more   convenient   to   use
       TSMimeHdrFieldCreateNamed()  which combines these two steps, creating the field and then setting the name
       to name.

       For both functions a reference to the new field is returned via out.

       The field created is not in a header even though it is in the same buffer. It can be added  to  a  header
       with  TSMimeHdrFieldAppend().  The  field also has no value, only a name. If a value is needed it must be
       added explicitly with a function such as TSMimeHdrFieldValueIntSet().

COPYRIGHT

       2024, dev@trafficserver.apache.org

9.2                                               Apr 01, 2024                         TSMIMEHDRFIELDCREATE(3ts)