NAME

       TSUrlCreate - traffic Server URL object construction API

SYNOPSIS

       #include <ts/ts.h>

       TSReturnCode TSUrlCreate(TSMBuffer bufp, TSMLoc* locp)

       TSReturnCode TSUrlClone(TSMBuffer dest_bufp, TSMBuffer src_bufp, TSMLoc src_url, TSMLoc* locp)

       TSReturnCode TSUrlCopy(TSMBuffer dest_bufp, TSMLoc dest_url, TSMBuffer src_bufp, TSMLoc src_url)

       TSParseResult TSUrlParse(TSMBuffer bufp, TSMLoc offset, const char ** start, const char* end)

DESCRIPTION

       The  URL  data  structure  is  a  parsed  version  of a standard internet URL. The Traffic Server URL API
       provides access to URL data stored in marshal buffers. The URL functions can create,  copy,  retrieve  or
       delete entire URLs, and retrieve or modify parts of URLs, such as their host, port or scheme information.

       TSUrlCreate()  creates a new URL within the marshal buffer bufp. Release the resulting handle with a call
       to TSHandleMLocRelease().

       TSUrlClone() copies the contents of the URL at location src_url within the marshal buffer src_bufp  to  a
       location   within   the   marshal   buffer  dest_bufp.  Release  the  returned  handle  with  a  call  to
       TSHandleMLocRelease().

       TSUrlCopy() copies the contents of the URL at location src_url within the marshal buffer src_bufp to  the
       location  dest_url  within the marshal buffer dest_bufp. TSUrlCopy() works correctly even if src_bufp and
       dest_bufp point to different marshal buffers. It is important for the destination URL (its marshal buffer
       and TSMLoc) to have been created before copying into it.

       TSUrlParse() parses a URL. The start pointer is both an input and an output parameter and marks the start
       of the URL to be parsed. After a successful parse, the start pointer equals  the  end  pointer.  The  end
       pointer must be one byte after the last character you want to parse. The URL parsing routine assumes that
       everything  between  start and end is part of the URL. It is up to higher level parsing routines, such as
       TSHttpHdrParseReq(), to determine the actual end of the URL.

RETURN VALUES

       The TSUrlParse() function returns a TSParseResult, where TS_PARSE_ERROR indicates an  error.  Success  is
       indicated  by  one  of  TS_PARSE_DONE,  TS_PARSE_OK  or  TS_PARSE_CONT.  The  other  APIs  all  return  a
       TSReturnCode, indicating success (TS_SUCCESS) or failure (TS_ERROR) of the operation.

SEE ALSO

       TSAPI(3ts),    TSMBufferCreate(3ts),    TSUrlHostGet(3ts),    TSUrlHostSet(3ts),     TSUrlStringGet(3ts),
       TSUrlPercentEncode(3ts)

COPYRIGHT

       2014, dev@trafficserver.apache.org

5.3                                              April 18, 2016                                 TSURLCREATE(3ts)