b = loadcase
function reads a specified case from an external file into memory. Once the case is loaded, all variables defined in the corresponding dictionary are available for use.
The dictionary_name must be supplied and refers to an external dictionary associated with your application.
The optional list of ID variables, id1 ... idN, specifies the list of variables that will identify the case to load from the external file. This process is similar to matching files on the basis of key variables in statistical and database software packages. Each of the variables in the list must be defined in a dictionary or working storage. The combined length of the variables in the list must equal the length of the case IDs defined for the external dictionary. The function concatenates the variables in the ID list to form a string. It then loads from the external file the case whose case identifier matches the string constructed from the list.
If no ID list is provided, the next logical case in the external file will be loaded. The next logical case is defined as the case with the next sequential case identifier (in ascending order). This will not necessarily be the next case in physical sequence in the file.
(In versions of CSPro prior to 7.0, calling this function would automatically open
an external file. The function no longer does this, so if you call close
on an external dictionary, you must open
it manually before calling this function.)
The function returns a logical value of 1 (true) if the case was loaded successfully and 0 (false) otherwise.