View source for cpp/string/basic string/operator""s

You do not have permission to edit this page, for the following reason:

Due to recent vandalism, editing of this page is temporarily disabled for new users.If you want to suggest a change, please leave a message on the suggestions page for new users instead (don't be surprised if that page appears vandalized!).

You can view and copy the source of this page:

{{cpp/title|n=literals::string_literals::|operator""s }}
{{cpp/string/basic_string/navbar}}
{{dcl begin}}
{{dcl header | string}}
{{dcl rev multi | num=1
| since1=c++14 | dcl1=
std::string operator""s(const char *str, std::size_t len);
| since2=c++20 | dcl2=
constexpr std::string operator""s(const char *str, std::size_t len);
}}
{{dcl | num=2 | since=c++20 | 1=
constexpr std::u8string operator""s(const char8_t *str, std::size_t len);
}}
{{dcl rev multi | num=3
| since1=c++14 | dcl1=
std::u16string operator""s(const char16_t *str, std::size_t len);
| since2=c++20 | dcl2=
constexpr std::u16string operator""s(const char16_t *str, std::size_t len);
}}
{{dcl rev multi | num=4
| since1=c++14 | dcl1=
std::u32string operator""s(const char32_t *str, std::size_t len);
| since2=c++20 | dcl2=
constexpr std::u32string operator""s(const char32_t *str, std::size_t len);
}}
{{dcl rev multi | num=5
| since1=c++14 | dcl1=
std::wstring operator""s(const wchar_t *str, std::size_t len);
| since2=c++20 | dcl2=
constexpr std::wstring operator""s(const wchar_t *str, std::size_t len);
}}
{{dcl end}}

Forms a string literal of the desired type.

@1@ returns {{c|std::string{str, len} }}
@2@ returns {{c|std::u8string{str, len} }}
@3@ returns {{c|std::u16string{str, len} }}
@4@ returns {{c|std::u32string{str, len} }}
@5@ returns {{c|std::wstring{str, len} }}

===Parameters===
{{par begin}}
{{par | str | pointer to the beginning of the raw character array literal}}
{{par | len | length of the raw character array literal}}
{{par end}}

===Return value===
The string literal.

===Notes===
These operators are declared in the namespace {{c|std::literals::string_literals}}, where both {{tt|literals}} and {{tt|string_literals}} are inline namespaces. Access to these operators can be gained with either <br>
* {{c|using namespace std::literals}}, or
* {{c|using namespace std::string_literals}}, or
* {{c|using namespace std::literals::string_literals}}.

{{lc|std::chrono::duration}} also defines {{c|operator""s}}, to represent literal seconds, but it is an arithmetic literal: {{c|10.0s}} and {{c|10s}} are ten seconds, but {{c|"10"s}} is a string.

{{feature test macro|__cpp_lib_string_udls}}

===Example===
{{example
| code=
#include <string>
#include <iostream>

int main()
{
    using namespace std::string_literals;

    std::string s1 = "abc\0\0def";
    std::string s2 = "abc\0\0def"s;
    std::cout << "s1: " << s1.size() << ' ' << s1 << '\n'
              << "s2: " << s2.size() << ' ' << s2 << '\n'
              << "abcdef"s.substr(1,4) << '\n';
}
| p=true
| output= 
s1: 3 abc
s2: 8 abc^@^@def
bcde
}}

===See also===
{{dsc begin}}
{{dsc inc | cpp/string/basic_string/dsc constructor}}
{{dsc inc | cpp/string/basic_string_view/dsc operator""sv}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Templates used on this page:

Template:! (view source) (protected)
Template:= (edit)
Template:== (edit)
Template:anchor (edit)
Template:c (view source) (protected)
Template:c/core (view source) (protected)
Template:cpp/navbar content (edit)
Template:cpp/navbar heading (edit)
Template:cpp/string/basic string view/dsc operator""sv (edit)
Template:cpp/string/basic string/dsc constructor (edit)
Template:cpp/string/basic string/navbar (edit)
Template:cpp/string/basic string/navbar content (edit)
Template:cpp/string/basic string/navbar heading (edit)
Template:cpp/string/navbar content (edit)
Template:cpp/string/navbar heading (edit)
Template:cpp/title (view source) (protected)
Template:ctitle (view source) (protected)
Template:dcl (view source) (protected)
Template:dcl begin (view source) (protected)
Template:dcl end (view source) (protected)
Template:dcl header (view source) (protected)
Template:dcl list header/link (edit)
Template:dcl sep (view source) (protected)
Template:dcl/std (view source) (semi-protected)
Template:dcla (edit)
Template:dsc (view source) (protected)
Template:dsc begin (view source) (protected)
Template:dsc editlink (edit)

cppreference.com

Namespaces

Variants

Views

Actions

View source for cpp/string/basic string/operator""s