Next: , Up: System and Portable File IO


9.1 APPLY DICTIONARY

     APPLY DICTIONARY FROM={'file_name',file_handle}.

APPLY DICTIONARY applies the variable labels, value labels, and missing values taken from a file to corresponding variables in the active dataset. In some cases it also updates the weighting variable.

Specify a system file or portable file's name, a data set name (see Datasets), or a file handle name (see File Handles). The dictionary in the file will be read, but it will not replace the active dataset's dictionary. The file's data will not be read.

Only variables with names that exist in both the active dataset and the system file are considered. Variables with the same name but different types (numeric, string) will cause an error message. Otherwise, the system file variables' attributes will replace those in their matching active dataset variables:

In addition to properties of variables, some properties of the active file dictionary as a whole are updated:

APPLY DICTIONARY takes effect immediately. It does not read the active dataset. The system file is not modified.