| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Tue, 29 Jul 2025 12:55:06 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/locale/collate/transform/
HTTP/1.1 200 OK
Server: nginx
Date: Tue, 29 Jul 2025 12:55:06 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"8516-sm4kMPiXjHCDIwBXamI0tlPJk8g"
Content-Encoding: gzip
Returns a string object whose character values are such that when compared lexicographically with the character values resulting from calling this same function on another string, gives the same result as comparing the strings using collate::compare.
This allows to speed up comparisons when a single string needs to be collate compared to many other strings, since lexicographical comparisons (such as those performed by the lexicographical_compare algorithm) may be considerably faster than collate::compare on certain locales.
Internally, this function simply calls the virtual protected member do_transform, which for the classic locale on the default specializations returns a string with the same characters as the range, without performing any transformation.
Member type string_type is an instantiation of basic_string with the same character type as the facet (defined as an alias of
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<locale>
- has_facet
- locale
- use_facet
-
wbuffer_convertC++11
-
wstring_convertC++11
functions
standard facets
collate
- collate::collate
public member functions
protected members
public member function
<locale>
std::collate::transform
string_type transform (const char_type* low, const char_type* high) const;
Transform character sequence
This allows to speed up comparisons when a single string needs to be collate compared to many other strings, since lexicographical comparisons (such as those performed by the lexicographical_compare algorithm) may be considerably faster than collate::compare on certain locales.
Internally, this function simply calls the virtual protected member do_transform, which for the classic locale on the default specializations returns a string with the same characters as the range, without performing any transformation.
Parameters
- low, high
- Pointers to the beginning and ending characters of the sequence. The range used is
[low,high), which contains all the characters between low and high, including the character pointed by low but not the character pointed by high.
Note that null characters (if any) are also transformed, and the function proceeds beyond them, until the entire range is converted.
Member type char_type is the facet's character type (defined as an alias of collate's template parameter, charT).
Return value
A string that, if compared lexicographically with the result of this same function on another string will return the same as comparing the two original strings with collate::compare.Member type string_type is an instantiation of basic_string with the same character type as the facet (defined as an alias of
basic_string<charT>, where charT is collate's template parameter).Data races
The facet object and the characters in the range[low,high) are accessed.Exception safety
Strong guarantee: No side effects in case an exception is thrown.See also
- collate::compare
- Compare character sequences (public member function)
- collate::hash
- Get hash value (public member function)
- lexicographical_compare
- Lexicographical less-than comparison (function template)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us