Archivo de encabezado de la biblioteca estándar <locale>
De cppreference.com
Este archivo de encabezado es parte de la biblioteca de procesamiento de texto.
Clases | |
| Conjunto de facetas polimórficas que encapsulan las diferencias culturales. (clase) | |
Conversiones de cadenas y de flujos | |
(C++11)(en desuso en C++17) |
Realiza conversiones entre una cadena ancha y una cadena de bytes. (plantilla de clase) |
(C++11)(en desuso en C++17) |
Realiza la conversión entre un búfer de un flujo de bytes y un búfer de flujo ancho. (plantilla de clase) |
Clases base de categoría de faceta | |
| Define las categorías de clasificación de caracteres. (clase) | |
| Define los errores de conversión de caracteres. (clase) | |
| Define el tipo del catálogo de mensajes. (clase) | |
| Define las constantes de formato de fecha. (clase) | |
| Define los patrones de formato monetario. (clase) | |
Categorías de faceta | |
| Define las tablas de clasificación de caracteres. (plantilla de clase) | |
Especialización de std::ctype para el tipo char. (especialización de plantilla de clase) | |
| Convierte entre codificaciones de caracteres, incluyendo UTF-8, UTF-16, UTF-32. (plantilla de clase) | |
| Define la comparación lexicográfica y hashing (resumen) de cadenas. (plantilla de clase) | |
| Implementa la recuperación de cadenas de los catálogos de mensajes. (plantilla de clase) | |
Analiza valores de hora y fecha a partir de una secuencia de caracteres y los deposita en struct std::tm. (plantilla de clase) | |
Formatea el contenido de struct std::tm para salida como una secuencia de caracteres. (plantilla de clase) | |
| Analiza valores numéricos a partir de una secuencia de caracteres de entrada. (plantilla de clase) | |
| Formatea valores numéricos para salida como una secuencia de caracteres. (plantilla de clase) | |
| Define las reglas numéricas de puntuación. (plantilla de clase) | |
| Analiza y construye un valor monetario a partir de una secuencia de caracteres de entrada. (plantilla de clase) | |
| Formatos de un valor monetario para la salida como una secuencia de caracteres. (plantilla de clase) | |
| Define los parámetros de formato monetario utilizados por std::money_get y std::money_put. (plantilla de clase) | |
Categorías de faceta específicas de la configuración regional | |
| Representa a std::ctype suministrado por el sistema para la configuración regional nombrada. (plantilla de clase) | |
| Representa a std::codecvt suministrado por el sistema para la configuración local nombrada. (plantilla de clase) | |
| Representa a los mensajes (std::messages) suministrados por el sistema para la localidad nombrada. (plantilla de clase) | |
| Representa a std::collate suministrado por el sistema para la configuración regional nombrada. (plantilla de clase) | |
| Representa a std::time_get suministrado por el sistema para la configuración regional nombrada. (plantilla de clase) | |
| Representa a std::time_put suministrado por el sistema para la configuración regional nombrada. (plantilla de clase) | |
| Representa a la puntuación numérica (std::numpunct) suministrada por el sistema para la configuración regional nombrada. (plantilla de clase) | |
| Representa a la puntuación monetaria (std::moneypunct) suministrada por el sistema para la configuración regional nombrada. (plantilla de clase) | |
Funciones | |
Configuraciónes regionales y facetas | |
| Obtiene una faceta de una configuración regional. (plantilla de función) | |
| Comprueba si una configuración regional implementa una faceta específica. (plantilla de función) | |
Clasificación de caracteres | |
| Comprueba si un carácter se clasifica como un espacio en blanco por una configuración regional. (plantilla de función) | |
(C++11) |
Comprueba si un carácter está clasificado como un carácter en blanco por una configuración regional. (plantilla de función) |
| Comprueba si un carácter está clasificado como un carácter de control por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como una letra mayúscula por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como una letra minúscula por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como alfabético por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como un dígito por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como signo de puntuación por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como un dígito hexadecimal por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como alfanumérico por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como imprimible por una configuración regional. (plantilla de función) | |
| Comprueba si un carácter está clasificado como gráfico por una configuración regional. (plantilla de función) | |
Conversiones de caracteres | |
Convierte un carácter a mayúscula usando la faceta ctype de una configuración regional. (plantilla de función) | |
Convierte un carácter a minúscula usando la faceta ctype de una configuración regional. (plantilla de función) | |
Sinopsis
namespace std {
// configuración regional:
class locale;
template <class Facet> const Facet& use_facet(const locale&);
template <class Facet> bool has_facet(const locale&) noexcept;
// interfaces de conveniencia:
template <class CharT> bool isspace (CharT c, const locale& loc);
template <class CharT> bool isprint (CharT c, const locale& loc);
template <class CharT> bool iscntrl (CharT c, const locale& loc);
template <class CharT> bool isupper (CharT c, const locale& loc);
template <class CharT> bool islower (CharT c, const locale& loc);
template <class CharT> bool isalpha (CharT c, const locale& loc);
template <class CharT> bool isdigit (CharT c, const locale& loc);
template <class CharT> bool ispunct (CharT c, const locale& loc);
template <class CharT> bool isxdigit(CharT c, const locale& loc);
template <class CharT> bool isalnum (CharT c, const locale& loc);
template <class CharT> bool isgraph (CharT c, const locale& loc);
template <class CharT> CharT toupper(CharT c, const locale& loc);
template <class CharT> CharT tolower(CharT c, const locale& loc);
template <class Codecvt, class Elem = wchar_t,
class Wide_alloc = std::allocator<Elem>,
class Byte_alloc = std::allocator<char>> class wstring_convert;
template <class Codecvt, class Elem = wchar_t,
class Tr = char_traits<Elem>> class wbuffer_convert;
// ctype:
class ctype_base;
template <class CharT> class ctype;
template <> class ctype<char>; // especialización
template <class CharT> class ctype_byname;
class codecvt_base;
template <class internT, class externT, class stateT> class codecvt;
template <class internT, class externT, class stateT> class codecvt_byname;
// numérica:
template <class CharT, class InputIter = istreambuf_iterator<CharT>> class num_get;
template <class CharT, class OutputIter = osterambuf_iterator<CharT>> class num_put;
template <class CharT> class numpunct;
template <class CharT> class numpunct_byname;
// de intercalación:
template <class CharT> class collate;
template <class CharT> class collate_byname;
// fecha y hora:
class time_base;
template <class CharT, class InputIter = istreambuf_iterator<CharT>>
class time_get;
template <class CharT, class InputIter> = istreambuf_iterator<CharT>>
class time_get_byname;
template <class CharT, class OutputIter> = ostreambuf_iterator<CharT>>
class time_put;
template <class CharT, class OutputIter> = ostreambuf_iterator<CharT>>
class time_put_byname;
// dinero:
class money_base;
template <class CharT, class InputIter = istreambuf_iterator<CharT>> >
class money_get;
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>> >
class money_put;
template <class CharT, bool Intl = false> class moneypunct;
template <class CharT, bool Intl = false> class moneypunct_byname;
// recuperación de mensajes:
class messages_base;
template <class CharT> class messages;
template <class CharT> class messages_byname;
}
Clase std::locale
class locale
{
public:
// tipos:
class facet;
class id;
typedef int category;
static const category // Los valores asignados aquí son sólo para exposición.
none = 0,
collate = 0x010,
ctype = 0x020,
monetary = 0x040,
numeric = 0x080,
time = 0x100,
messages = 0x200,
all = collate | ctype | monetary | numeric | time | messages;
// construir/copiar/destruir:
locale() noexcept;
locale(const locale& other) noexcept;
explicit locale(const char* std_name);
explicit locale(const string& std_name);
locale(const locale& other, const char* std_name, category);
locale(const locale& other, const string& std_name, category);
template <class Facet> locale(const locale& other, Facet* f);
locale(const locale& other, const locale& one, category);
~locale();
// no virtual
const locale& operator=(const locale& other) noexcept;
template <class Facet> locale combine(const locale& other) const;
// operaciones de configuración regional:
basic_string<char>
name() const;
bool operator==(const locale& other) const;
bool operator!=(const locale& other) const;
template <class CharT, class Traits, class Allocator>
bool operator()(const basic_string<CharT,Traits,Allocator>& s1,
const basic_string<CharT,Traits,Allocator>& s2) const;
// objetos globales de configuración regional:
static
locale global(const locale&);
static const locale& classic();
};
Clase std::ctype_base
class ctype_base
{
public:
typedef /*tipo-máscara-de-bits*/ mask;
// los valores numéricos son sólo para exposición.
static const mask space = 1 << 0;
static const mask print = 1 << 1;
static const mask cntrl = 1 << 2;
static const mask upper = 1 << 3;
static const mask lower = 1 << 4;
static const mask alpha = 1 << 5;
static const mask digit = 1 << 6;
static const mask punct = 1 << 7;
static const mask xdigit= 1 << 8;
static const mask blank = 1 << 9;
static const mask alnum = alpha | digit;
static const mask graph = alnum | punct;
};
Clase std::ctype
template <class CharT>
class ctype : public locale::facet, public ctype_base
{
public:
typedef CharT char_type;
explicit ctype(size_t refs = 0);
bool is(mask m, CharT c) const;
const CharT* is(const CharT* low, const CharT* high, mask* vec) const;
const CharT* scan_is(mask m,
const CharT* low, const CharT* high) const;
const CharT* scan_not(mask m,
const CharT* low, const CharT* high) const;
CharT toupper(CharT c) const;
const CharT* toupper(CharT* low, const CharT* high) const;
CharT tolower(CharT c) const;
const CharT* tolower(CharT* low, const CharT* high) const;
CharT widen(char c) const;
const char* widen(const char* low, const char* high, CharT* to) const;
char narrow(CharT c, char dfault) const;
const CharT* narrow(const CharT* low, const CharT*, char dfault,
char* to) const;
static locale::id id;
protected:
~ctype();
virtual bool do_is(mask m, CharT c) const;
virtual const CharT* do_is(const CharT* low, const CharT* high,
mask* vec) const;
virtual const CharT* do_scan_is(mask m,
const CharT* low, const CharT* high) const;
virtual const CharT* do_scan_not(mask m,
const CharT* low, const CharT* high) const;
virtual CharT do_toupper(CharT) const;
virtual const CharT* do_toupper(CharT* low, const CharT* high) const;
virtual CharT do_tolower(CharT) const;
virtual const CharT* do_tolower(CharT* low, const CharT* high) const;
virtual CharT do_widen(char) const;
virtual const char* do_widen(const char* low, const char* high,
CharT* dest) const;
virtual char do_narrow(CharT, char dfault) const;
virtual const CharT* do_narrow(const CharT* low, const CharT* high,
char dfault, char* dest) const;
};
Clase std::ctype_byname
template <class CharT>
class ctype_byname : public ctype<CharT>
{
public:
typedef typename ctype<CharT>::mask mask;
explicit ctype_byname(const char*, size_t refs = 0);
explicit ctype_byname(const string&, size_t refs = 0);
protected:
~ctype_byname();
};
Clase std::ctype<char>
template <> class ctype<char>
: public locale::facet, public ctype_base
{
public:
typedef char char_type;
explicit ctype(const mask* tab = 0, bool del = false,
size_t refs = 0);
bool is(mask m, char c) const;
const char* is(const char* low, const char* high, mask* vec) const;
const char* scan_is (mask m,
const char* low, const char* high) const;
const char* scan_not(mask m,
const char* low, const char* high) const;
char toupper(char c) const;
const char* toupper(char* low, const char* high) const;
char tolower(char c) const;
const char* tolower(char* low, const char* high) const;
char widen(char c) const;
const char* widen(const char* low, const char* high, char* to) const;
char narrow(char c, char dfault) const;
const char* narrow(const char* low, const char* high, char dfault,
char* to) const;
static locale::id id;
static const size_t table_size = /* definido por la implementación */;
const mask* table() const noexcept;
static const mask* classic_table() noexcept;
protected:
~ctype();
virtual char do_toupper(char c) const;
virtual const char* do_toupper(char* low, const char* high) const;
virtual char do_tolower(char c) const;
virtual const char* do_tolower(char* low, const char* high) const;
virtual char do_widen(char c) const;
virtual const char* do_widen(const char* low,
const char* high,
char* to) const;
virtual char do_narrow(char c, char dfault) const;
virtual const char* do_narrow(const char* low,
const char* high,
char dfault, char* to) const;
};
Clase std::codecvt_base
class codecvt_base
{
public:
enum result { ok, partial, error, noconv };
};
Clase std::codecvt
template <class internT, class externT, class stateT>
class codecvt : public locale::facet, public codecvt_base
{
public:
typedef internT intern_type;
typedef externT extern_type;
typedef stateT state_type;
explicit codecvt(size_t refs = 0);
result out(stateT& state,
const internT* from, const internT* from_end,
const internT*& from_next,
externT* to, externT* to_end, externT*& to_next) const;
result unshift(stateT& state, externT* to,
externT* to_end, externT*& to_next) const;
result in(stateT& state,
const externT* from, const externT* from_end,
const externT*& from_next,
internT* to,
internT* to_end, internT*& to_next) const;
int encoding() const noexcept;
bool always_noconv() const noexcept;
int length(stateT&, const externT* from, const externT* end,
size_t max) const;
int max_length() const noexcept;
static locale::id id;
protected:
~codecvt();
virtual result do_out(stateT& state,
const internT* from, const internT* from_end,
const internT*& from_next,
externT* to,
externT* to_end, externT*& to_next) const;
virtual result do_in(stateT& state,
const externT* from, const externT* from_end,
const externT*& from_next,
internT* to,
internT* to_end, internT*& to_next) const;
virtual result do_unshift(stateT& state,
externT* to,
externT* to_end, externT*& to_next) const;
virtual int do_encoding() const noexcept;
virtual bool do_always_noconv() const noexcept;
virtual int do_length(stateT&, const externT* from,
const externT* end, size_t max) const;
virtual int do_max_length() const noexcept;
};
Clase std::codecvt_byname
template <class internT, class externT, class stateT>
class codecvt_byname : public codecvt<internT, externT, stateT>
{
public:
explicit codecvt_byname(const char*, size_t refs = 0);
explicit codecvt_byname(const string&, size_t refs = 0);
protected:
~codecvt_byname();
};
Clase std::num_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>>
class num_get : public locale::facet
{
public:
typedef CharT char_type;
typedef InputIter iter_type;
explicit num_get(size_t refs = 0);
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, bool& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, long& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, long long& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, unsigned short& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, unsigned int& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, unsigned long& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, unsigned long long& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, float& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, double& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, long double& v) const;
iter_type get(iter_type in, iter_type end, ios_base&,
ios_base::iostate& err, void*& v) const;
static locale::id id;
protected:
~num_get();
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, bool& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, long& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, long long& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, unsigned short& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, unsigned int& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, unsigned long& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, unsigned long long& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, float& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, double& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, long double& v) const;
virtual iter_type do_get(iter_type, iter_type, ios_base&,
ios_base::iostate& err, void*& v) const;
};
Clase std::num_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>>
class num_put : public locale::facet
{
public:
typedef CharT char_type;
typedef OutputIter iter_type;
explicit num_put(size_t refs = 0);
iter_type put(iter_type s, ios_base& f, char_type fill,
bool v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
long v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
long long v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
unsigned long v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
unsigned long long v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
double v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
long double v) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
const void* v) const;
static locale::id id;
protected:
~num_put();
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
bool v) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
long v) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
long long v) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
unsigned long) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
unsigned long long) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
double v) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
long double v) const;
virtual iter_type do_put(iter_type, ios_base&, char_type fill,
const void* v) const;
};
Clase std::numpunct
template <class CharT>
class numpunct : public locale::facet
{
public:
typedef CharT char_type;
typedef basic_string<CharT> string_type;
explicit numpunct(size_t refs = 0);
char_type decimal_point() const;
char_type thousands_sep() const;
string grouping() const;
string_type truename() const;
string_type falsename() const;
static locale::id id;
protected:
~numpunct(); // virtual
virtual char_type do_decimal_point() const;
virtual char_type do_thousands_sep() const;
virtual string do_grouping() const;
virtual string_type do_truename() const; // para bool
virtual string_type do_falsename() const; // para bool
};
Clase std::numpunct_byname
template <class CharT>
class numpunct_byname : public numpunct<CharT>
{
public:
typedef CharT char_type;
typedef basic_string<CharT> string_type;
explicit numpunct_byname(const char*, size_t refs = 0);
explicit numpunct_byname(const string&, size_t refs = 0);
protected:
~numpunct_byname();
};
Clase std::collate
template <class CharT>
class collate : public locale::facet
{
public:
typedef CharT char_type;
typedef basic_string<CharT> string_type;
explicit collate(size_t refs = 0);
int compare(const CharT* low1, const CharT* high1,
const CharT* low2, const CharT* high2) const;
string_type transform(const CharT* low, const CharT* high) const;
long hash(const CharT* low, const CharT* high) const;
static locale::id id;
protected:
~collate();
virtual int do_compare(const CharT* low1, const CharT* high1,
const CharT* low2, const CharT* high2) const;
virtual string_type do_transform(const CharT* low,
const CharT* high) const;
virtual long do_hash (const CharT* low, const CharT* high) const;
};
Clase std::collate_byname
template <class CharT>
class collate_byname : public collate<CharT>
{
public:
typedef basic_string<CharT> string_type;
explicit collate_byname(const char*, size_t refs = 0);
explicit collate_byname(const string&, size_t refs = 0);
protected:
~collate_byname();
};
Clase std::time_base
class time_base
{
public:
enum dateorder { no_order, dmy, mdy, ymd, ydm };
};
Clase std::time_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>>
class time_get : public locale::facet, public time_base
{
public:
typedef CharT char_type;
typedef InputIter iter_type;
explicit time_get(size_t refs = 0);
dateorder date_order() const;
iter_type get_time(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t) const;
iter_type get_date(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t) const;
iter_type get_weekday(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t) const;
iter_type get_monthname(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t) const;
iter_type get_year(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t) const;
iter_type get(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t, char format,
char modifier = 0) const;
iter_type get(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t,
const char_type* fmt, const char_type* fmtend) const;
static locale::id id;
protected:
~time_get();
virtual dateorder do_date_order() const;
virtual iter_type do_get_time(iter_type s, iter_type end, ios_base&,
ios_base::iostate& err, tm* t) const;
virtual iter_type do_get_date(iter_type s, iter_type end, ios_base&,
ios_base::iostate& err, tm* t) const;
virtual iter_type do_get_weekday(iter_type s, iter_type end, ios_base&,
ios_base::iostate& err, tm* t) const;
virtual iter_type do_get_monthname(iter_type s, iter_type end, ios_base&,
ios_base::iostate& err, tm* t) const;
virtual iter_type do_get_year(iter_type s, iter_type end, ios_base&,
ios_base::iostate& err, tm* t) const;
virtual iter_type do_get(iter_type s, iter_type end, ios_base& f,
ios_base::iostate& err, tm* t,
char format, char modifier) const;
};
Clase std::time_get_byname
template <class CharT, class InputIter = istreambuf_iterator<CharT>>
class time_get_byname : public time_get<CharT, InputIter>
{
public:
typedef time_base::dateorder dateorder;
typedef InputIter iter_type;
explicit time_get_byname(const char*, size_t refs = 0);
explicit time_get_byname(const string&, size_t refs = 0);
protected:
~time_get_byname();
};
Clase std::time_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>>
class time_put : public locale::facet
{
public:
typedef CharT char_type;
typedef OutputIter iter_type;
explicit time_put(size_t refs = 0);
// Lo siguiente se implementa en términos de otras funciones miembro.
iter_type put(iter_type s, ios_base& f, char_type fill, const tm* tmb,
const CharT* pattern, const CharT* pat_end) const;
iter_type put(iter_type s, ios_base& f, char_type fill,
const tm* tmb, char format, char modifier = 0) const;
static locale::id id;
protected:
~time_put();
virtual iter_type do_put(iter_type s, ios_base&, char_type, const tm* t,
char format, char modifier) const;
};
Clase std::time_put_byname
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>>
class time_put_byname : public time_put<CharT, OutputIter>
{
public:
typedef CharT char_type;
typedef OutputIter iter_type;
explicit time_put_byname(const char*, size_t refs = 0);
explicit time_put_byname(const string&, size_t refs = 0);
protected:
~time_put_byname();
};
Clase std::money_get
template <class CharT, class InputIter = istreambuf_iterator<CharT>>
class money_get : public locale::facet
{
public:
typedef CharT char_type;
typedef InputIter iter_type;
typedef basic_string<CharT> string_type;
explicit money_get(size_t refs = 0);
iter_type get(iter_type s, iter_type end, bool intl, ios_base& f,
ios_base::iostate& err, long double& units) const;
iter_type get(iter_type s, iter_type end, bool intl, ios_base& f,
ios_base::iostate& err, string_type& digits) const;
static locale::id id;
protected:
~money_get();
virtual iter_type do_get(iter_type, iter_type, bool, ios_base&,
ios_base::iostate& err,
long double& units) const;
virtual iter_type do_get(iter_type, iter_type, bool, ios_base&,
ios_base::iostate& err,
string_type& digits) const;
};
Clase std::money_put
template <class CharT, class OutputIter = ostreambuf_iterator<CharT>>
class money_put : public locale::facet
{
public:
typedef CharT char_type;
typedef OutputIter iter_type;
typedef basic_string<CharT> string_type;
explicit money_put(size_t refs = 0);
iter_type put(iter_type s, bool intl, ios_base& f,
char_type fill, long double units) const;
iter_type put(iter_type s, bool intl, ios_base& f,
char_type fill, const string_type& digits) const;
static locale::id id;
protected:
~money_put();
virtual iter_type do_put(iter_type, bool, ios_base&, char_type fill,
long double units) const;
virtual iter_type do_put(iter_type, bool, ios_base&, char_type fill,
const string_type& digits) const;
};
Clase std::money_base
class money_base
{
public:
enum part { none, space, symbol, sign, value };
struct pattern { char field[4]; };
};
Clase std::moneypunct
template <class CharT, bool International = false>
class moneypunct : public locale::facet, public money_base
{
public:
typedef CharT char_type;
typedef basic_string<CharT> string_type;
explicit moneypunct(size_t refs = 0);
CharT decimal_point() const;
CharT thousands_sep() const;
string grouping() const;
string_type curr_symbol() const;
string_type positive_sign() const;
string_type negative_sign() const;
int frac_digits() const;
pattern pos_format() const;
pattern neg_format() const;
static locale::id id;
static const bool intl = International;
protected:
~moneypunct();
virtual CharT do_decimal_point() const;
virtual CharT do_thousands_sep() const;
virtual string do_grouping() const;
virtual string_type do_curr_symbol() const;
virtual string_type do_positive_sign() const;
virtual string_type do_negative_sign() const;
virtual int do_frac_digits() const;
virtual pattern do_pos_format() const;
virtual pattern do_neg_format() const;
};
Clase std::moneypunct_byname
template <class CharT, bool Intl = false>
class moneypunct_byname : public moneypunct<CharT, Intl>
{
public:
typedef money_base::pattern pattern;
typedef basic_string<CharT> string_type;
explicit moneypunct_byname(const char*, size_t refs = 0);
explicit moneypunct_byname(const string&, size_t refs = 0);
protected:
~moneypunct_byname();
};
Clase std::messages_base
class messages_base
{
public:
typedef /* tipo entero con signo no especificado */ catalog;
};
Clase std::messages
template <class CharT>
class messages : public locale::facet, public messages_base {
public:
typedef CharT char_type;
typedef basic_string<CharT> string_type;
explicit messages(size_t refs = 0);
catalog open(const basic_string<char>& fn, const locale&) const;
string_type get(catalog c, int set, int msgid,
const string_type& dfault) const;
void close(catalog c) const;
static locale::id id;
protected:
~messages();
virtual catalog do_open(const basic_string<char>&, const locale&) const;
virtual string_type do_get(catalog, int set, int msgid,
const string_type& dfault) const;
virtual void do_close(catalog) const;
};
Clase std::messages_byname
template <class CharT>
class messages_byname : public messages<CharT>
{
public:
typedef messages_base::catalog catalog;
typedef basic_string<CharT> string_type;
explicit messages_byname(const char*, size_t refs = 0);
explicit messages_byname(const string&, size_t refs = 0);
protected:
~messages_byname();
};
Clase std::wstring_convert
template<class Codecvt, class Elem = wchar_t,
class Wide_alloc = std::allocator<Elem>,
class Byte_alloc = std::allocator<char>>
class wstring_convert
{
public:
typedef std::basic_string<char, char_traits<char>, Byte_alloc> byte_string;
typedef std::basic_string<Elem, char_traits<Elem>, Wide_alloc> wide_string;
typedef typename Codecvt::state_type state_type;
typedef typename wide_string::traits_type::int_type int_type;
explicit wstring_convert(Codecvt* pcvt = new Codecvt);
wstring_convert(Codecvt* pcvt, state_type state);
explicit wstring_convert(const byte_string& byte_err,
const wide_string& wide_err = wide_string());
~wstring_convert();
wstring_convert(const wstring_convert&) = delete;
wstring_convert& operator=(const wstring_convert&) = delete;
wide_string from_bytes(char byte);
wide_string from_bytes(const char* ptr);
wide_string from_bytes(const byte_string& str);
wide_string from_bytes(const char* first, const char* last);
byte_string to_bytes(Elem wchar);
byte_string to_bytes(const Elem* wptr);
byte_string to_bytes(const wide_string& wstr);
byte_string to_bytes(const Elem* first, const Elem* last);
size_t converted() const noexcept;
state_type state() const;
private:
byte_string byte_err_string; // solo para exposición
wide_string wide_err_string; // solo para exposición
Codecvt* cvtptr; // solo para exposición
state_type cvtstate; // solo para exposición
size_t cvtcount; // solo para exposición
};
Clase std::wbuffer_convert
template<class Codecvt,
class Elem = wchar_t,
class Tr = std::char_traits<Elem>>
class wbuffer_convert : public std::basic_streambuf<Elem, Tr>
{
public:
typedef typename Codecvt::state_type state_type;
explicit wbuffer_convert(std::streambuf* bytebuf = 0,
Codecvt* pcvt = new Codecvt,
state_type state = state_type());
~wbuffer_convert();
wbuffer_convert(const wbuffer_convert&) = delete;
wbuffer_convert& operator=(const wbuffer_convert&) = delete;
std::streambuf* rdbuf() const;
std::streambuf* rdbuf(std::streambuf* bytebuf);
state_type state() const;
private:
std::streambuf* bufptr; // solo para exposición
Codecvt* cvtptr; // solo para exposición
state_type cvtstate; // solo para exposición
};
Informes de defectos
Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.
| ID | Aplicado a | Comportamiento según lo publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 71 | C++98 | El parámetro end de time_get::do_get_monthnamefaltaba en la sinopsis. |
Se agregó. |
| LWG 75 | C++98 | El tipo del parámetro state de los miembros length y do_lengthde codecvt y codecvt_byname era const stateT& en la sinopsis.
|
Se corrigió a stateT&.
|
| LWG 124 | C++98 | Los tipos de retorno de los miembros do_scan_is y do_scan_notde codecvt_byname eran const char* en la sinopsis.
|
Se corrigieron aconst charT*.
|
| LWG 228 | C++98 | Todas las funciones miembro virtuales de las facetasXXX_byname se enumeraron en las sinopsis.
|
Solo se enumera el destructor (se eliminaron todas las demás funciones miembro virtuales). |
| LWG 268 | C++98 | Los puntos y comas que siguen a las declaraciones del constructor por defecto y del constructor de copia de std::locale faltaban en la sinopsis. |
Se agregaron. |
| LWG 1298 | C++98 | Había una especialización explícita ctype_byname <char> en la sinopsis.
|
Se eliminó. |