Difference between revisions of "cpp/string/wide/iswprint"

Revision as of 06:20, 31 May 2023

Defined in header `<cwctype>`
int iswprint( std::wint_t ch );

Checks if the given wide character can be printed, i.e. it is either a number (0123456789), an uppercase letter (ABCDEFGHIJKLMNOPQRSTUVWXYZ), a lowercase letter (abcdefghijklmnopqrstuvwxyz), a punctuation character (!"#$%&'()*+,-./:;<=>?@[\]^_`{!}~), space or any printable character specific to the current C locale.

If the value of ch is neither representable as a wchar_t nor equal to the value of the macro WEOF, the behavior is undefined.

#include <clocale>
#include <cwctype>
#include <iostream>
 
int main()
{
    const std::wint_t c1 = L'\u2002'; // en-space
 
    std::cout << std::boolalpha << std::hex << std::showbase;
 
    std::cout << "In default locale,\n"
              << "  iswprint('" << c1 << "') = "
              << static_cast<bool>(std::iswprint(c1)) << '\n';
 
    std::setlocale(LC_ALL, "en_US.utf8");
    std::cout << "In Unicode locale,\n"
              << "  iswprint('" << c1 << "') = "
              << static_cast<bool>(std::iswprint(c1)) << '\n';
 
    const std::wint_t c2 = L'\u0082'; // break permitted
 
    std::cout << "  iswprint('" << c2 << "') = "
              << static_cast<bool>(std::iswprint(c2)) << '\n';
}

Possible output:

In default locale,
  iswprint('0x2002') = false
In Unicode locale,
  iswprint('0x2002') = true
  iswprint('0x82') = false

ASCII values			characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
decimal	hexadecimal	octal	characters	`iscntrl` `iswcntrl`	`isprint` `iswprint`	`isspace` `iswspace`	`isblank` `iswblank`	`isgraph` `iswgraph`	`ispunct` `iswpunct`	`isalnum` `iswalnum`	`isalpha` `iswalpha`	`isupper` `iswupper`	`islower` `iswlower`	`isdigit` `iswdigit`	`isxdigit` `iswxdigit`
0–8	`\x0`–`\x8`	`\0`–`\10`	control codes (`NUL`, etc.)	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
9	`\x9`	`\11`	tab (`\t`)	`≠0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
10–13	`\xA`–`\xD`	`\12`–`\15`	whitespaces (`\n`, `\v`, `\f`, `\r`)	`≠0`	`0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
14–31	`\xE`–`\x1F`	`\16`–`\37`	control codes	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
32	`\x20`	`\40`	space	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`
33–47	`\x21`–`\x2F`	`\41`–`\57`	`!"#$%&'()*+,-./`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
48–57	`\x30`–`\x39`	`\60`–`\71`	`0123456789`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`0`	`0`	`0`	`≠0`	`≠0`
58–64	`\x3A`–`\x40`	`\72`–`\100`	`:;<=>?@`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
65–70	`\x41`–`\x46`	`\101`–`\106`	`ABCDEF`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`≠0`
71–90	`\x47`–`\x5A`	`\107`–`\132`	`GHIJKLMNOP` `QRSTUVWXYZ`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`≠0`	`0`	`0`	`0`
91–96	`\x5B`–`\x60`	`\133`–`\140`	[\]^_`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
97–102	`\x61`–`\x66`	`\141`–`\146`	`abcdef`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`0`	`≠0`	`0`	`≠0`
103–122	`\x67`–`\x7A`	`\147`–`\172`	`ghijklmnop` `qrstuvwxyz`	`0`	`≠0`	`0`	`0`	`≠0`	`0`	`≠0`	`≠0`	`0`	`≠0`	`0`	`0`
123–126	`\x7B`–`\x7E`	`\172`–`\176`	`{\|}~`	`0`	`≠0`	`0`	`0`	`≠0`	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`
127	`\x7F`	`\177`	backspace character (`DEL`)	`≠0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`	`0`

@@ Line 1: / Line 1: @@
 {{cpp/title|iswprint}}
 {{cpp/string/wide/navbar}}
-{{ddcl | header=cwctype |
+{{ddcl|header=cwctype|
 int iswprint( std::wint_t ch );
 }}
-Checks if the given wide character can be printed, i.e. it is either a number ({{tt|0123456789}}), an uppercase letter ({{tt|ABCDEFGHIJKLMNOPQRSTUVWXYZ}}), a lowercase letter ({{tt|abcdefghijklmnopqrstuvwxyz}}), a punctuation character({{tt|!"#$%&'()*+,-./:;<{{=}}>?@[\]^_`{<nowiki></nowiki>{{!}}<nowiki></nowiki>}~}}), space or any printable character specific to the current C locale.
+Checks if the given wide character can be printed, i.e. it is either a number ({{tt|0123456789}}), an uppercase letter ({{tt|ABCDEFGHIJKLMNOPQRSTUVWXYZ}}), a lowercase letter ({{tt|abcdefghijklmnopqrstuvwxyz}}), a punctuation character ({{tt|<nowiki>!"#$%&'()*+,-./:;<=>?@[\]^_`{!}~</nowiki>}}), space or any printable character specific to the current C locale.
 {{cpp/string/wide/wint_t args}}
 ===Parameters===
 {{par begin}}
-{{par | ch | wide character}}
+{{par|ch|wide character}}
 {{par end}}
@@ Line 22: / Line 22: @@
 {{example
 |code=
+#include <clocale>
+#include <cwctype>
 #include <iostream>
-#include <cwctype>
-#include <clocale>
 int main()
 {
-     wchar_t c = L'\u2002'; // en-space
+     const std::wint_t c1 = L'\u2002'; // en-space
+    std::cout << std::boolalpha << std::hex << std::showbase;
+    std::cout << "In default locale,\n"
+              << "  iswprint('" << c1 << "') = "
+              << static_cast<bool>(std::iswprint(c1)) << '\n';
      std::setlocale(LC_ALL, "en_US.utf8");
-     std::cout << std::boolalpha << std::hex << std::showbase
+     std::cout << "In Unicode locale,\n"
-              << "in Unicode locale,\n"
+               << "  iswprint('" << c1 << "') = "
-               << "iswprint('" << c << "') = "
+               << static_cast<bool>(std::iswprint(c1)) << '\n';
-               << (bool)std::iswprint(c) << '\n';
+     const std::wint_t c2 = L'\u0082'; // break permitted
-     c = L'\u0082'; // break permitted
-     std::cout << "iswprint('" << c << "') = "
+     std::cout << "  iswprint('" << c2 << "') = "
-               << (bool)std::iswprint(c) << '\n';
+               << static_cast<bool>(std::iswprint(c2)) << '\n';
 }
+|p=true
 |output=
-in Unicode locale,
+In default locale,
-iswprint('0x2002') = true
+  iswprint('0x2002') = false
-iswprint('0x82') = false
+In Unicode locale,
+  iswprint('0x2002') = true
+  iswprint('0x82') = false
 }}
 ===See also===
 {{dsc begin}}
-{{dsc inc | cpp/locale/dsc isprint}}
+{{dsc inc|cpp/locale/dsc isprint}}
-{{dsc inc | cpp/string/byte/dsc isprint}}
+{{dsc inc|cpp/string/byte/dsc isprint}}
-{{dsc see c | c/string/wide/iswprint}}
+{{dsc see c|c/string/wide/iswprint}}
 {{dsc end}}
 {{cpp/string/character classes}}
-[[de:cpp/string/wide/iswprint]]
+{{langlinks|de|es|fr|it|ja|pt|ru|zh}}
-[[es:cpp/string/wide/iswprint]]
-[[fr:cpp/string/wide/iswprint]]
-[[it:cpp/string/wide/iswprint]]
-[[ja:cpp/string/wide/iswprint]]
-[[pt:cpp/string/wide/iswprint]]
-[[ru:cpp/string/wide/iswprint]]
-[[zh:cpp/string/wide/iswprint]]

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Metaprogramming library (C++11)
Diagnostics library
General utilities library
Strings library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Numerics library
Localizations library
Input/output library
Filesystem library (C++17)
Regular expressions library (C++11)
Concurrency support library (C++11)
Execution support library (C++26)
Technical specifications
Symbols index
External libraries

Null-terminated strings
Byte strings
Multibyte strings
Wide strings
Classes
basic_string
basic_string_view (C++17)
char_traits

isprint(std::locale)	checks if a character is classified as printable by a locale (function template) [edit]
isprint	checks if a character is a printing character (function) [edit]
C documentation for iswprint

cppreference.com

Namespaces

Variants

Views

Actions

Difference between revisions of "cpp/string/wide/iswprint"

Revision as of 06:20, 31 May 2023

Contents

Parameters

Return value

Notes

Example

See also

Navigation

Toolbox