# std::wctrans

> C++ Atlas: `cppatlas.com/w/cpp/string/wide/wctrans` | Source: https://en.cppreference.com/w/cpp/string/wide/wctrans | Domain: Strings

Constructs a value of type std::wctrans_t that describes a LC_CTYPE category of wide character mapping. It may be one of the standard mappings, or a locale-specific mapping, such as "tojhira" or "tojkata".

## Official Specification Summary (cppreference)

```cpp
// Defined in header <cwctype>
std::wctrans_t wctrans( const char* str );
```

Constructs a value of type `std::wctrans_t` that describes a `LC_CTYPE` category of wide character mapping. It may be one of the standard mappings, or a locale-specific mapping, such as `"tojhira"` or `"tojkata"`.

### Parameters

- `str` - C string holding the name of the desired mapping.

  The following values of `str` are supported in all C locales:

  **Value of `str` — Effect**

  - `"toupper"`: identifies the mapping used by `towupper`
  - `"tolower"`: identifies the mapping used by `towlower`

### Return value

`std::wctrans_t` object suitable for use with `std::towctrans` to map wide characters according to the named mapping of the current C locale or zero if `str` does not name a mapping supported by the current C locale.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`towctrans`](https://en.cppreference.com/w/cpp/string/wide/towctrans): performs character mapping according to the specified `LC_CTYPE` mapping category (function)
- [C documentation for `wctrans`](https://en.cppreference.com/w/c/string/wide/wctrans)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/wide/wctrans (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.