std::regex_traits<CharT>::lookup_classname
template< class ForwardIt >
char_class_type lookup_classname( ForwardIt first,
ForwardIt last,
bool icase = false ) const;
|
Если последовательность символов [first, last) представляет собой имя допустимого класса символов в текущей установленной локали (то есть строку между [: и :] в регулярных выражениях), возвращается определяемое реализацией значение, представляющее этот класс символов. В противном случае возвращается ноль.
Если параметр icase равен true, класс символов не учитывает регистр, например регулярное выражение [:lower:] с std::regex_constants::icase порождает вызов std::regex_traits<>::lookup_classname() с [first, last), указывающим строку "lower" и icase == true. Этот вызов возвращает ту же битовую маску, что и вызов, порождаемый регулярным выражением [:alpha:] с icase == false.
Следующие имена классов узких и широких символов всегда распознаются соответственно std::regex_traits<char> и std::regex_traits<wchar_t>, а возвращаемые классификации (с icase == false) соответствуют классификациям, полученным из фасета std::ctype установленной локали, следующим образом:
| Имя класса символов | std::ctype классификация |
|
|---|---|---|
| Узкие | Широкие | |
"alnum" |
L"alnum" |
std::ctype_base::alnum |
"alpha" |
L"alpha" |
std::ctype_base::alpha |
"blank" |
L"blank" |
std::ctype_base::blank |
"cntrl" |
L"cntrl" |
std::ctype_base::cntrl |
"digit" |
L"digit" |
std::ctype_base::digit |
"graph" |
L"graph" |
std::ctype_base::graph |
"lower" |
L"lower" |
std::ctype_base::lower |
"print" |
L"print" |
std::ctype_base::print |
"punct" |
L"punct" |
std::ctype_base::punct |
"space" |
L"space" |
std::ctype_base::space |
"upper" |
L"upper" |
std::ctype_base::upper |
"xdigit" |
L"xdigit" |
std::ctype_base::xdigit |
"d" |
L"d" |
std::ctype_base::digit |
"s" |
L"s" |
std::ctype_base::space |
"w" |
L"w" |
std::ctype_base::alnumс необязательным добавлением '_' |
Классификация, возвращаемая для строки "w", может полностью совпадать с "alnum"; в этом случае isctype() явно добавляет '_'.
Системные локали могут предоставлять дополнительные классификации, например "jdigit" или "jkanji" (в этом случае они также доступны через std::wctype).
Параметры
| first, last | - | пара итераторов, определяющая последовательность символов, представляющую имя класса символов |
| icase | - | если true, игнорирует различие между верхним и нижним регистром при классификации символов |
| Требования к типам | ||
-ForwardIt должен соответствовать требованиям LegacyForwardIterator. |
||
Возвращаемое значение
Битовая маска, представляющая классификацию символов, определяемую заданным классом символов, или char_class_type(), если класс неизвестен.
Пример
Демонстрирует пользовательскую реализацию regex traits для lookup_classname() / isctype():
#include <cwctype>
#include <iostream>
#include <locale>
#include <regex>
// This custom regex traits uses wctype/iswctype to implement lookup_classname/isctype.
struct wctype_traits : std::regex_traits<wchar_t>
{
using char_class_type = std::wctype_t;
template<class It>
char_class_type lookup_classname(It first, It last, bool = false) const
{
return std::wctype(std::string(first, last).c_str());
}
bool isctype(wchar_t c, char_class_type f) const
{
return std::iswctype(c, f);
}
};
int main()
{
std::locale::global(std::locale("ja_JP.utf8"));
std::wcout.sync_with_stdio(false);
std::wcout.imbue(std::locale());
std::wsmatch m;
std::wstring in = L"風の谷のナウシカ";
// matches all characters (they are classified as alnum)
std::regex_search(in, m, std::wregex(L"([[:alnum:]]+)"));
std::wcout << "alnums: " << m[1] << '\n'; // prints "風の谷のナウシカ"
// matches only the katakana
std::regex_search(in, m,
std::basic_regex<wchar_t, wctype_traits>(L"([[:jkata:]]+)"));
std::wcout << "katakana: " << m[1] << '\n'; // prints "ナウシカ"
}
Вывод:
alnums: 風の谷のナウシカ katakana: ナウシカ
См. также
| указывает принадлежность к классу символов (открытая функция-член) |
|
| выполняет поиск категории классификации символов в текущей локали C (функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/regex/regex_traits/lookup_classname