Access a mapping table.

PASCAL

status = PMDF_mapping_load (table, mapping)

C

status = PMDFmappingLoad

(table, table_len, mapping)

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.