std::regex_traits::translate_nocase

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Regular expressions library

Classes

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorithms

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iterators

regex_iterator (C++11)

regex_token_iterator (C++11)

Exceptions

regex_error (C++11)

Traits

regex_traits (C++11)

Constants

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

 

std::regex_traits

Member Functions

regex_traits::regex_traits

regex_traits::length

regex_traits::translate

regex_traits::translate_nocase

regex_traits::transform

regex_traits::transform_primary

regex_traits::lookup_collatename

regex_traits::lookup_classname

regex_traits::isctype

regex_traits::value

regex_traits::imbue

regex_traits::getloc

 

CharT translate_nocase(CharT c) const;

Obtains the comparison key for the character c, such that all characters that are equivalent to this character in the imbued locale, ignoring the case differences, if any, produce the same key.

When the regex library needs to match two characters c1 and c2 and the flag std::regex_constants::icase is true, it executes regex_traits<>::translate_nocase(c1) == regex_traits<>::translate_nocase(c2).

Standard library specializations of std::regex_traits return std::use_facet<std::ctype<CharT>>(getloc()).tolower(c), that is, convert c to lowercase, using the currently imbued locale.

Parameters

c

-

character that needs to be examined for equivalence, ignoring case

Return value

The case-insensitive comparison key for c in the currently imbued locale.