getnamef¶

Purpose¶

Returns a string array containing the names of the variables in a GAUSS dataset.

Format¶

var_names = getnamef(fh)¶

Parameters:: fh (scalar) – file handle of an open dataset
Returns:: var_names (Nx1 string array) – contains the names of all of the variables in the specified dataset.

Examples¶

// Specify file name
file = getGAUSSHome()$+ "examples/freqdata.dat";

// Open the dataset
open fh = ^file for read;

/*
** Create a string array with the variable names from the
** dataset
*/
var_names = getnamef(fh);

// Print variables
print var_names;

produces:

AGE
PAY
sex
WT

The above example assumes that the dataset freqdata contains the variables: AGE, PAY, sex, WT. Note the use of vartypef() to determine the types of these variables.

Remarks¶

The output, y, will have as many rows as there are variables in the dataset.