PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_address_get

Extract an address from a list of parsed addresses.

VMS FORMAT

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 FORMAT

status = PMDFaddressGet

(addr_context, index, address, address_len)

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

ARGUMENTS

addr_context

Address context generated by a previous call to PMDF_address_parse_list.

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. (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 PMDF_address_parse_list, the individual addresses may each be retrieved with PMDF_address_get. Call PMDF_address_get once for each address. The index argument may range from 1 to count where count is the count of parsed addresses returned by PMDF_address_parse_list. The first address corresponds to an index value of 1 and the last to an index value of count. Note that PMDF_address_get 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