TSMimeHdrFieldCreate - TSMimeHdrFieldCreate API function

       2025, dev@trafficserver.apache.org

9.2                                               May 22, 2025                         TSMIMEHDRFIELDCREATE(3ts)

       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().

       TSMimeHdrFieldCreate - TSMimeHdrFieldCreate API function

          #include <ts/ts.h>

       TSReturnCodeTSMimeHdrFieldCreate(TSMBufferbufp,TSMLochdr,TSMLoc*out)TSReturnCodeTSMimeHdrFieldCreateNamed(TSMBufferbufp,TSMLochdr,constchar*name,intname_len,TSMLoc*out)