命名空间
变体
操作

std::basic_string<CharT,Traits,Allocator>::starts_with

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

 
constexpr bool
    starts_with( std::basic_string_view<CharT,Traits> sv ) const noexcept;
 (1) (自 C++20 起)
constexpr bool
    starts_with( CharT ch ) const noexcept;
 (2) (自 C++20 起)
constexpr bool
    starts_with( const CharT* s ) const;
 (3) (自 C++20 起)

检查字符串是否以给定前缀开头。前缀可以是以下之一

1) 字符串视图 sv（可能是从另一个 std::basic_string 隐式转换的结果）。
2) 单个字符 ch.
3) 以空字符结尾的字符数组 s.

所有三个重载实际上都返回 std::basic_string_view<CharT, Traits>(data(), size()).starts_with(x)，其中 x 是参数。

内容

[编辑] 参数

sv - 字符串视图，可能是从另一个 std::basic_string 隐式转换的结果
ch - 单个字符
s - 以空字符结尾的字符数组

[编辑] 返回值

如果字符串以提供的首缀开头，则为 true，否则为 false。

[编辑] 备注

功能测试 宏 值 Std 功能
__cpp_lib_starts_ends_with 201711L (C++20) 字符串前缀和后缀检查：starts_with() 和 ends_with()

[编辑] 示例

运行此代码
#include <cassert>
#include <string>
#include <string_view>
 
int main()
{
    using namespace std::literals;
 
    const auto str = "Hello, C++20!"s;
 
    assert
    (""
        && str.starts_with("He"sv)  // (1)
        && !str.starts_with("he"sv) // (1)
        && str.starts_with("He"s)   // (1) implicit conversion string to string_view
        && !str.starts_with("he"s)  // (1) implicit conversion string to string_view
        && str.starts_with('H')     // (2)
        && !str.starts_with('h')    // (2)
        && str.starts_with("He")    // (3)
        && !str.starts_with("he")   // (3)
    );
}

[编辑] 参见

(C++20)
 检查字符串是否以给定后缀结尾
(公共成员函数) [编辑]
(C++20)
 检查字符串视图是否以给定前缀开头
(std::basic_string_view<CharT,Traits> 的公共成员函数) [编辑]
(C++20)
 检查字符串视图是否以给定后缀结尾
(std::basic_string_view<CharT,Traits> 的公共成员函数) [编辑]
(C++23)
 检查字符串是否包含给定的子字符串或字符
(公共成员函数) [编辑]
(C++23)
 检查字符串视图是否包含给定的子字符串或字符
(std::basic_string_view<CharT,Traits> 的公共成员函数) [编辑]
 比较两个字符串
(公共成员函数) [编辑]
 返回子字符串
(公共成员函数) [编辑]
从 “https://cppreference.cn/mwiki/index.php?title=cpp/string/basic_string/starts_with&oldid=156934” 获取