std::towctrans

 

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)

 

Strings library

Null-terminated strings

Byte strings

Multibyte strings

Wide strings

Classes

basic_string

char_traits

 

Null-terminated wide strings

Functions
Character manipulation
iswalnum iswalpha iswlower iswupper iswdigit iswxdigit iswblank (C++11) wctype iswctype	iswcntrl iswgraph iswspace iswprint iswpunct towlower towupper wctrans towctrans
Conversions to numeric formats
wcstolwcstoll wcstoulwcstoull	wcstofwcstodwcstold
String manipulation
wcslen wcscpy wcsncpy wcscat wcsncat wcscmp wcscoll wcsncmp	wcsxfrm wcschr wcsrchr wcspbrk wcsspn wcscspn wcsstr wcstok
Array manipulation
wmemcpy
wmemmove
wmemcmp
wmemchr
wmemset

 

Defined in header <cwctype>
std::wint_t towctrans( std::wint_t wc, std::wctrans_t desc );

Maps the wide character wc using the current C locale's LC_CTYPE mapping category identified by desc.

Parameters

ch	-	the wide character to map
desc	-	the LC_CTYPE mapping, obtained from a call to std::wctrans

Return value

The mapped value of ch using the mapping identified by desc in LC_CTYPE facet of the current C locale.

Example

The following example demonstrates katakana to hiragana character mapping

Run this code

#include <clocale>
#include <cwctype>
#include <iostream>
#include <algorithm>
 
std::wstring tohira(std::wstring str)
{
    std::transform(str.begin(), str.end(), str.begin(), [](wchar_t c) {
         return std::towctrans(c, std::wctrans("tojhira"));
    });
    return str;
}
 
int main()
{
    std::setlocale(LC_ALL, "ja_JP.UTF-8");
    std::wstring kana = L"ヒラガナ";
    std::wcout << "katakana characters " << kana
               << " are " << tohira(kana) << " in hiragana\n";
}

Output:

katakana characters ヒラガナ are ひらがな in hiragana

See also

wctrans	looks up a character mapping category in the current C locale (function)
C documentation for towctrans