HashMap.GetKeys Function

Format

i = hashmap_name.getKeys(list_name 『, key_value1, ..., key_valueN』);

Description

The hashmap.getKeys function fills a list with the keys at a specific location in the hashmap. Each key_value argument must be a numeric or string expression matching the type specified when declaring the hashmap. If no arguments are provided, the first-dimension keys are returned; if one argument is provided, the second-dimension keys are returned; and so on.

The argument list_name is a numeric or string list whose contents will be cleared and then filled with the hashmap's keys. The type of the list must correspond to the type of keys at the specified location. If the dimension type is numeric, then the list must be a numeric list. If the dimension type is string or all, then the list must be a string list. In the case of all, any numeric values added as keys to the hashmap will be converted to strings before being inserted in the string list.

Return Value

The function returns the number of keys added to the list.

Example

PROC GLOBAL

hashmap invalidValuesByPerson default(0);

PROC CENSUS_LEVEL

list string person_list;

invalidValuesByPerson.getKeys(person_list);

do numeric counter = 1 while counter <= person_list.length()
errmsg("%s had %d invalid values", strip(person_list(counter)),
invalidValuesByPerson(person_list(counter)));
enddo;

invalidValuesByPerson.clear();

PROC SEX

if not invalueset(SEX) then
inc(invalidValuesByPerson(PERSON_NAME));
endif;

PROC AGE

if not invalueset(AGE) then
inc(invalidValuesByPerson(PERSON_NAME));
endif;