s = getlabel(dictionary_symbol ʃ, valueʅ);
function returns the label of a dictionary_symbol
or the text associated with a particular value of the symbol as defined in a value set. If the value
argument is not specified, then the dictionary symbol's label is returned. The symbol can be the name of a dictionary, level, record, item, or value set.
argument can only be used if the dictionary symbol is an item or a value set. The value
is either a numeric or string expression, based on the type of the item. If the argument is used, the label associated with the specified value is returned. If the symbol is an item name, then the value labels from the current value set are returned. If the symbol is a value set, then the value labels from that value set are returned. If no label is associated with the value, then an empty string is returned. This behavior can also be achieved with the getvaluelabel
When using the value argument, a value's code can be returned rather than the value label by using the optional by label (as opposed to the default by code behavior).
The function returns a string containing the label.
write("%s", getlabel(SEX)); // Sex
write("Crop Type = %s", getlabel(CROP_VS2, 23)); // Crop Type = Maize
write("%s = %s", getlabel($), getlabel($, $)); // Relationship = Head,
// Relationship = Child, etc.
write("%s", getlabel(SEX by code, 1)); // Male
write("%s", getlabel(SEX by label, "Male")); // 1