codecvt-byname-class.md

description	title	ms.date	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: codecvt_byname class	codecvt_byname class	06/29/2022	xlocale/std::codecvt_byname	codecvt_byname class	b63b6c04-f60c-47b9-8e30-a933f24a8ffb

codecvt_byname class

A derived class template that describes an object that can serve as a collate facet of a given locale, enabling the retrieval of information specific to a cultural area concerning conversions.

Syntax

template <class CharType, class Byte, class StateType>
class codecvt_byname: public codecvt<CharType, Byte, StateType> {
public:
    explicit codecvt_byname(
    const char* locale_name,
    size_t ref_count = 0);

explicit codecvt_byname(
    const string& locale_name,
    size_t ref_count = 0);

protected:
    virtual ~codecvt_byname();

};

Parameters

locale_name
A named locale.

ref_count
An initial reference count.

Remarks

byname facets are automatically created when a named locale is constructed.

Its behavior is determined by the named locale locale_name. Each constructor initializes its base object by using codecvt<CharType, Byte, StateType>( ref_count ). For more information, see codecvt.

Requirements

Header: <locale>

Namespace: std

See also

Thread Safety in the C++ Standard Library