std::iscntrl(std::locale)

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

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

Parameters

ch - character
loc - locale

Return value

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

Possible implementation

1
2
3
4
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);
}

Example

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
#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:

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

See also

checks if a character is a control character
(function)
checks if a wide character is a control character
(function)
doc_CPP
2025-01-10 15:47:30
Comments
Leave a Comment

Please login to continue.