Routines (alphabetical) > Object Classes > File Format Object Classes > IDLffLangCat::AppendCatalog

# IDLffLangCat::AppendCatalog

Syntax | Return Value | Arguments | Keywords | Version History

The IDLffLangCat::AppendCatalog function method adds keys from a file or files to those used to build the language catalog. All valid keys present in the current language will be inserted into the current key/value list. If any new languages are present in the new files, they will be added to the AVAILABLE_LANGUAGES property. If a duplicate key name is found, its value will replace the existing key name’s value.

Note: Whenever the object encounters a key (or language) that already exists, the key (or language) is overwritten with the new value.

## Syntax

Result = Obj->[IDLffLangCat::]AppendCatalog( [, APP_NExelisAME=applicationName] [, FILENAME=filename] [, APP_PATH=applicationPath] )

## Return Value

Returns 1 if valid keys were found and loaded, or 0 otherwise.

## Arguments

None

## Keywords

### APP_NAME

Set this keyword to a string or string array containing the name of each desired application for which to add keys. If APP_NAME is specified, it overrides any input to FILENAME. You can use the ‘*’ wild card (e.g., ‘MyApp*’ instead of [‘MyAppMenu’, ‘MyAppErrors’, …]). You must provide either APP_NAME or FILENAME.

### APP_PATH

Set this keyword to a string or string array containing the name of each directory in which to search for the given application’s keys. Each path must be fully qualified (e.g., `C:\Exelis\IDL` `xx``\lib\itools`). This keyword is ignored if APP_NAME is not specified.

### FILENAME

Set this keyword to a string or string array containing the name of each language-catalog file to load. If APP_NAME is specified, it overrides any input to FILENAME. Each string is either a fully qualified path (e.g., `C:\Exelis\IDL` `xx``\resource\langcat`) to a location containing a file, or the name of a file in the current directory. You must provide either APP_NAME or FILENAME.

## Version History

6.1 | Introduced