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