C++ STLのiswspace()関数とは？構文・使い方・戻り値を解説

本記事では、C++のiswspace()関数について、その構文、動作の仕組み、戻り値を詳しく解説します。

iswspace()関数は、C++の組み込み関数の一つで、<cwctype>ヘッダーファイルで定義されています。この関数は、引数として渡されたワイド文字が空白文字かどうかを判定します。iswspace()はisspace()のワイド文字版に相当する関数であり、isspace()と同じ動作をしますが、ワイド文字をサポートしている点が異なります。引数が空白文字（' '）であれば0以外の整数値（真）を返し、そうでなければ0（偽）を返します。

構文

int iswspace(wint_t ch);

この関数が受け取るパラメータは1つだけです。判定対象となるワイド文字を渡します。引数はwint_t型またはWEOFにキャストされます。

wint_tは整数型のデータを格納するための型です。

戻り値

この関数は整数値を返します。戻り値は、偽の場合は0、真の場合は0以外の値のいずれかになります。

使用例

#include <iostream>
#include <cwctype>
using namespace std;
int main() {
   wint_t a = '.';
   wint_t b = ' ';
   wint_t c = '1';
   iswspace(a)?cout<<"\nIts white space character":cout<<"\nNot white space character";
   iswspace(b)?cout<<"\nIts white space character":cout<<"\nNot white space character";
   iswspace(c)?cout<<"\nIts white space character":cout<<"\nNot white space character";
}

出力

上記のコードを実行すると、以下の出力が得られます。

Not white space character
Its white space character
Not white space character

この例では、ピリオド（'.'）、空白（' '）、数字（'1'）の3つの文字をiswspace()関数で判定しています。空白文字のみが真と判定され、それ以外の文字は偽と判定されます。

使用例：文字列中の空白文字をカウントする

#include <iostream>
#include <cwctype>
using namespace std;
int main () {
   int i, count;
   wchar_t s[] = L"I am visiting tutorials point";
   count = i = 0;
   while (s[i]) {
      if(iswspace(s[i]))
         count++;
      i++;
   }
   cout<<"There are "<<count <<" white space characters.\n";
   return 0;
}

出力

上記のコードを実行すると、以下の出力が得られます。

There are 4 white space characters.

この例では、ワイド文字列に含まれる空白文字の数をカウントしています。文字列"I am visiting tutorials point"には4つの空白文字が含まれているため、結果として「There are 4 white space characters.」と表示されます。このように、iswspace()関数をループ処理と組み合わせることで、文字列の解析や単語数のカウントなど、さまざまな用途に活用できます。