31 Regular expressions library [re]

Тип char_­class_­type используется для представления классификации символов и может содержать набор для конкретной реализации, возвращаемый функцией lookup_­classname.

Returns: char_­traits<charT>​::​length(p).

Returns: c.

Returns: use_­facet<ctype<charT>>(getloc()).tolower(c).

Effects: Как будто по:

string_type str(first, last);
return use_facet<collate<charT>>(
  getloc()).transform(&*str.begin(), &*str.begin() + str.length());

Effects: Если

typeid(use_facet<collate<charT>>) == typeid(collate_byname<charT>)

и форма ключа сортировки, возвращаемого функцией collate_­byname<charT>​::​transform(first, last) , известна и может быть преобразована в первичный ключ сортировки, затем возвращается этот ключ, в противном случае возвращается пустая строка.

Returns: последовательность из одного или нескольких символов, представляющая элемент сортировки, состоящий из последовательности символов, обозначенной диапазоном итератора [first, last). Возвращает пустую строку, если последовательность символов не является допустимым элементом сортировки.

Returns: неопределенное значение, представляющее классификацию символов, названную последовательностью символов, обозначенной диапазоном итератора [first, last). Если параметр icase равен, true то возвращаемая маска идентифицирует классификацию символов без учета регистра сопоставляемых символов, в противном случае учитывает регистр сопоставляемых символов.329 Возвращаемое значение не должно зависеть от регистра символов в последовательности символов. Если имя не распознано, возвращается char_­class_­type().

Remarks: Ибо regex_­traits<char>, по крайней мере, 133 должны распознаваться узкие имена символов в Таблице . Поскольку regex_­traits<wchar_­t>, по крайней мере, 133 должны распознаваться имена широких символов в таблице .

Effects: Определяет, является ли персонаж c членом классификации символов, представленной f.

Returns: Учитывая следующее объявление функции:

// for exposition only
template<class C>
  ctype_base::mask convert(typename regex_traits<C>::char_class_type f);

который возвращает значение, в котором установлено каждое ctype_­base​::​mask значение, соответствующее значению в f названии в таблице 133 , тогда результат определяется, как если бы:

ctype_base::mask m = convert<charT>(f);
const ctype<charT>& ct = use_facet<ctype<charT>>(getloc());
if (ct.is(m, c)) {
  return true;
} else if (c == ct.widen('_')) {
  charT w[1] = { ct.widen('w') };
  char_class_type x = lookup_classname(w, w+1);
  return (f&x) == x;
} else {
  return false;
}

[ Example:

regex_traits<char> t;
string d("d");
string u("upper");
regex_traits<char>::char_class_type f;
f = t.lookup_classname(d.begin(), d.end());
f |= t.lookup_classname(u.begin(), u.end());
ctype_base::mask m = convert<char>(f); // m == ctype_­base​::​digit|ctype_­base​::​upper

 — end example ] [ Example:

regex_traits<char> t;
string w("w");
regex_traits<char>::char_class_type f;
f = t.lookup_classname(w.begin(), w.end());
t.isctype('A', f); // returns true
t.isctype('_', f); // returns true
t.isctype(' ', f); // returns false

 — end example ]

Requires: Значение radix должно быть 8, 10 или 16.

Returns: значение, представленное цифрой ch в базе, radix если символ ch является действительной цифрой в базе radix; в противном случае возвращается -1.

Effects: Наполняет this копией локали loc. [  Note: Вызов imbue с локалью, отличной от используемой в настоящее время, делает недействительными все кэшированные данные, хранящиеся в *this. ]  — end note 

Returns: если языковой стандарт ранее не был добавлен, то копия глобального языкового стандарта, действующего на момент создания *this, в противном случае - копия последнего переданного аргумента imbue.

Postconditions: getloc() == loc.

Returns: если языковой стандарт не был добавлен, то копия глобального языкового стандарта, действующего на момент создания *this, в противном случае - копия последнего переданного аргумента imbue.