PMDF Programmer's Reference Manual
Previous Next Contents Index

PMDFaddressGet

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.

Previous Next Contents Index