std::strcspn

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

文字列ライブラリ

ヌル終端文字列

バイト文字列

マルチバイト文字列

ワイド文字列

クラス

basic_string

basic_string_view (C++17)

char_traits

 

ヌル終端バイト文字列

関数
文字操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C++11)	iscntrl isgraph isspace isprint ispunct tolower toupper
数値形式への変換
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
文字列操作
strcpy
strncpy
strcat
strncat
strxfrm
文字列検査
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
メモリ操作
memchr
memcmp
memset
memcpy
memmove
その他
strerror

 

ヘッダ <cstring> で定義
size_t strcspn( const char *dest, const char *src );

src の指すバイト文字列内に含まれない文字のみで構成される、 dest の指すバイト文字列の最も長い先頭部分の長さを返します。

関数名の由来は「complementary span」です。

引数

dest	-	解析するヌル終端文字列を指すポインタ
src	-	検索する文字を含むヌル終端バイト文字列を指すポインタ

戻り値

src の指すバイト文字列内にない文字のみを含む最も長い先頭部分の長さ。

例

Run this code

#include <string>
#include <cstring>
#include <iostream>
 
const char* invalid = "*$#";
int main()
{
    std::string s = "abcde312$#@";
 
    size_t valid_len = std::strcspn(s.c_str(), invalid);
    if(valid_len != s.size())
       std::cout << "'" << s << "' contains invalid chars starting at position "
                 << valid_len << '\n';
}

出力:

'abcde312$#@' contains invalid chars starting at position 8

関連項目

strspn	別のバイト文字列に含まれる文字のみで構成される最も長い先頭部分の長さを返します (関数)
wcscspn	別のワイド文字列に含まれないワイド文字のみで構成される先頭部分の最大の長さを返します (関数)
strpbrk	区切り文字集合の任意の文字が文字列中に現れる最初の位置を探します (関数)
find_first_of	文字が現れる最初の位置を探します (std::basic_string<CharT,Traits,Allocator>のパブリックメンバ関数)
strcspn の C言語リファレンス