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

来自cppreference.com
< cpp‎ | string‎ | basic string
 
 
 
std::basic_string
成员函数
元素访问
迭代器
容量
修改器
搜索
操作
常量
非成员函数
I/O
比较
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20)
数值转换
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
字面量
operator""s
(C++14)
辅助类
推导指引 (C++17)

 
在标头 <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,其中 literalsstring_literals 都是内联命名空间。可通过以下方式获取对这些运算符的访问:

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

std::chrono::duration 亦定义 operator""s,以表示字面量的秒,但它是算术类型字面量:10.0s10s 是十秒,但 "10"s 是字符串。

功能特性测试 标准 功能特性
__cpp_lib_string_udls 201304L (C++14) 字符串类型的用户定义字面量

示例

#include <iostream>
#include <string>
 
void print_with_zeros(auto const note, std::string const& 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
(公开成员函数)
创建一个字符数组字面量的字符串视图
(函数)