Namespaces
Variants

std::literals::string_literals::operator""s

ja.cppreference.net より
 
 
 
std::basic_string
 
ヘッダ <string>
std::string operator""s( const char* str, std::size_t len );
で定義 (1) (C++14 以降)
(C++20 以降 constexpr)
constexpr std::u8string operator""s( const char8_t* str,
                                     std::size_t len );
(2) (C++20 以降)
std::u16string operator""s( const char16_t* str, std::size_t len );
(3) (C++14 以降)
(C++20 以降 constexpr)
std::u32string operator""s( const char32_t* str, std::size_t len );
(4) (C++14 以降)
(C++20 以降 constexpr)
std::wstring operator""s( const wchar_t* str, std::size_t len );
(5) (C++14 以降)
(C++20 以降 constexpr)

所望の型の文字列リテラルを形成します。

1) std::string{str, len} を返します。
2) std::u8string{str, len} を返します。
3) std::u16string{str, len} を返します。
4) std::u32string{str, len} を返します。
5) std::wstring{str, len} を返します。

パラメータ

str - 生文字配列リテラルの先頭へのポインタ
len - 生文字配列リテラルの長さ

戻り値

文字列リテラル。

注記

これらの演算子は名前空間 std :: literals :: string_literals で宣言されています。ここで literals と string_literals はどちらもインライン名前空間です。これらの演算子へのアクセスは、以下のいずれかの using ディレクティブを使用して得ることができます:

  • using namespace std :: literals
  • using namespace std :: string_literals
  • using namespace std :: literals :: string_literals

std::chrono::duration はリテラル秒を表す operator""s も定義していますが、これは算術リテラルです: 10.0s と 10s は10秒を表しますが、 "10" s は文字列です。

機能テスト マクロ 値 標準 機能
__cpp_lib_string_udls 201304L (C++14) 文字列型に対するユーザー定義リテラル

例

#include <iostream>
#include <string>
void print_with_zeros(const auto note, const std::string& s)
{
    std::cout << note;
    for (const char c : s)
        c ? std::cout << c : std::cout << "₀";
    std::cout << " (size = " << s.size() << ")\n";
}
int main()
{
    using namespace std::string_literals;
    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    print_with_zeros("s1: ", s1);
    print_with_zeros("s2: ", s2);
    std::cout << "abcdef"s.substr(1,4) << '\n';
}

出力:

s1: abc (size = 3)
s2: abc₀₀def (size = 8)
bcde

関連項目

basic_stringを構築する
(public member function)
文字配列リテラルのstring viewを作成する
(function)