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


Copyright © Thunderstone Software     Last updated: Oct 24 2023
Copyright © 2024 Thunderstone Software LLC. All rights reserved.