• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

    最終更新日時(UTC):
    が更新

    履歴 編集

    function
    <string_view>

    std::basic_string_view::copy

    size_type copy(CharT* s, size_type n, size_type pos = 0) const;           // C++17
    
    constexpr size_type copy(CharT* s, size_type n, size_type pos = 0) const; // C++20
    

    概要

    他の文字列に、自身の文字列をコピーする。

    要件

    nsize() - posのうち、小さい方をrlenとする。

    • [s, s + rlen)が妥当な範囲であり、その範囲内の要素にアクセスできること

    効果

    以下と等価の処理を行う:

    Traits::copy(s, data() + pos, rlen);
    

    戻り値

    rlen

    例外

    pos > size()の場合、std::out_of_range例外を送出する。

    #include <iostream>
    #include <string_view>
    
    int main()
    {
      const std::string_view sv = "hello";
    
      // 全体をコピーする
      {
        char result[5 + 1] = {};
        sv.copy(result, 5);
    
        std::cout << result << std::endl;
      }
    
      // 先頭3要素だけコピーする
      {
        char result[3 + 1] = {};
        sv.copy(result, 3);
    
        std::cout << result << std::endl;
      }
    
      // 2番目以降の要素をコピーする
      {
        char result[3 + 1] = {};
        sv.copy(result, 3, 2);
    
        std::cout << result << std::endl;
      }
    }
    

    出力

    hello
    hel
    llo
    

    バージョン

    言語

    • C++17

    処理系

    参照