Synopsis

Description

This function is used to map one set of strings to another.
Typically, this is done for country names, to map from the
two-letter country codes to longer more readable names. The mechanism is
general enough to be used with other things, though.

filename is the name of a file containing the unfriendly to friendly
mapping, name is the unfriendly name to map to a friendly name,
and map is a result-parameter that should be set to NULL on
the first call. It is then used to hold the mapping in
core so that the file need not be read on subsequent calls.