mimeEntityGetHeaderValues

SYNOPSIS

varstrlst mimeEntityGetHeaderValues(mimeEntity entityOrReader,
                                    varchar headerName)

Parameters:

• entityOrReader - A mimeEntity or mimeReader object

• headerName - The varchar name of the header

Returns:

• varstrlst list of decoded value(s) of given header name

DESCRIPTION
The mimeEntityGetHeaderValues function returns the full values (i.e. including parameters) of header(s) named headerName in the entity, unfolded and RFC 2047 encoded-word decoded, as a varstrlst list.

Note: To obtain just the "empty/unnamed parameter" value - e.g. the MIME type without parameters, from a Content-Type header - use mimeEntityGetHeaderParameterValues (here).

EXAMPLE

<$ret = (mimeEntityGetHeaderValues($reader, "To" ))>
  Entity is addressed to: $ret

CAVEATS
The multi-value varstrlst return value will be split into multiple Vortex variable values that can be looped over, but only if <sqlcp arrayconvert> (here) is on (the default).

SEE ALSO
mimeEntityGetHeaderNames, mimeEntityGetHeaderParameterValues