README

Jitsu\StringUtil类是一组用于处理PHP字符串的静态方法。

为什么？因为PHP许多内置的字符串函数命名不佳，接口尴尬，并且将某些有争议的有效边缘情况视为错误。

StringUtil解决了这些问题，提供了一个更直观的接口来访问标准的PHP字符串函数，同时提供了内置库中缺少的功能。

该软件包是Jitsu项目的一部分。

安装

使用Composer安装此软件包

composer require jitsu/string

测试

按照以下方式运行单元测试套件

composer install
./vendor/bin/phpunit test/

命名空间

该类在命名空间Jitsu下定义。

API

class Jitsu\StringUtil

处理字符串的静态方法集合。

不区分大小写的函数命名与它们的区分大小写的对应函数相同，通过在字母前加前缀i。

StringUtil::length($s)

返回字符串的长度。

这相当于字符串中的字节数。

StringUtil::size($s)

length的别名。参见\Jitsu\StringUtil::length()。

StringUtil::isEmpty($s)

确定一个字符串是否为空。

StringUtil::equal($a, $b)

返回两个字符串是否相等。

StringUtil::iEqual($a, $b)

与equal类似，但不区分大小写。

StringUtil::chars($s)

返回字符串中的字符数组。

StringUtil::chunks($s, $n)

将字符串分割为长度为$n的块。

每个块都是一个顺序数组。最后一个块可能包含1到$n个字符。

StringUtil::split($s, $delim = null, $limit = null)

通过分隔符将字符串分割成字符串数组。

StringUtil::tokenize($s, $chars)

将字符串分割成标记。

StringUtil::join($sep, $strs = null)

使用分隔符将数组元素连接成单个字符串。

StringUtil::trim($s, $chars = null)

从字符串的开始和结束处移除字符。

StringUtil::rtrim($s, $chars = null)

从字符串的末尾移除字符。

StringUtil::ltrim($s, $chars = null)

从字符串的开始处移除字符。

StringUtil::lower($s)

将字符串转换为小写。

StringUtil::upper($s)

将字符串转换为大写。

StringUtil::lcfirst($s)

将字符串的第一个字符转换为小写。

StringUtil::lowerFirst($s)

lcfirst的别名。参见\Jitsu\StringUtil::lcfirst()。

StringUtil::ucfirst($s)

将字符串的第一个字符转换为大写。

StringUtil::upperFirst($s)

ucfirst的别名。参见\Jitsu\StringUtil::ucfirst()。

StringUtil::capitalize($s)

ucfirst的别名。参见\Jitsu\StringUtil::ucfirst()。

StringUtil::ucwords($s)

将字符串中的所有单词首字母大写。

将任何出现在空白字符之后的字母字符转换为大写。

StringUtil::capitalizeWords($s)

ucwords的别名。参见\Jitsu\StringUtil::ucwords()。

StringUtil::replace($s, $old, $new)

替换所有子字符串实例。

只替换子字符串的非重叠实例。

StringUtil::replaceAndCount($s, $old, $new)

替换字符串并返回替换次数。

StringUtil::iReplace($s, $old, $new)

与replace类似，但不区分大小写。

参见\Jitsu\StringUtil::replace()。

StringUtil::iReplaceAndCount($s, $old, $new)

与replaceAndCount类似，但不区分大小写。

参见\Jitsu\StringUtil::replaceAndCount()。

StringUtil::replaceMultiple($s, $pairs)

一次执行多个子字符串替换。

允许一次性执行多个替换，这可能比连续执行单个字符串替换更有效。

将所有非重叠的 $pairs 键替换为其对应的值。

StringUtil::translate($s, $old, $new)

重置字符串中的字符。

$old 中列出的字符将更改为 $new 中列出的对应字符。

StringUtil::substring($s, $offset, $length = null)

给定偏移量和长度获取字符串的子串。

StringUtil::replaceSubstring($s, $new, $offset, $length = null)

将字符串的一部分替换为另一个字符串。

参见\Jitsu\StringUtil::replace()。

StringUtil::slice($s, $i, $j = null)

给定两个偏移量获取字符串的切片。

给定一个包含的起始索引和一个非包含的结束索引获取字符串的子串。负索引表示从字符串末尾的偏移量。

StringUtil::replaceSlice($s, $new, $i, $j = null)

将字符串的切片替换为另一个字符串。

如果起始索引在结束索引之后，则替换将插入到起始索引处。

参见 \Jitsu\StringUtil::slice()。

StringUtil::insert($s, $new, $offset)

在另一个字符串的给定偏移量处插入一个字符串。

StringUtil::pad($s, $n, $pad = ' ')

用另一个字符串填充字符串的开始和结束。

对称地填充字符串，以便结果长度为 $n 个字符。

StringUtil::lpad($s, $n, $pad = ' ')

用另一个字符串填充字符串的开始。

StringUtil::rpad($s, $n, $pad = ' ')

用另一个字符串填充字符串的结束。

StringUtil::wrap($s, $cols, $sep = "\n")

将字符串折叠到指定列数。

通过每隔 $cols 个字符插入字符串，将字符串“折叠”到固定列数。默认情况下插入换行符。

StringUtil::repeat($s, $n)

重复字符串 $n 次。

StringUtil::reverse($s)

反转字符串。

@param string

StringUtil::startingWith($s, $substr)

返回以另一个字符串开头的字符串的一部分。

结果包含指定的子串。

StringUtil::iStartingWith($s, $substr)

与 startingWith 类似，但大小写不敏感。

参见 \Jitsu\StringUtil::startingWith()。

StringUtil::rStartingWith($s, $char)

返回以某个字符开头的字符串的最后部分。

与 startingWith 不同，这仅适用于单个字符。

StringUtil::startingWithChars($s, $chars)

返回以一系列字符之一开头的字符串的最后部分。

StringUtil::preceding($s, $substr)

返回直到某个子串的字符串的一部分。

StringUtil::iPreceding($s, $substr)

与 preceding 类似，但大小写不敏感。

参见 \Jitsu\StringUtil::preceding()。

StringUtil::words($s, $chars = null)

将字符串拆分为单词。

构成单词字符的定义由当前区域设置确定。

StringUtil::wordCount($s, $chars = null)

计算字符串中的单词数。

参见 \Jitsu\StringUtil::words()。

StringUtil::findWords($s, $chars = null)

在字符串中定位单词。

返回一个数组，将字符串中单词的起始索引映射到相应的单词。

参见 \Jitsu\StringUtil::words()。

StringUtil::wordWrap($s, $width, $sep = "\n")

单词折叠字符串。

将字符串单词折叠到固定列数。超过最大宽度的单词将被拆分。

StringUtil::compare($a, $b)

按字典顺序比较两个字符串。

如果 $a 在 $b 之前，则返回负数；如果它们相同，则返回 0；如果 $a 在 $b 之后，则返回大于 0 的数字。