3.5.1.7.18 Range2uid


Return the universal identifier (UID) given a range specifier (not a range variable!). The range specifier or address can be the name of a book, a sheet, or a column.

Syntax:

int someUid = Range2uid(rangeSpecifier)$


Examples:

The following script displays internal dataset names of all columns in the current sheet.

// Return the UID of column 2
int nColUID = range2uid(col(2));  
// Return the UID of a sheet or layer             
int nLayerUID = range2uid([book2]Sheet3!);  
// Return the UID of the active sheet or layer   
nLayerUID =range2uid(!);                    
// Return the UID of sheet3 of the active workbook   
nLayerUID =range2uid(sheet3!);              
// Return the UID of the column with index 'jj' within a specific sheet     
nColUID = range2uid([Book1]sheet2!wcol(jj));

Additionally, the range2uid function works with the system variable %C, which holds the name of the active data plot or data column:

// Return the UID of the active data plot or selected column
nDataSetUID = range2uid(%C);

See Also:

Colnum (function)

NameOf (function)

Uid2range (function)

Uid2name (function)