locale Class Reference

#include <_locale.h>

Collaboration diagram for locale:

Classes
class	facet
class	id

Public Types
typedef int	category

Public Member Functions
	_STLP_STATIC_CONSTANT (category, none=0x000)
	_STLP_STATIC_CONSTANT (category, collate=0x010)
	_STLP_STATIC_CONSTANT (category, ctype=0x020)
	_STLP_STATIC_CONSTANT (category, monetary=0x040)
	_STLP_STATIC_CONSTANT (category, numeric=0x100)
	_STLP_STATIC_CONSTANT (category, time=0x200)
	_STLP_STATIC_CONSTANT (category, messages=0x400)
	_STLP_STATIC_CONSTANT (category, all=collate|ctype|monetary|numeric|time|messages)
	locale () _STLP_NOTHROW
	locale (const locale &) _STLP_NOTHROW
	locale (const char *)
	locale (const locale &, const char *, category)
	locale (const locale &, const locale &, category)
const locale &	operator= (const locale &) _STLP_NOTHROW
	~locale () _STLP_NOTHROW
string	name () const
bool	operator== (const locale &) const
bool	operator!= (const locale &) const
bool	operator() (const string &__x, const string &__y) const
bool	operator() (const wstring &__x, const wstring &__y) const
facet *	_M_get_facet (const id &) const
facet *	_M_use_facet (const id &) const
void	_M_insert (facet *__f, id &__id)

Static Public Member Functions
static locale _STLP_CALL	global (const locale &)
static const locale &_STLP_CALL	classic ()
static void _STLP_FUNCTION_THROWS _STLP_CALL	_M_throw_on_combine_error (const string &name)
static void _STLP_FUNCTION_THROWS _STLP_CALL	_M_throw_on_null_name ()
static void _STLP_FUNCTION_THROWS _STLP_CALL	_M_throw_on_creation_failure (int __err_code, const char *name, const char *facet)

Protected Member Functions
	locale (_Locale_impl *)
_Locale_impl *	_M_get_impl () const

Protected Attributes
_Locale_impl *	_M_impl

Friends
class	_Locale_impl

Detailed Description

Definition at line 75 of file _locale.h.

Member Typedef Documentation

category

typedef int locale::category

Definition at line 107 of file _locale.h.

Constructor & Destructor Documentation

locale() [1/6]

locale::locale

(

)

Definition at line 118 of file locale.cpp.

  : _M_impl(_get_Locale_impl(_Stl_get_global_locale()->_M_impl))
{}

locale() [2/6]

locale::locale

(

const locale &

L

)

Definition at line 123 of file locale.cpp.

  : _M_impl( _get_Locale_impl( L._M_impl ) )
{}

locale() [3/6]

locale::locale ( const char *  name )

explicit

Definition at line 137 of file locale.cpp.

  : _M_impl(0) {
  if (!name)
    _M_throw_on_null_name();
 
  if (is_C_locale_name(name)) {
    _M_impl = _get_Locale_impl( locale::classic()._M_impl );
    return;
  }
 
  _Locale_impl* impl = 0;
  _STLP_TRY {
    impl = new _Locale_impl(locale::id::_S_max, name);
 
    // Insert categories one at a time.
    _Locale_name_hint *hint = 0;
    const char* ctype_name = name;
    char ctype_buf[_Locale_MAX_SIMPLE_NAME];
    const char* numeric_name = name;
    char numeric_buf[_Locale_MAX_SIMPLE_NAME];
    const char* time_name = name;
    char time_buf[_Locale_MAX_SIMPLE_NAME];
    const char* collate_name = name;
    char collate_buf[_Locale_MAX_SIMPLE_NAME];
    const char* monetary_name = name;
    char monetary_buf[_Locale_MAX_SIMPLE_NAME];
    const char* messages_name = name;
    char messages_buf[_Locale_MAX_SIMPLE_NAME];
    hint = impl->insert_ctype_facets(ctype_name, ctype_buf, hint);
    hint = impl->insert_numeric_facets(numeric_name, numeric_buf, hint);
    hint = impl->insert_time_facets(time_name, time_buf, hint);
    hint = impl->insert_collate_facets(collate_name, collate_buf, hint);
    hint = impl->insert_monetary_facets(monetary_name, monetary_buf, hint);
    impl->insert_messages_facets(messages_name, messages_buf, hint);
 
    // Try to use a normalize locale name in order to have the == operator
    // to behave correctly:
    if (strcmp(ctype_name, numeric_name) == 0 &&
        strcmp(ctype_name, time_name) == 0 &&
        strcmp(ctype_name, collate_name) == 0 &&
        strcmp(ctype_name, monetary_name) == 0 &&
        strcmp(ctype_name, messages_name) == 0) {
      impl->name = ctype_name;
    }
    // else we keep current name.
 
    // reassign impl
    _M_impl = _get_Locale_impl( impl );
  }
  _STLP_UNWIND(delete impl);
}

locale() [4/6]

locale::locale	(	const locale &	,
		const char *	,
		category
	)

locale() [5/6]

locale::locale ( _Locale_impl *  impl )

protected

Definition at line 132 of file locale.cpp.

                                   :
  _M_impl( _get_Locale_impl( impl ) )
{}

locale() [6/6]

locale::locale	(	const locale &	L1,
		const locale &	L2,
		category	c
	)

Definition at line 295 of file locale.cpp.

  : _M_impl(0) {
  _Locale_impl* impl = new _Locale_impl(*L1._M_impl);
 
  _Locale_impl* i2 = L2._M_impl;
 
  if (L1.name() != _Nameless && L2.name() != _Nameless)
    _Stl_loc_combine_names(impl, L1._M_impl->name.c_str(), L2._M_impl->name.c_str(), c);
  else {
    impl->name = _Nameless;
  }
 
  if (c & collate) {
    impl->insert( i2, _STLP_STD::collate<char>::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::collate<wchar_t>::id);
# endif
  }
  if (c & ctype) {
    impl->insert( i2, _STLP_STD::ctype<char>::id);
    impl->insert( i2, _STLP_STD::codecvt<char, char, mbstate_t>::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::ctype<wchar_t>::id);
    impl->insert( i2, _STLP_STD::codecvt<wchar_t, char, mbstate_t>::id);
# endif
  }
  if (c & monetary) {
    impl->insert( i2, _STLP_STD::moneypunct<char, true>::id);
    impl->insert( i2, _STLP_STD::moneypunct<char, false>::id);
    impl->insert( i2, _STLP_STD::money_get<char, istreambuf_iterator<char, char_traits<char> > >::id);
    impl->insert( i2, _STLP_STD::money_put<char, ostreambuf_iterator<char, char_traits<char> > >::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::moneypunct<wchar_t, true>::id);
    impl->insert( i2, _STLP_STD::moneypunct<wchar_t, false>::id);
    impl->insert( i2, _STLP_STD::money_get<wchar_t, istreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
    impl->insert( i2, _STLP_STD::money_put<wchar_t, ostreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
# endif
  }
  if (c & numeric) {
    impl->insert( i2, _STLP_STD::numpunct<char>::id);
    impl->insert( i2, _STLP_STD::num_get<char, istreambuf_iterator<char, char_traits<char> > >::id);
    impl->insert( i2, _STLP_STD::num_put<char, ostreambuf_iterator<char, char_traits<char> > >::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::numpunct<wchar_t>::id);
    impl->insert( i2, _STLP_STD::num_get<wchar_t, istreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
    impl->insert( i2, _STLP_STD::num_put<wchar_t, ostreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
# endif
  }
  if (c & time) {
    impl->insert( i2, _STLP_STD::time_get<char, istreambuf_iterator<char, char_traits<char> > >::id);
    impl->insert( i2, _STLP_STD::time_put<char, ostreambuf_iterator<char, char_traits<char> > >::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::time_get<wchar_t, istreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
    impl->insert( i2, _STLP_STD::time_put<wchar_t, ostreambuf_iterator<wchar_t, char_traits<wchar_t> > >::id);
# endif
  }
  if (c & messages) {
    impl->insert( i2, _STLP_STD::messages<char>::id);
# ifndef _STLP_NO_WCHAR_T
    impl->insert( i2, _STLP_STD::messages<wchar_t>::id);
# endif
  }
  _M_impl = _get_Locale_impl( impl );
}

~locale()

locale::~locale

(

)

Definition at line 361 of file locale.cpp.

                              {
  if (_M_impl)
    _release_Locale_impl(_M_impl);
}

Member Function Documentation

_M_get_facet()

locale::facet * locale::_M_get_facet

(

const id &

n

)

const

Definition at line 377 of file locale.cpp.

                                                         {
  return n._M_index < _M_impl->size() ? _M_impl->facets_vec[n._M_index] : 0;
}

Referenced by _HasFacet().

_M_get_impl()

_Locale_impl * locale::_M_get_impl ( ) const

inlineprotected

Definition at line 204 of file _locale.h.

{ return _M_impl; }

_M_insert()

void locale::_M_insert	(	facet *	__f,
		locale::id &	n
	)

Definition at line 127 of file locale.cpp.

                                            {
  if (f)
    _M_impl->insert(f, _Stl_loc_get_index(n));
}

Referenced by _InsertFacet().

_M_throw_on_combine_error()

void _STLP_CALL locale::_M_throw_on_combine_error ( const string &  name )

static

Definition at line 60 of file locale.cpp.

                                                                    {
  string what = "Unable to find facet";
  what += " in ";
  what += name.empty() ? "system" : name.c_str();
  what += " locale";
  _STLP_THROW(runtime_error(what.c_str()));
}

_M_throw_on_creation_failure()

void _STLP_CALL locale::_M_throw_on_creation_failure ( int  __err_code, const char *  name, const char *  facet  )

static

Definition at line 68 of file locale.cpp.

                                                                                          {
  string what;
  switch (__err_code) {
    case _STLP_LOC_UNSUPPORTED_FACET_CATEGORY:
      what = "No platform localization support for ";
      what += facet;
      what += " facet category, unable to create facet for ";
      what += name[0] == 0 ? "system" : name;
      what += " locale";
      break;
    case _STLP_LOC_NO_PLATFORM_SUPPORT:
      what = "No platform localization support, unable to create ";
      what += name[0] == 0 ? "system" : name;
      what += " locale";
      break;
    default:
    case _STLP_LOC_UNKNOWN_NAME:
      what = "Unable to create facet ";
      what += facet;
      what += " from name '";
      what += name;
      what += "'";
      break;
    case _STLP_LOC_NO_MEMORY:
      _STLP_THROW_BAD_ALLOC;
      break;
  }
 
  _STLP_THROW(runtime_error(what.c_str()));
}

Referenced by _Messages::_Messages(), codecvt_byname< wchar_t, char, mbstate_t >::codecvt_byname(), collate_byname< char >::collate_byname(), collate_byname< wchar_t >::collate_byname(), ctype_byname< char >::ctype_byname(), ctype_byname< wchar_t >::ctype_byname(), _Locale_impl::insert_ctype_facets(), _Locale_impl::insert_numeric_facets(), moneypunct_byname< char, true >::moneypunct_byname(), moneypunct_byname< char, false >::moneypunct_byname(), moneypunct_byname< wchar_t, true >::moneypunct_byname(), moneypunct_byname< wchar_t, false >::moneypunct_byname(), numpunct_byname< char >::numpunct_byname(), numpunct_byname< wchar_t >::numpunct_byname(), time_init< char >::time_init(), and time_init< wchar_t >::time_init().

_M_throw_on_null_name()

void _STLP_CALL locale::_M_throw_on_null_name ( )

static

Definition at line 57 of file locale.cpp.

{ _STLP_THROW(runtime_error("Invalid null locale name")); }

Referenced by _Messages::_Messages(), codecvt_byname< char, char, mbstate_t >::codecvt_byname(), codecvt_byname< wchar_t, char, mbstate_t >::codecvt_byname(), collate_byname< char >::collate_byname(), collate_byname< wchar_t >::collate_byname(), ctype_byname< char >::ctype_byname(), ctype_byname< wchar_t >::ctype_byname(), locale(), moneypunct_byname< char, true >::moneypunct_byname(), moneypunct_byname< char, false >::moneypunct_byname(), moneypunct_byname< wchar_t, true >::moneypunct_byname(), moneypunct_byname< wchar_t, false >::moneypunct_byname(), numpunct_byname< char >::numpunct_byname(), numpunct_byname< wchar_t >::numpunct_byname(), time_init< char >::time_init(), and time_init< wchar_t >::time_init().

_M_use_facet()

locale::facet * locale::_M_use_facet

(

const id &

n

)

const

Definition at line 381 of file locale.cpp.

                                                         {
  locale::facet* f = (n._M_index < _M_impl->size() ? _M_impl->facets_vec[n._M_index] : 0);
  if (!f)
    _M_impl->_M_throw_bad_cast();
  return f;
}

Referenced by _UseFacet().

_STLP_STATIC_CONSTANT() [1/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		all	= collate|ctype|monetary|numeric|time|messages
	)

_STLP_STATIC_CONSTANT() [2/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		collate	= 0x010
	)

_STLP_STATIC_CONSTANT() [3/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		ctype	= 0x020
	)

_STLP_STATIC_CONSTANT() [4/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		messages	= 0x400
	)

_STLP_STATIC_CONSTANT() [5/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		monetary	= 0x040
	)

_STLP_STATIC_CONSTANT() [6/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		none	= 0x000
	)

_STLP_STATIC_CONSTANT() [7/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		numeric	= 0x100
	)

_STLP_STATIC_CONSTANT() [8/8]

locale::_STLP_STATIC_CONSTANT	(	category	,
		time	= 0x200
	)

classic()

const locale &_STLP_CALL locale::classic ( )

static

Definition at line 404 of file locale.cpp.

                                         {
  return *_Stl_get_classic_locale();
}

Referenced by LocaleTest::_locale_init_problem(), LocaleTest::collate_by_name(), LocaleTest::collate_facet(), LocaleTest::combine(), LocaleTest::ctype_by_name(), FstreamTest::custom_facet(), _Locale_impl::insert_collate_facets(), _Locale_impl::insert_ctype_facets(), _Locale_impl::insert_messages_facets(), _Locale_impl::insert_monetary_facets(), _Locale_impl::insert_numeric_facets(), _Locale_impl::insert_time_facets(), locale(), _Catalog_locale_map::lookup(), LocaleTest::messages_by_name(), LocaleTest::moneypunct_by_name(), LocaleTest::numpunct_by_name(), FstreamTest::seek(), CodecvtTest::special_encodings(), test_supported_locale(), LocaleTest::time_by_name(), and CodecvtTest::variable_encoding().

global()

locale _STLP_CALL locale::global ( const locale &  L )

static

Definition at line 409 of file locale.cpp.

                                                {
#else
_Locale_impl* _STLP_CALL locale::global(const locale& L) {
#endif
  locale old(_Stl_get_global_locale()->_M_impl);
  if (_Stl_get_global_locale()->_M_impl != L._M_impl) {
    _release_Locale_impl(_Stl_get_global_locale()->_M_impl);
    // this assign should be atomic, should be fixed here:
    _Stl_get_global_locale()->_M_impl = _get_Locale_impl(L._M_impl);
 
    // Set the global C locale, if appropriate.
#if !defined(_STLP_NO_LOCALE_SUPPORT)
    if (L.name() != _Nameless)
      setlocale(LC_ALL, L.name().c_str());
#endif
  }
 
#if !defined (_STLP_USE_MSVC6_MEM_T_BUG_WORKAROUND)
  return old;
#else
  return old._M_impl;
#endif
}

Referenced by LocaleTest::_locale_init_problem(), global(), and main().

name()

string locale::name

(

)

const

Definition at line 388 of file locale.cpp.

                          {
  return _M_impl->name;
}

Referenced by _M_throw_on_creation_failure(), LocaleTest::combine(), locale(), main(), operator==(), and test_supported_locale().

operator!=()

bool locale::operator!=

(

const locale &

L

)

const

Definition at line 398 of file locale.cpp.

                                             {
  return !(*this == L);
}

operator()() [1/2]

bool locale::operator()	(	const string &	__x,
		const string &	__y
	)		const

Definition at line 46 of file locale.cpp.

{ return __locale_do_operator_call(*this, __x, __y); }

operator()() [2/2]

bool locale::operator()	(	const wstring &	__x,
		const wstring &	__y
	)		const

Definition at line 51 of file locale.cpp.

{ return __locale_do_operator_call(*this, __x, __y); }

operator=()

const locale & locale::operator=

(

const locale &

L

)

Definition at line 368 of file locale.cpp.

                                                             {
  if (this->_M_impl != L._M_impl) {
    if (this->_M_impl)
      _release_Locale_impl(this->_M_impl);
    this->_M_impl = _get_Locale_impl(L._M_impl);
  }
  return *this;
}

operator==()

bool locale::operator==

(

const locale &

L

)

const

Definition at line 393 of file locale.cpp.

                                             {
  return this->_M_impl == L._M_impl ||
         (this->name() == L.name() && this->name() != _Nameless);
}

Friends And Related Function Documentation

_Locale_impl

friend class _Locale_impl

friend

Definition at line 200 of file _locale.h.

Referenced by locale().

Member Data Documentation

_M_impl

_Locale_impl* locale::_M_impl

protected

Definition at line 203 of file _locale.h.

Referenced by _M_get_facet(), _M_insert(), _M_use_facet(), global(), _Locale_impl::insert_collate_facets(), _Locale_impl::insert_ctype_facets(), _Locale_impl::insert_messages_facets(), _Locale_impl::insert_monetary_facets(), _Locale_impl::insert_numeric_facets(), _Locale_impl::insert_time_facets(), locale(), name(), _Locale_impl::operator!=(), operator==(), and ~locale().

---

The documentation for this class was generated from the following files:

• sdk/include/c++/stlport/stl/_locale.h
• sdk/lib/3rdparty/stlport/src/locale.cpp