Extract an address from a list of parsed addresses.

PASCAL

status = PMDF_address_get

(addr_context, index, address, address_len)

argument information

Argument	Data type	Access	Mechanism
addr_context	context pointer	read	value
index	integer	read	value
address	descriptor	read/write	reference
address_len	unsigned word	write	reference

C

status = PMDFaddressGet

(addr_context, index, address, address_len)

argument information

int PMDFaddressGet(PMDF_addr *addr_context, int index, char *address, int *address_len)

Arguments

addr_context

Address context generated by a previous call to PMDFaddressParseList .

index

Index of the address to extract from the list of parsed addresses.

address

String to receive the extracted address. Must be at least ALFA_SIZE bytes in length for PMDF_address_get and ALFA_SIZE+1 bytes for PMDFaddressGet.

line_len

Length in bytes of the returned address. Callers using PMDFaddressGet must, on input, supply the maximum length in bytes of address.

Description

After parsing a line of addresses with PMDFaddressParseList , the individual addresses can each be retrieved with PMDFaddressGet . Call PMDFaddressGet once for each address. The index argument can range from 1 to count where count is the count of parsed addresses returned by PMDFaddressParseList . The first address corresponds to an index value of 1 and the last to an index value of count. Note that PMDFaddressGet will also heuristically correct addresses with minor syntactical problems.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__NO	Value for index is out of range. No address returned.