最終更新日時(UTC): 2026年06月15日 05時22分22秒
Akira Takahashi が更新

履歴 編集

function
<cstring>

# std::memccpy(C++26)

    namespace std {
      void* memccpy(void* s1, const void* s2, int c, size_t n);
    }

## 概要

メモリデータを、指定した文字が現れるまでコピーする。

C23で`<string.h>`に追加された関数であり、C++26で`<cstring>`に取り込まれた。

この関数はフリースタンディング環境でも提供される。

## 効果

`s2`が指すオブジェクトから`s1`が指すオブジェクトへ、文字`c` (`unsigned char`に変換される) が最初に現れてコピーされるまで、もしくは`n`バイトをコピーするまで、いずれか早いほうまでバイトをコピーする。

コピー元とコピー先の領域が重なっている場合、動作は未定義である。

## 戻り値

コピー先`s1`において、コピーされた文字`c`の次の位置を指すポインタを返す。

`s2`の先頭`n`バイトに文字`c`が見つからなかった場合、ヌルポインタを返す。

## 例

    #include <cstring>
    #include <iostream>

    int main()
    {
      const char src[] = "abc/def";
      char dst[8] = {};

      // '/'が現れるまでコピーする
      char* p = static_cast<char*>(std::memccpy(dst, src, '/', sizeof(dst)));

      std::cout << dst << std::endl;
      std::cout << (p != nullptr ? "found" : "not found") << std::endl;
    }

### 出力

    abc/
    found

## バージョン

### 言語

- C++26

### 処理系

- Clang: 22 ❌
- GCC: 16.1 ❌
- Visual C++: 2026 Update 2 ❌

## 関連項目

- `memcpy`: メモリデータをコピーする
- `memmove`: メモリデータをコピーする（領域重複可）

## 参照

- P3348R4 C++26 should refer to C23 not C17
  - C++26がC23を参照するようになり、この関数が`<cstring>`に追加された