Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
locale
has_facet
isalnum
isalpha
iscntrl
isdigit
isgraph
islower
isprint
ispunct
isspace
isupper
isxdigit
locale
tolower
toupper
use_facet
standard facets:
codecvt
codecvt_base
codecvt_byname
collate
collate_byname
ctype
ctype_base
ctype_byname
messages
messages_base
messages_byname
moneypunct
moneypunct_byname
money_base
money_get
money_put
numpunct
numpunct_byname
num_get
num_put
time_base
time_get
time_get_byname
time_put
time_put_byname
messages
messages::messages
public member functions:
messages::close
messages::get
messages::open
public member types:
messages::catalog
messages::char_type
messages::string_type
protected members:
messages::do_close
messages::do_get
messages::do_open
messages::~messages


messages::open

public member function
catalog open (const basic_string<char>& name, const locale& loc) const;

Open message catalog

Opens the message catalog name to access messages and returns an object that uniquely identifies the catalog.

During its operation, the version of this function in the generic template simply calls the virtual protected member do_open, which is the member function in charge of performing the actions described above.

Parameters

name
string identifying a message catalog.
loc
locale object. It is only used for character set code conversions while retrieving messages.

Return value

An object of member type messages::catalog that identifies the message catalog. This value is only meant to be used by member get, to access the individual messages, and by member close, which closes the catalog and invalidates this value as a catalog identifier.

If the function cannot open the catalog, it returns a value which is less than zero.

See also