Access a mapping table.

PASCAL

status = PMDF_mapping_load (table, mapping)

argument information

Argument	Data type	Access	Mechanism
table	descriptor	read	reference
mapping	signed longword	write	reference

C

status = PMDFmappingLoad

(table, table_len, mapping)

argument information

int PMDFmappingLoad(char *table, int table_len, int *mapping)

Arguments

table

Name of the table to load. The length of the string can not exceed ALFA_SIZE bytes.

table_len

Length in bytes of the table name.

mapping

Reference to the loaded mapping table for use with PMDFmappingApply .

Description

Before a mapping table can be used to map input strings, it must first be loaded. This is accomplished with PMDFmappingLoad . Any number of tables can be loaded, one table per PMDFmappingLoad call. Once a mapping table is loaded, it can be used with PMDFmappingApply . There is no call to make to unload a table. PMDFinitialize must be called prior to the first call to PMDFmappingLoad . Failure to initialize PMDF first will result in a PMDF__NO error.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__INVSTRDES	Invalid string descriptor for table: descriptor has an invalid value in its DSC$B_CLASS field. No table loaded.
PMDF__NO	PMDFinitialize has not yet been called. No table loaded.
PMDF__NOMAPPING	Cannot load specified mapping table; check to see if the mapping table exists. No table loaded.
PMDF__STRTRUERR	Supplied table name is too long. No table loaded.