字符串操作

字符串操作函数的实现 更多...

函数
template<typename CharT>
constexpr CharT *	neforce::string_copy (CharT *__restrict dest, const CharT *__restrict src) noexcept
	复制字符串
template<typename CharT>
constexpr CharT *	neforce::string_copy (CharT *__restrict dest, const CharT *__restrict src, const size_t count) noexcept
	复制指定长度的字符串
template<typename CharT>
constexpr CharT *	neforce::string_copy_offset (CharT *__restrict dest, const CharT *__restrict src) noexcept
	复制字符串并返回指向结尾的指针
template<typename CharT>
constexpr CharT *	neforce::string_copy_offset (CharT *__restrict dest, const CharT *__restrict src, const size_t count) noexcept
	复制指定长度的字符串并返回指向结尾的指针
template<typename CharT>
constexpr int	neforce::string_compare (const CharT *dest, const CharT *src) noexcept
	比较两个字符串
template<typename CharT>
constexpr int	neforce::string_compare (const CharT *dest, const CharT *src, const size_t count) noexcept
	比较两个字符串的前n个字符
template<typename CharT>
constexpr int	neforce::string_compare_ignore_case (const CharT *s1, const CharT *s2) noexcept
	忽略大小写比较两个字符串
template<typename CharT>
constexpr int	neforce::string_compare_ignore_case (const CharT *s1, const CharT *s2, const size_t count) noexcept
	忽略大小写比较两个字符串的前n个字符
template<typename CharT>
constexpr size_t	neforce::string_length (const CharT *str) noexcept
	计算字符串长度
template<typename CharT>
constexpr size_t	neforce::string_length (const CharT *str, const size_t max_len) noexcept
	计算字符串的最大长度
template<typename CharT>
constexpr const CharT *	neforce::string_find (const CharT *str, const CharT chr) noexcept
	查找字符在字符串中首次出现的位置
template<typename CharT>
constexpr const CharT *	neforce::string_find (const CharT *str, const CharT chr, const size_t count) noexcept
	在前n个字符中查找字符首次出现的位置
template<typename CharT>
constexpr const CharT *	neforce::string_find_last (const CharT *str, const CharT chr) noexcept
	查找字符在字符串中最后出现的位置
template<typename CharT>
constexpr CharT *	neforce::string_find_any (CharT *str, const CharT *accept) noexcept
	查找字符串中第一个出现在指定字符集中的字符
template<typename CharT>
constexpr const CharT *	neforce::string_find_pattern (const CharT *dest, const CharT *src) noexcept
	查找子字符串在字符串中首次出现的位置
template<typename CharT>
constexpr const CharT *	neforce::string_find_pattern_ignored_case (const CharT *dest, const CharT *src) noexcept
	忽略大小写查找子字符串在字符串中首次出现的位置
template<typename CharT>
constexpr size_t	neforce::string_span_in (const CharT *str, const CharT *accept) noexcept
	计算字符串开头包含在指定字符集中的字符数
template<typename CharT>
constexpr size_t	neforce::string_span_not_in (const CharT *str, const CharT *reject) noexcept
	计算字符串开头不包含在指定字符集中的字符数
template<typename CharT>
constexpr CharT *	neforce::string_set (CharT *str, const CharT value) noexcept
	将字符串中的所有字符设置为指定值
template<typename CharT>
constexpr CharT *	neforce::string_set (CharT *str, const CharT value, const size_t count) noexcept
	将字符串中的前n个字符设置为指定值
template<typename CharT>
constexpr CharT *	neforce::string_reverse (CharT *str) noexcept
	反转字符串
template<typename CharT>
constexpr CharT *	neforce::string_concatenate (CharT *__restrict dest, const CharT *__restrict src) noexcept
	连接两个字符串
template<typename CharT>
constexpr CharT *	neforce::string_concatenate (CharT *__restrict dest, const CharT *__restrict src, const size_t count) noexcept
	连接源字符串的前n个字符到目标字符串

详细描述

字符串操作函数的实现

函数说明

string_compare() [1/2]

template<typename CharT>

int neforce::string_compare ( const CharT * dest, const CharT * src )

constexprnoexcept

比较两个字符串

模板参数

CharT

字符类型

参数

dest	第一个字符串指针
src	第二个字符串指针

返回

比较结果

• 正数：第一个字符串大于第二个
• 负数：第一个字符串小于第二个
• 零：两个字符串相等

在文件 memory/memory.hpp 第 508 行定义.

引用了 string_compare().

被这些函数引用 neforce::base_char_traits< CharT, IntT >::compare(), string_compare() , 以及 string_compare().

string_compare() [2/2]

template<typename CharT>

int neforce::string_compare ( const CharT * dest, const CharT * src, const size_t count )

constexprnoexcept

比较两个字符串的前n个字符

模板参数

CharT

字符类型

参数

dest	第一个字符串指针
src	第二个字符串指针
count	要比较的字符数

返回

比较结果

在文件 memory/memory.hpp 第 541 行定义.

引用了 count() , 以及 string_compare().

string_compare_ignore_case() [1/2]

template<typename CharT>

int neforce::string_compare_ignore_case ( const CharT * s1, const CharT * s2 )

constexprnoexcept

忽略大小写比较两个字符串

模板参数

CharT

字符类型

参数

s1	第一个字符串指针
s2	第二个字符串指针

返回

比较结果

• 正数：第一个字符串大于第二个
• 负数：第一个字符串小于第二个
• 零：两个字符串相等

在文件 memory/memory.hpp 第 583 行定义.

引用了 string_compare_ignore_case() , 以及 to_lowercase().

被这些函数引用 string_compare_ignore_case() , 以及 string_compare_ignore_case().

string_compare_ignore_case() [2/2]

template<typename CharT>

int neforce::string_compare_ignore_case ( const CharT * s1, const CharT * s2, const size_t count )

constexprnoexcept

忽略大小写比较两个字符串的前n个字符

模板参数

CharT

字符类型

参数

s1	第一个字符串指针
s2	第二个字符串指针
count	要比较的字符数

返回

比较结果

在文件 memory/memory.hpp 第 618 行定义.

引用了 count(), string_compare_ignore_case() , 以及 to_lowercase().

string_concatenate() [1/2]

template<typename CharT>

CharT * neforce::string_concatenate ( CharT *__restrict dest, const CharT *__restrict src )

constexprnoexcept

连接两个字符串

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针

返回

目标字符串指针

注解

目标字符串指针必须有足够空间

在文件 memory/memory.hpp 第 998 行定义.

引用了 string_concatenate().

被这些函数引用 string_concatenate() , 以及 string_concatenate().

string_concatenate() [2/2]

template<typename CharT>

CharT * neforce::string_concatenate ( CharT *__restrict dest, const CharT *__restrict src, const size_t count )

constexprnoexcept

连接源字符串的前n个字符到目标字符串

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针
count	要连接的最大字符数

返回

目标字符串指针

注解

目标字符串指针必须有足够空间

在文件 memory/memory.hpp 第 1026 行定义.

引用了 count() , 以及 string_concatenate().

string_copy() [1/2]

template<typename CharT>

CharT * neforce::string_copy ( CharT *__restrict dest, const CharT *__restrict src )

constexprnoexcept

复制字符串

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针

返回

目标字符串指针

注解

使用restrict关键字优化，要求源和目标内存不重叠，否则将产生未定义行为。

将源字符串复制到目标缓冲区，包括终止空字符。 如果任一指针为空，返回空指针。

在文件 memory/memory.hpp 第 392 行定义.

引用了 string_copy().

被这些函数引用 neforce::exception::exception(), string_copy() , 以及 string_copy().

string_copy() [2/2]

template<typename CharT>

CharT * neforce::string_copy ( CharT *__restrict dest, const CharT *__restrict src, const size_t count )

constexprnoexcept

复制指定长度的字符串

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针
count	要复制的最大字符数

返回

目标字符串指针

复制最多 count 个字符，如果源字符串长度小于 count，用空字符填充剩余位置。 如果源字符串长度大于等于 count，不会自动添加终止空字符。

注解

使用restrict关键字优化，要求源和目标内存不重叠，否则将产生未定义行为。

在文件 memory/memory.hpp 第 420 行定义.

引用了 count() , 以及 string_copy().

string_copy_offset() [1/2]

template<typename CharT>

CharT * neforce::string_copy_offset ( CharT *__restrict dest, const CharT *__restrict src )

constexprnoexcept

复制字符串并返回指向结尾的指针

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针

返回

指向目标字符串结尾的指针，终止空字符之前

注解

使用restrict关键字优化，要求源和目标内存不重叠，否则将产生未定义行为。

在文件 memory/memory.hpp 第 452 行定义.

引用了 string_copy_offset().

被这些函数引用 string_copy_offset() , 以及 string_copy_offset().

string_copy_offset() [2/2]

template<typename CharT>

CharT * neforce::string_copy_offset ( CharT *__restrict dest, const CharT *__restrict src, const size_t count )

constexprnoexcept

复制指定长度的字符串并返回指向结尾的指针

模板参数

CharT

字符类型

参数

dest	目标字符串指针
src	源字符串指针
count	要复制的最大字符数

返回

指向目标字符串第 count 个字符的指针

注解

使用restrict关键字优化，要求源和目标内存不重叠，否则将产生未定义行为。

在文件 memory/memory.hpp 第 475 行定义.

引用了 count() , 以及 string_copy_offset().

string_find() [1/2]

template<typename CharT>

const CharT * neforce::string_find ( const CharT * str, const CharT chr )

constexprnoexcept

查找字符在字符串中首次出现的位置

模板参数

CharT

字符类型

参数

str	字符串指针
chr	要查找的字符

返回

指向首次出现位置的指针，未找到或输入为空时返回空指针

在文件 memory/memory.hpp 第 700 行定义.

引用了 string_find().

被这些函数引用 neforce::base_char_traits< CharT, IntT >::find(), string_find() , 以及 string_find().

string_find() [2/2]

template<typename CharT>

const CharT * neforce::string_find ( const CharT * str, const CharT chr, const size_t count )

constexprnoexcept

在前n个字符中查找字符首次出现的位置

模板参数

CharT

字符类型

参数

str	字符串指针
chr	要查找的字符
count	要搜索的最大字符数

返回

指向首次出现位置的指针

在文件 memory/memory.hpp 第 725 行定义.

引用了 count() , 以及 string_find().

string_find_any()

template<typename CharT>

CharT * neforce::string_find_any ( CharT * str, const CharT * accept )

constexprnoexcept

查找字符串中第一个出现在指定字符集中的字符

模板参数

CharT

字符类型

参数

str	字符串指针
accept	字符集指针

返回

指向第一个匹配字符的指针，未找到时返回空指针

在文件 memory/memory.hpp 第 773 行定义.

引用了 string_find_any().

被这些函数引用 string_find_any().

string_find_last()

template<typename CharT>

const CharT * neforce::string_find_last ( const CharT * str, const CharT chr )

constexprnoexcept

查找字符在字符串中最后出现的位置

模板参数

CharT

字符类型

参数

str	字符串指针
chr	要查找的字符

返回

指向最后出现位置的指针，未找到或输入为空时返回空指针

在文件 memory/memory.hpp 第 750 行定义.

引用了 string_find_last().

被这些函数引用 string_find_last().

string_find_pattern()

template<typename CharT>

const CharT * neforce::string_find_pattern ( const CharT * dest, const CharT * src )

constexprnoexcept

查找子字符串在字符串中首次出现的位置

模板参数

CharT

字符类型

参数

dest	主字符串指针
src	子字符串指针

返回

指向子字符串首次出现位置的指针，未找到时返回空指针

在文件 memory/memory.hpp 第 799 行定义.

引用了 string_find_pattern().

被这些函数引用 string_find_pattern().

string_find_pattern_ignored_case()

template<typename CharT>

const CharT * neforce::string_find_pattern_ignored_case ( const CharT * dest, const CharT * src )

constexprnoexcept

忽略大小写查找子字符串在字符串中首次出现的位置

模板参数

CharT

字符类型

参数

dest	主字符串指针
src	子字符串指针

返回

指向子字符串首次出现位置的指针

在文件 memory/memory.hpp 第 827 行定义.

引用了 string_find_pattern_ignored_case() , 以及 to_lowercase().

被这些函数引用 string_find_pattern_ignored_case().

string_length() [1/2]

template<typename CharT>

size_t neforce::string_length ( const CharT * str )

constexprnoexcept

计算字符串长度

模板参数

CharT

字符类型

参数

str

字符串指针

返回

字符串长度，不包含终止空字符

在文件 memory/memory.hpp 第 660 行定义.

引用了 is_character_v , 以及 string_length().

被这些函数引用 neforce::base_char_traits< CharT, IntT >::length(), string_length() , 以及 string_length().

string_length() [2/2]

template<typename CharT>

size_t neforce::string_length ( const CharT * str, const size_t max_len )

constexprnoexcept

计算字符串的最大长度

模板参数

CharT

字符类型

参数

str	字符串指针
max_len	最大搜索长度

返回

字符串长度，不超过max_len

计算字符串长度，但最多检查max_len个字符。

在文件 memory/memory.hpp 第 682 行定义.

引用了 string_length().

string_reverse()

template<typename CharT>

CharT * neforce::string_reverse ( CharT * str )

constexprnoexcept

反转字符串

模板参数

CharT

字符类型

参数

str

字符串指针

返回

反转后的字符串指针

在文件 memory/memory.hpp 第 969 行定义.

引用了 end() , 以及 string_reverse().

被这些函数引用 string_reverse().

string_set() [1/2]

template<typename CharT>

CharT * neforce::string_set ( CharT * str, const CharT value )

constexprnoexcept

将字符串中的所有字符设置为指定值

模板参数

CharT

字符类型

参数

str	字符串指针
value	要设置的字符值

返回

原字符串指针

在文件 memory/memory.hpp 第 931 行定义.

引用了 string_set().

被这些函数引用 neforce::base_char_traits< CharT, IntT >::assign(), string_set() , 以及 string_set().

string_set() [2/2]

template<typename CharT>

CharT * neforce::string_set ( CharT * str, const CharT value, const size_t count )

constexprnoexcept

将字符串中的前n个字符设置为指定值

模板参数

CharT

字符类型

参数

str	字符串指针
value	要设置的字符值
count	要设置的字符数

返回

原字符串指针

在文件 memory/memory.hpp 第 952 行定义.

引用了 count() , 以及 string_set().

string_span_in()

template<typename CharT>

size_t neforce::string_span_in ( const CharT * str, const CharT * accept )

constexprnoexcept

计算字符串开头包含在指定字符集中的字符数

模板参数

CharT

字符类型

参数

str	字符串指针
accept	字符集指针

返回

开头连续出现在字符集中的字符数

在文件 memory/memory.hpp 第 865 行定义.

引用了 string_span_in().

被这些函数引用 string_span_in().

string_span_not_in()

template<typename CharT>

size_t neforce::string_span_not_in ( const CharT * str, const CharT * reject )

constexprnoexcept

计算字符串开头不包含在指定字符集中的字符数

模板参数

CharT

字符类型

参数

str	字符串指针
reject	排除字符集指针

返回

开头连续不出现在排除字符集中的字符数

在文件 memory/memory.hpp 第 897 行定义.

引用了 string_span_not_in().

被这些函数引用 string_span_not_in().