locale Class Reference

Inheritance diagram for locale:

Classes
class	_Locimp
class	facet
class	id

Public Types
typedef int	category

Public Member Functions
template<class _Elem , class _Traits , class _Alloc >
bool	operator() (const basic_string< _Elem, _Traits, _Alloc > &_Left, const basic_string< _Elem, _Traits, _Alloc > &_Right) const
template<class _Facet >
locale	combine (const locale &_Loc) const
template<class _Facet >
	locale (const locale &_Loc, const _Facet *_Facptr)
	locale (_Uninitialized)
	locale (const locale &_Right) _THROW0()
	locale () _THROW0()
	locale (const locale &_Loc, const locale &_Other, category _Cat)
	locale (const char *_Locname, category _Cat=all)
	locale (const locale &_Loc, const char *_Locname, category _Cat)
	locale (const string &_Str, category _Cat=all)
	locale (const locale &_Loc, const string &_Str, category _Cat)
	~locale () _NOEXCEPT
locale &	operator= (const locale &_Right) _THROW0()
string	name () const
_Ret_z_ const char *	c_str () const
const facet *	_Getfacet (size_t _Id) const
bool	operator== (const locale &_Loc) const
bool	operator!= (const locale &_Right) const

Static Public Member Functions
static _MRTIMP2_PURE const locale &__CLRCALL_PURE_OR_CDECL	classic ()
static _MRTIMP2_PURE locale __CLRCALL_PURE_OR_CDECL	global (const locale &)
static _MRTIMP2_PURE locale __CLRCALL_PURE_OR_CDECL	empty ()

Private Member Functions
void	_Construct (const string &_Str, category _Cat)
	locale (_Locimp *_Ptrimp)
bool	_Badname (const _Locinfo &_Lobj)

Static Private Member Functions
static _MRTIMP2_PURE _Locimp *__CLRCALL_PURE_OR_CDECL	_Init (bool _Do_incref=false)
static _MRTIMP2_PURE _Locimp *__CLRCALL_PURE_OR_CDECL	_Getgloballocale ()
static _MRTIMP2_PURE void __CLRCALL_PURE_OR_CDECL	_Setgloballocale (void *)

Private Attributes
_Locimp *	_Ptr

Additional Inherited Members
Static Public Attributes inherited from _Locbase< int >
static _PGLOBAL const int	collate
static _PGLOBAL const int	ctype
static _PGLOBAL const int	monetary
static _PGLOBAL const int	numeric
static _PGLOBAL const int	time
static _PGLOBAL const int	messages
static _PGLOBAL const int	all
static _PGLOBAL const int	none

Member Typedef Documentation

typedef int locale::category

Constructor & Destructor Documentation

template<class _Facet >

locale::locale ( const locale &  _Loc, const _Facet *  _Facptr  )

inline

            : _Ptr(_Locimp::_New_Locimp(*_Loc._Ptr))
        {   // construct from _Loc, replacing facet with *_Facptr
        if (_Facptr != 0)
            {   // replace facet
            _Ptr->_Addfac((_Facet *)_Facptr, _Facet::id);
            _Ptr->_Catmask = none;
            _Ptr->_Name = "*";
            }
        }

locale::locale ( _Uninitialized  )

inline

        {   // defer construction
        }

locale::locale ( const locale &  _Right )

inline

        : _Ptr(_Right._Ptr)
        {   // construct by copying
        _Ptr->_Incref();
        }

locale::locale ( )

inline

        : _Ptr(_Init(true))
        {   // construct from current locale
        }

locale::locale ( const locale &  _Loc, const locale &  _Other, category  _Cat  )

inline

        : _Ptr(_Locimp::_New_Locimp(*_Loc._Ptr))
        {   // construct a locale by copying named facets
        if (_Cat != none)
            {   // worth adding, do it
            _TRY_BEGIN
                _BEGIN_LOCINFO(_Lobj)
                    _Locimp::_Makeloc(_Lobj, _Cat, _Ptr, &_Other);
                    _Lobj._Addcats(_Loc._Ptr->_Catmask,
                        _Loc.name().c_str());
                    _Lobj._Addcats(_Other._Ptr->_Catmask,
                        _Other.name().c_str());
                    _Ptr->_Catmask = _Loc._Ptr->_Catmask
                        | _Other._Ptr->_Catmask;
                    _Ptr->_Name = _Lobj._Getname();
                _END_LOCINFO()
            _CATCH_ALL
            delete _Ptr->_Decref();
            _RERAISE;
            _CATCH_END
            }
        }

locale::locale ( const char *  _Locname, category  _Cat = all  )

inlineexplicit

        : _Ptr(_Locimp::_New_Locimp())
        {   // construct a locale with named facets
        // _Locname might have been returned from setlocale().
        // Therefore, _Construct() takes const string&.
        if (_Locname == 0)
            _Xruntime_error("bad locale name");
        _Construct(_Locname, _Cat);
        }

locale::locale ( const locale &  _Loc, const char *  _Locname, category  _Cat  )

inline

        : _Ptr(_Locimp::_New_Locimp(*_Loc._Ptr))
        {   // construct a locale by copying, replacing named facets
        // _Locname might have been returned from setlocale().
        // Therefore, _Construct() takes const string&.
        if (_Locname == 0)
            _Xruntime_error("bad locale name");
        _Construct(_Locname, _Cat);
        }

locale::locale ( const string &  _Str, category  _Cat = all  )

inlineexplicit

        : _Ptr(_Locimp::_New_Locimp())
        {   // construct a locale with named facets
        _Construct(_Str, _Cat);
        }

locale::locale ( const locale &  _Loc, const string &  _Str, category  _Cat  )

inline

        : _Ptr(_Locimp::_New_Locimp(*_Loc._Ptr))
        {   // construct a locale by copying, replacing named facets
        _Construct(_Str, _Cat);
        }

locale::~locale ( )

inline

        {   // destroy the object
        if (_Ptr != 0)
            delete _Ptr->_Decref();
        }

locale::locale ( _Locimp *  _Ptrimp )

inlineprivate

        : _Ptr(_Ptrimp)
        {   // construct from _Locimp pointer
        }

Member Function Documentation

bool locale::_Badname ( const _Locinfo &  _Lobj )

inlineprivate

        {   // test if name is "*"
        return (_CSTD strcmp(_Lobj._Getname(), "*") == 0);
        }

void locale::_Construct ( const string &  _Str, category  _Cat  )

inlineprivate

        {   // construct a locale with named facets
        bool _Bad = false;
        _Init();
        if (_Cat != none)
            {   // worth adding, do it
            _TRY_BEGIN
                _BEGIN_LOCINFO(_Lobj(_Cat, _Str.c_str()))
                    if (_Badname(_Lobj))
                        _Bad = true;
                    else
                        {   // name okay, build the locale
                        _Locimp::_Makeloc(_Lobj, _Cat, _Ptr, 0);
                        _Ptr->_Catmask = _Cat;
                        _Ptr->_Name = _Str.c_str();
                        }
                _END_LOCINFO()
            _CATCH_ALL
            delete _Ptr->_Decref();
            _RERAISE;
            _CATCH_END
            }

        if (_Bad)
            {   // Don't throw within _BEGIN_LOCINFO if we can avoid it
            delete _Ptr->_Decref();
            _Xruntime_error("bad locale name");
            }
        }

const facet* locale::_Getfacet ( size_t  _Id ) const

inline

        {   // look up a facet in locale object
        const facet *_Facptr = _Id < _Ptr->_Facetcount
            ? _Ptr->_Facetvec[_Id] : 0; // null if id off end
        if (_Facptr != 0 || !_Ptr->_Xparent)
            return (_Facptr);   // found facet or not transparent
        else
            {   // look in current locale
            locale::_Locimp *_Ptr0 = _Getgloballocale();
            return (_Id < _Ptr0->_Facetcount
                ? _Ptr0->_Facetvec[_Id] // get from current locale
                : 0);   // no entry in current locale
            }
        }

static _MRTIMP2_PURE _Locimp* __CLRCALL_PURE_OR_CDECL locale::_Getgloballocale ( )

staticprivate

static _MRTIMP2_PURE _Locimp* __CLRCALL_PURE_OR_CDECL locale::_Init ( bool  _Do_incref = false )

staticprivate

static _MRTIMP2_PURE void __CLRCALL_PURE_OR_CDECL locale::_Setgloballocale ( void *  )

staticprivate

_Ret_z_ const char* locale::c_str ( ) const

inline

        {   // return locale name as NTBS
        return (_Ptr == 0 ? "" : _Ptr->_Name.c_str());
        }

static _MRTIMP2_PURE const locale& __CLRCALL_PURE_OR_CDECL locale::classic ( )

static

template<class _Facet >

locale locale::combine ( const locale &  _Loc ) const

inline

        {   // combine two locales
        _Facet *_Facptr;

        _TRY_BEGIN
            _Facptr = (_Facet *)&use_facet<_Facet>(_Loc);
        _CATCH_ALL
            _Xruntime_error("locale::combine facet missing");
        _CATCH_END

        _Locimp *_Newimp = _Locimp::_New_Locimp(*_Ptr);
        _Newimp->_Addfac(_Facptr, _Facet::id);
        _Newimp->_Catmask = none;
        _Newimp->_Name = "*";
        return (locale(_Newimp));
        }

static _MRTIMP2_PURE locale __CLRCALL_PURE_OR_CDECL locale::empty ( )

static

static _MRTIMP2_PURE locale __CLRCALL_PURE_OR_CDECL locale::global ( const locale &  )

static

string locale::name ( ) const

inline

        {   // return locale name
        return (_Ptr == 0 ? string() : _Ptr->_Name.c_str());
        }

bool locale::operator!= ( const locale &  _Right ) const

inline

        {   // test for locale inequality
        return (!(*this == _Right));
        }

template<class _Elem , class _Traits , class _Alloc >

bool locale::operator() ( const basic_string< _Elem, _Traits, _Alloc > &  _Left, const basic_string< _Elem, _Traits, _Alloc > &  _Right  ) const

inline

        {   // compare _Left and _Right strings using collate facet in locale
        const _STD collate<_Elem>& _Coll_fac =
            use_facet< _STD collate<_Elem> >(*this);

        return (_Coll_fac.compare(_Left.c_str(), _Left.c_str() + _Left.size(),
            _Right.c_str(), _Right.c_str() + _Right.size()) < 0);
        }

locale& locale::operator= ( const locale &  _Right )

inline

        {   // assign a locale
        if (_Ptr != _Right._Ptr)
            {   // different implementation, point at new one
            delete _Ptr->_Decref();
            _Ptr = _Right._Ptr;
            _Ptr->_Incref();
            }
        return (*this);
        }

bool locale::operator== ( const locale &  _Loc ) const

inline

        {   // compare locales for equality
        return (_Ptr == _Loc._Ptr
            || (name().compare("*") != 0
                && name().compare(_Loc.name()) == 0));
        }

Member Data Documentation

_Locimp* locale::_Ptr

private

---

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

• VS2017/inc/xlocale