blob: bedf089d0bf07da08d54a5aa923a81b9f8699dd6 [file] [log] [blame]
.. Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed
with this work for additional information regarding copyright
ownership. The ASF licenses this file to you under the Apache
License, Version 2.0 (the "License"); you may not use this file
except in compliance with the License. You may obtain a copy of
the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the License for the specific language governing
permissions and limitations under the License.
TSMimeHdrFieldFind
==================
Retrieves the :c:type:`TSMLoc` location of a specified MIME field from
within the MIME header located at hdr.
Synopsis
--------
`#include <ts/ts.h>`
.. c:function:: TSMLoc TSMimeHdrFieldFind(TSMBuffer bufp, TSMLoc hdr, const char *name, int length)
Description
-----------
The name and length parameters specify which field to retrieve. For
each MIME field in the MIME header, a case insensitive string
comparison is done between the field name and name. If
:c:func:`TSMimeHdrFieldFind` cannot find the requested field, it
returns :c:data:`TS_NULL_MLOC`. Release the returned :c:type:`TSMLoc`
handle with a call to :c:func:`TSHandleMLocRelease`.