Parse a line of comma separated addresses.

PASCAL

status = PMDF_address_parse_list

(addr_context, count, line)

argument information

Argument	Data type	Access	Mechanism
addr_context	context pointer	read/write	reference
count	integer	write	reference
line	descriptor	read	reference

C

status = PMDFaddressParseList

(addr_context, count, line, line_len)

argument information

int PMDFaddressParseList(PMDF_addr **addr_context, int *count, char *line, int line_len)

Arguments

addr_context

Address context created for the parsed address line.

count

The number of addresses parsed.

line

Character string containing the list of comma separated, RFC 822 addresses to be parsed.

line_len

Length in bytes of the string of addresses to parse.

Description

PMDFaddressParseList can be used to parse a line of one or more comma separated RFC 822 addresses. The input line can be of arbitrary length. The result of the parse is represented by an address context, addr_context, and a count of parsed addresses, count. Each parsed address can then be individually extracted from the parsed line with a call to PMDFaddressGet or PMDFaddressGetProperty . The address context should be disposed of with a call to PMDFaddressDispose . When there are no valid addresses in the input line, the returned context will be zero (nil) and the count zero.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__INVSTRDES	Invalid string descriptor for line: descriptor has an invalid value in its DSC$B_CLASS field. No result returned.