PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Parse a line of comma separated addresses.

VMS FORMAT

status = PMDF_address_parse_list

(addr_context, count, line)

C FORMAT

status = PMDFaddressParseList

(addr_context, count, line, line_len)

int PMDFaddressParseList (addr_context, count, line, 
                          line_len) 
         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

PMDF_address_parse_list may be used to parse a line of one or more comma separated RFC 822 addresses. The input line may 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 may then be individually extracted from the parsed line with a call to PMDF_address_get or PMDF_address_get_property. The address context should be disposed of with a call to PMDF_address_dispose. When there are no valid addresses in the input line, the returned context will be zero (nil) and the count zero.