std::strchr

namespace std {
  const char* strchr(const char* s, int c); // (1)
  char* strchr(char* s, int c);             // (2)
}

概要

文字列から文字を検索する。

• (1) : 引数sがconst修飾されている場合に、const修飾を保持して結果を返すオーバーロード。
• (2) : 引数sがconst修飾されていない場合に、非constのポインタを返すオーバーロード。

効果

sが指す文字列から、charに変換した文字cが最初に現れる位置を検索する。終端のヌル文字も文字列の一部として検索対象に含まれる。

戻り値

見つかった場合、その位置を指すポインタを返す。見つからなかった場合、ヌルポインタを返す。

• (1) : const char*を返す。
• (2) : char*を返す。

備考

• この関数は、フリースタンディング処理系でも使用できる。
• C言語のstrchrはchar*を返す単一の関数だが、C++ではconst修飾を保持するために2つのオーバーロードが提供される。

例

#include <cstring>
#include <iostream>

int main()
{
  const char s[] = "hello";

  const char* p = std::strchr(s, 'l');

  std::cout << (p != nullptr ? p - s : -1) << std::endl;
}

出力

2

バージョン

言語

• C++98

関連項目

• strrchr: 文字を後ろから検索する
• strstr: 文字列を検索する
• memchr: メモリデータを検索する

参照

• P2338R4 Freestanding Library: Character primitives and the C library
  • C++26で、この関数がフリースタンディング処理系で使用可能になった