std::iscntrl(std::locale) - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::iscntrl(std::locale)

From cppreference.com
< cpp‎ | locale

Defined in header `<locale>` |  |
template< class charT > bool iscntrl( charT ch, const locale& loc ); |  |

Checks if the given character classified as a control character by the given locale's std::ctype facet.

### [edit] Parameters

ch | - | character
loc | - | locale

### [edit] Return value

Returns true if the character is classified as a control character, false otherwise.

### [edit] Possible implementation

    template< class charT >
    bool iscntrl( charT ch, const std::locale& loc ) {
        return std::use_facet<std::ctype<charT>>(loc).is(std::ctype_base::cntrl, ch);
    }

### [edit] Example

Demonstrates the use of iscntrl() with different locales (OS-specific).

Run this code

    #include <iostream>
    #include <locale>
    int main()
    {
        const wchar_t CCH = L'\u0094'; // Destructive Backspace in Unicode

        std::locale loc1("C");
        std::cout << "iscntrl(CCH, C locale) returned "
                  << std::boolalpha << std::iscntrl(CCH, loc1) << '\n';

        std::locale loc2("en_US.UTF8");
        std::cout << "iscntrl(CCH, Unicode locale) returned "
                  << std::boolalpha << std::iscntrl(CCH, loc2) << '\n';
    }

Output:

    iscntrl(CCH, C locale) returned false
    iscntrl(CCH, Unicode locale) returned true

### [edit] See also

iscntrl | checks if a character is a control character (function) [edit]
iswcntrl | checks if a wide character is a control character (function) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/locale/iscntrl&oldid=58121"