Skip to content

SIP_HEADERS()

Synopsis

Gets the list of SIP header names from an incoming INVITE message.

Description

Returns a comma-separated list of header names (without values) from the INVITE message that originated the current channel. Multiple headers with the same name are included in the list only once. The returned list can be iterated over using the functions POP() and SIP_HEADER().

For example, '${SIP_HEADERS(Co)}' might return 'Contact,Content-Length,Content-Type'. As a practical example, you may use '${SIP_HEADERS(X-)}' to enumerate optional extended headers.

This function does not access headers from the incoming SIP REFER message; see the documentation of the function SIP_HEADER for how to access them.

Please observe that contents of the SDP (an attachment to the SIP request) can't be accessed with this function.

Syntax

SIP_HEADERS(prefix)
Arguments
  • prefix - If specified, only the headers matching the given prefix are returned.

See Also

Generated Version

This documentation was generated from Asterisk branch 16 using version GIT