字符串组件
编辑本页警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 5.2，现已不再维护。
读本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。
字符串组件
String组件提供了一个面向对象的API来处理字符串的三种“单位系统”:字节、码点和字素簇。
5．0
String组件是在Symfony 5.0中引入的。欧宝娱乐app下载地址
安装
1
＄作曲家需要symfony/字符串欧宝娱乐app下载地址请注意
如果在Symfony应用程序外部安装此组件，则必须要求欧宝娱乐app下载地址供应商/ autoload.php文件，以启用Composer提供的类自动加载机制。读这篇文章欲知详情。
什么是字符串?
如果你已经知道什么是a，你可以跳过这部分“代码点”或者一个“字形集群”都在处理字符串的上下文中。否则，请阅读本节以了解此组件使用的术语。
像英语这样的语言需要非常有限的字符和符号集来显示任何内容。每个字符串都是一系列字符(字母或符号)，它们甚至可以用最有限的标准进行编码(例如。美国信息交换标准代码)．
然而，其他语言需要数千个符号来显示其内容。它们需要复杂的编码标准，例如Unicode像“性格”这样的概念也不再有意义。相反，你必须处理这些术语:
- 代码点:它们是信息的原子单位。字符串是一系列的码位。每个码位都是一个数字，其含义由Unicode标准。例如，英文字母
一个是U + 0041密码点和日本人假名の是U + 306 e代码点。 - 字形集群:它们是一个或多个编码点的序列，以单个图形单元显示。例如，西班牙字母
n是包含两个编码点的字素簇:U + 006 e＝n（拉丁小字母N) +U + 0303＝◌̃（“结合波浪号”)． - 字节:它们是为字符串内容存储的实际信息。根据使用的标准(UTF-8、UTF-16等)，每个码位可能需要一个或多个字节的存储空间。
下图显示同一个英文单词的字节、码位和字素簇(你好)和印地语(नमस्ते)：
使用
创建一个类型的新对象ByteString，CodePointString或UnicodeString，将字符串内容作为参数传递，然后使用面向对象的API来处理这些字符串:
12 3 4 5 6 7 8 9 10 11 12
使用欧宝娱乐app下载地址＼组件＼字符串＼UnicodeString；＄文本= (新UnicodeString (“这是一个déjà-vu的情况。”）)->trimEnd (“。”）->替换(“似曾相识”，“旧事如新”）->追加(“!”）;// $text = '这是一个jamais-vu的情况!'＄内容＝新UnicodeString (“नमस्तेदुनिया”）;如果（＄内容->ignoreCase ()->startsWith (“नमस्ते”)) {/ /……｝方法引用
创建字符串对象的方法
首先，你可以用下面的类创建对象，准备将字符串存储为字节、代码点和字形集群:
1 2 3 4 5 6 7 8
使用欧宝娱乐app下载地址＼组件＼字符串＼ByteString；使用欧宝娱乐app下载地址＼组件＼字符串＼CodePointString；使用欧宝娱乐app下载地址＼组件＼字符串＼UnicodeString；＄喷火＝新ByteString (“你好”）;＄酒吧＝新CodePointString (“你好”）;UnicodeString是最常用的类＄巴兹＝新UnicodeString (“你好”）;使用包装()实例化多个字符串对象的静态方法:
1 2 3 4 5 6 7
＄内容= ByteString：：包装([“你好”，“世界”]);// $contents = ByteString[]＄内容= UnicodeString：：包装([“我”，“❤️”，S欧宝娱乐app下载地址ymfony的]);// $contents = UnicodeString[]//使用unwrap方法进行反向转换＄内容= UnicodeString：：打开([新UnicodeString (“你好”)，新UnicodeString (“世界”)));// $contents = ['hello'， 'world']如果你使用大量的String对象，考虑使用快捷函数使你的代码更简洁:
12 3 4 5 6 7 8 9 10 11 12 13 14 16 17 18 19 20 21 22
// b()函数创建字节字符串使用函数欧宝娱乐app下载地址＼组件＼字符串＼b；//这两行是等价的＄喷火＝新ByteString (“你好”）;＄喷火= b (“你好”）;// u()函数创建Unicode字符串使用函数欧宝娱乐app下载地址＼组件＼字符串＼u；//这两行是等价的＄喷火＝新UnicodeString (“你好”）;＄喷火= u (“你好”）;// s()函数创建字节字符串或Unicode字符串//取决于给定的内容使用函数欧宝娱乐app下载地址＼组件＼字符串＼年代；//创建ByteString对象＄喷火= (以“\ xfe \ xff”）;//创建UnicodeString对象＄喷火= (“अनुच्छेद”）;5.1
的年代()函数在Symfony 5.1中引入。欧宝娱乐app下载地址
还有一些专门的构造函数:
1 2 3 4 5 6 7 8 9 10
// ByteString可以创建给定长度的随机字符串＄喷火= ByteString：：fromRandom (12）;//默认情况下，随机字符串使用A-Za-z0-9字符;你可以限制//用于第二个可选参数的字符＄喷火= ByteString：：fromRandom (6，“AEIOU0123456789”）;＄喷火= ByteString：：fromRandom (10，“qwertyuiop”）;// CodePointString和UnicodeString可以从代码点创建字符串＄喷火= UnicodeString：：fromCodePoints (0 x928，0 x92e，0 x938，0 x94d，0 x924，0 x947）;/ /相当于:$ foo = new UnicodeString(“नमस्ते”);5.1
第二个论点ByteString: fromRandom ()在Symfony 5.1中引入。欧宝娱乐app下载地址
转换字符串对象的方法
每个字符串对象都可以转换为其他两种类型的对象:
1 2 3 4 5 6 7 8
＄喷火= ByteString：：fromRandom (12）->toCodePointString ();＄喷火= (新CodePointString (“你好”）)->toUnicodeString ();＄喷火= UnicodeString：：fromCodePoints (0 x68，0 x65，0 x6c，0 x6c，0 x6f）->toByteString ();//可选的$toEncoding参数定义目标字符串的编码＄喷火= (新CodePointString (“你好”）)->toByteString (“windows - 1252”）;//可选的$fromEncoding参数定义原始字符串的编码＄喷火= (新ByteString (“さよなら”）)->toCodePointString (“iso - 2022 - jp”）;如果由于任何原因无法进行转换，您将得到一个InvalidArgumentException．
还有一个方法可以获取存储在某个位置的字节:
1 2 3 4 5 6 7
/ /(“नमस्ते的字节数= (224,164,168,224,164,174,224,164,184,// 224, 165, 141, 224, 164, 164, 224, 165, 135])b (“नमस्ते”）->bytesAt (0）;/ / [224]u (“नमस्ते”）->bytesAt (0）;// [224, 164, 168]b (“नमस्ते”）->bytesAt (1）;/ / [164]u (“नमस्ते”）->bytesAt (1）;// [224, 164, 174]与长度和空白有关的方法
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
//返回给定字符串的字母数、码位或字节数＄词＝“नमस्ते”；（新ByteString (＄词）)->长度();// 18(字节)（新CodePointString (＄词）)->长度();// 6(代码点)（新UnicodeString (＄词）)->长度();// 4 (graphemes)//一些符号需要两倍于其他符号的宽度来表示它们//等宽字体(例如在控制台中)。该方法返回总宽度//需要表示整个单词＄词＝“नमस्ते”；（新ByteString (＄词）)->宽度();/ / 18（新CodePointString (＄词）)->宽度();/ / 4（新UnicodeString (＄词）)->宽度();/ / 4//如果文本包含多行，则返回所有行的最大宽度＄文本＝"<<；u (＄文本）->宽度();/ / 14//如果字符串恰好是空字符串(甚至不是空格)只返回TRUEu (“hello world”）->isEmpty ();/ /错误u (＇ ＇）->isEmpty ();/ /错误u (＇＇）->isEmpty ();/ /正确的//删除字符串开头和结尾的所有空格，并替换两个空格//或由单个空格组成多个连续空格u (“\n\n hello world \n\n”）->collapseWhitespace ();// 'hello world' 变更案例的方法
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23
//更改所有字母/代码点为小写u (“FOO酒吧”）->低();// 'foo bar'//当处理不同的语言时，大写/小写是不够的//有三种大小写(lower, upper, title)，有些字符没有大小写，// case是上下文敏感的和区域敏感的，等等。//该方法返回一个字符串，用于不区分大小写的比较u (“FOO酒吧”）->折叠();// 'foo bar'u (布莱恩·斯特拉ße）->折叠();// "die o 'Brian strasse"//更改所有字母/代码点为大写u (“foo酒吧”）->上();// ' foo bar '//更改所有字母/代码点为"title case"u (“foo酒吧”）->标题();// 'Foo bar'u (“foo酒吧”）->标题(真正的）;// 'Foo Bar'//更改所有字母/代码点为camelCaseu (“Foo: bar baz。”）->骆驼();/ /“fooBarBaz”//更改所有字母/代码点为snake_caseu (“Foo: bar baz。”）->蛇();/ /“foo_bar_baz”//其他情况可以通过链接方法实现。例如PascalCase:u (“Foo: bar baz。”）->骆驼()->标题();/ /“FooBarBaz”默认情况下，所有字符串类的方法都是区分大小写的。属性可以执行不区分大小写的操作ignoreCase ()方法:
1 2
u (“abc”）->indexOf (“B”）;/ /空u (“abc”）->ignoreCase ()->indexOf (“B”）;/ / 1方法追加和Prepend
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
//在字符串的开头/结尾添加给定的内容(一个或多个字符串)u (“世界”）->预先考虑(“你好”）;/ /“helloworld”u (“世界”）->预先考虑(“你好”，＇ ＇）;// 'hello world'u (“你好”）->追加(“世界”）;/ /“helloworld”u (“你好”）->追加(＇ ＇，“世界”）;// 'hello world'//将给定的内容添加到字符串的开头(或删除它)//确保内容完全以该内容开始u (“名字”）->ensureStart (“得到”）;/ /“getName”u (getName的）->ensureStart (“得到”）;/ /“getName”u (“getgetName”）->ensureStart (“得到”）;/ /“getName”//此方法类似，但作用于内容的末尾而不是开头u (“用户”）->ensureEnd (“控制器”）;/ /用户控件的u (“用户”）->ensureEnd (“控制器”）;/ /用户控件的u (“UserControllerController”）->ensureEnd (“控制器”）;/ /用户控件的//返回给定字符串第一次出现之前/之后找到的内容u (“hello world”）->(之前“世界”）;// 'hello 'u (“hello world”）->(之前“o”）;/ /“地狱”u (“hello world”）->(之前“o”，真正的）;/ / '你好'u (“hello world”）->后(“你好”）;// ' world'u (“hello world”）->后(“o”）;// ' world'u (“hello world”）->后(“o”，真正的）;// 'o world'//返回在给定字符串最后出现之前/之后找到的内容u (“hello world”）->beforeLast (“o”）;// 'hello w'u (“hello world”）->beforeLast (“o”，真正的）;// 'hello wo'u (“hello world”）->afterLast (“o”）;/ /“行”u (“hello world”）->afterLast (“o”，真正的）;/ /“上”衬垫和修剪方法
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
//通过添加给定的参数使字符串与第一个参数一样长//字符串的开头、结尾或两端u (《Lorem Ipsum》）->padBoth (20.，“- - -”）;// '——Lorem Ipsum ----'u (《Lorem Ipsum》）->padStart (20.，“- - -”）;// '-------- Lorem Ipsum'u (《Lorem Ipsum》）->padEnd (20.，“- - -”）;// 'Lorem Ipsum --------'//重复给定字符串作为参数传递的次数u (“_”。）->重复(10）;// '_._._._._._._._._._.'//从字符串中删除给定字符(默认为空格)u (《Lorem Ipsum》）->削减();// 'Lorem Ipsum'u (《Lorem Ipsum》）->削减(“米”）;// 'Lorem Ipsum 'u (“回车键”）->削减(“米”）;// 'Lorem Ipsu'u (《Lorem Ipsum》）->trimStart ();// 'Lorem Ipsum 'u (《Lorem Ipsum》）->trimEnd ();// ' Lorem Ipsum'搜索和替换方法
12 34 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
//检查字符串是否以给定的字符串开始/结束u (“https://欧宝娱乐app下载地址www.oldmanjams.com”）->startsWith (“https”）;/ /正确的u (“报告- 1234. - pdf”）->endsWith (pdf格式的）;/ /正确的//检查字符串内容是否与给定内容完全相同u (“foo”）->equalsTo (“foo”）;/ /正确的//检查字符串内容是否匹配给定的正则表达式u (“阿凡达- 73647. png”）->匹配(' /阿凡达(\ d +) \ . png / '）;// result = ['avatar-73647.png'， '73647']//检查字符串是否包含任何其他给定的字符串u (“五个母音字母）->containsAny (“一个”）;/ /正确的u (“五个母音字母）->containsAny ([“ab”，“efg”]);/ /错误u (“五个母音字母）->containsAny ([“eio”，“foo”，“z”]);/ /正确的//查找给定字符串第一个出现的位置//(第二个参数是搜索开始的位置，为负//值的含义与PHP函数相同)u (“abcdeabcde”）->indexOf (“c”）;/ / 2u (“abcdeabcde”）->indexOf (“c”，2）;/ / 2u (“abcdeabcde”）->indexOf (“c”，4）;/ / 7u (“abcdeabcde”）->indexOf (“eab”）;/ / 4u (“abcdeabcde”）->indexOf (“k”）;/ /空//查找给定字符串最后出现的位置//(第二个参数是搜索开始的位置，为负//值的含义与PHP函数相同)u (“abcdeabcde”）->indexOfLast (“c”）;/ / 7u (“abcdeabcde”）->indexOfLast (“c”，2）;/ / 7u (“abcdeabcde”）->indexOfLast (“c”，4）;/ / 2u (“abcdeabcde”）->indexOfLast (“eab”）;/ / 4u (“abcdeabcde”）->indexOfLast (“k”）;/ /空//替换所有给定字符串的出现u (“http://欧宝娱乐app下载地址www.oldmanjams.com”）->替换(“http://”，“https://”）;/ / ' https:欧宝娱乐app下载地址//www.oldmanjams.com '//替换所有给定正则表达式的出现u (“(+ 1)206-555-0100”）->replaceMatches (' / [^ A-Za-z0-9] + + / '，＇＇）;/ /“12065550100”//你可以传递一个可调用对象作为第二个参数来执行高级替换u (“123”）->replaceMatches (' / \ d / '，函数（＄匹配）｛返回“(”．＄匹配［0]。“]”；})；// result = '[1][2][3]'5.1
的containsAny ()方法在Symfony 5.1中引入。欧宝娱乐app下载地址
方法连接，分裂，截断和反向
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
//使用字符串作为“胶水”来合并所有给定的字符串u (”、“）->加入([“foo”，“酒吧”]);// 'foo, bar'//使用给定的分隔符将字符串分割成多个部分u (“template_name.html.twig”）->分(“。”）;// ['template_name'， 'html'， 'twig']//你可以将最大件数设置为第二个参数u (“template_name.html.twig”）->分(“。”，2）;// ['template_name'， 'html.twig']//返回子字符串，该子字符串从第一个参数开始，长度为//第二个可选参数(负数的含义与PHP函数相同)u (“欧宝娱乐app下载地址Symfony很棒”）->片(0，7）;/ / 欧宝娱乐app下载地址Symfony的u (“欧宝娱乐app下载地址Symfony很棒”）->片(0，6）;// '欧宝娱乐app下载地址Symfony is'u (“欧宝娱乐app下载地址Symfony很棒”）->片(11）;/ /“伟大的”u (“欧宝娱乐app下载地址Symfony很棒”）->片(5）;/ /“伟大的”//将字符串缩小到参数所给出的长度(如果它更长)u (“回车键”）->截断(3.）;/ /“卤”u (“回车键”）->截断(80）;// 'Lorem Ipsum'//第二个参数是字符串被截断时添加的字符//(总长度包括该字符的长度)u (“回车键”）->截断(8，'...'）;//“Lorem I…”//如果第三个参数为假，则保留剪切前的最后一个词//即使生成的字符串比期望的长度长u (“回车键”）->截断(8，'...'，假）;// 'Lorem Ipsum'5.1
第三个论点截断()在Symfony 5.1中引入。欧宝娱乐app下载地址
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
//将字符串分解成给定长度的行u (“回车键”）->自动换行(4）;/ /“Lorem \ nIpsum”//默认为空格;pass TRUE无条件中断u (“回车键”）->自动换行(4，“\ n”，真正的）;/ /“传说\ \ nIpsu \ nm”//用给定的内容替换字符串的一部分://第二个参数是替换开始的位置;//第三个参数是从字符串中移除的字素/码位u (“0123456789”）->接头(“xxx”）;/ /“xxx”u (“0123456789”）->接头(“xxx”，0，2）;/ /“xxx23456789”u (“0123456789”）->接头(“xxx”，0，6）;/ /“xxx6789”u (“0123456789”）->接头(“xxx”，6）;/ /“012345 xxx”//将字符串分解成参数中给定长度的片段u (“0123456789”）->块(3.）;// ['012'， '345'， '678'， '9']//颠倒字符串内容的顺序u (“foo酒吧”）->反向();// 'rab oof'u (“さよなら”）->反向();// 'らなよさ'5.1
的反向()方法在Symfony 5.1中引入。欧宝娱乐app下载地址
方法由ByteString添加
这些方法仅适用于ByteString对象:
1 2 3
//如果字符串内容是有效的UTF-8内容则返回TRUEb (“回车键”）->isUtf8 ();/ /正确的b (“\ xc3 \ x28”）->isUtf8 ();/ /错误由CodePointString和UnicodeString添加的方法
这些方法仅适用于CodePointString而且UnicodeString对象:
1 2 3 4 5 6 7 8 9 10 11
//将任意字符串音译为ASCII编码定义的拉丁字母//(不要使用这个方法来构建一个健壮器，因为这个组件已经提供了//一个击打者，如本文后面解释)u (“नमस्ते”）->ascii ();/ /“合十礼”u (“さよなら”）->ascii ();/ /“再会”u (“спасибо”）->ascii ();/ /“spasibo”//返回一个数组，其中包含存储在给定位置的代码点// ('नमस्ते' graphemes = [2344,2350,2360,2340]u (“नमस्ते”）->codePointsAt (0）;/ / [2344]u (“नमस्ते”）->codePointsAt (2）;/ / [2360]Unicode等价是Unicode标准规定，不同的码位序列表示相同的字符。例如，瑞典字母一个可以是单个代码点(U + 00 e5＝"拉丁小字母A，上面带环")或两个码位的序列(U + 0061＝拉丁小字母A+U + 030＝“以上组合环”)．的normalize ()方法允许选择归一化模式:
1 2 3 4 5 6
//这些代码将字母编码为单个编码点:U+00E5u (“一个”）->(UnicodeString正常化：：NFC);u (“一个”）->(UnicodeString正常化：：NFKC);//它们将字母编码为两个编码点:U+0061 + U+030Au (“一个”）->(UnicodeString正常化：：NFD);u (“一个”）->(UnicodeString正常化：：NFKD);重击者
在某些上下文中，例如url和文件/目录名，使用任何Unicode字符都不安全。一个重击者将一个给定的字符串转换为另一个只包含安全ASCII字符的字符串:
12 3 4 5 6 7 8 9 10 11 12 13 14 15
使用欧宝娱乐app下载地址＼组件＼字符串＼重击者＼AsciiSlugger；＄重击者＝新AsciiSlugger ();＄鼻涕虫＝＄重击者->蛞蝓(“磨破ķšƥ高手~ ~ seť锡ğš~ ~”）;// $slug = '工作区设置'//你也可以传递一个包含额外字符替换的数组＄重击者＝新AsciiSlugger (“en”, (“en”= > [“%”= >“百分比”，“€”= >“欧元”]]);＄鼻涕虫＝＄重击者->蛞蝓(“10%或5欧元”）;// $slug = ' 10% or 5-euro'//为了获得更多的动态替换，传递一个PHP闭包而不是数组＄重击者＝新AsciiSlugger (“en”，函数（＄字符串，＄语言环境）｛返回(大小写不敏感“❤️”，“爱”，＄字符串）;})；5.1
定义额外替换的特性是在Symfony 5.1中引入的。欧宝娱乐app下载地址
5.2
使用PHP闭包定义替换的特性是在Symfony 5.2中引入的。欧宝娱乐app下载地址
单词之间的分隔符是破折号(-)，但你可以定义另一个分隔符作为第二个参数:
1 2
＄鼻涕虫＝＄重击者->蛞蝓(“磨破ķšƥ高手~ ~ seť锡ğš~ ~”，' / '）;// $slug = 'Workspace/settings'重击器在应用其他转换之前将原始字符串音译为拉丁脚本。原始字符串的区域设置是自动检测的，但是你可以显式地定义它:
1 2 3 4 5
//这告诉击打者从韩语音译＄重击者＝新AsciiSlugger (“柯”）;//你可以覆盖locale作为slug()的第三个可选参数＄鼻涕虫＝＄重击者->蛞蝓('...'，“- - -”，“足”）;在Symf欧宝娱乐app下载地址ony应用程序中，您不需要自己创建重击器。多亏了服务自动装配，可以通过使用服务构造函数参数的类型提示来注入重击器SluggerInterface．注入的重击器的语言环境与请求的语言环境相同:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用欧宝娱乐app下载地址＼组件＼字符串＼重击者＼SluggerInterface；类MyService｛私人＄重击者；公共函数__construct(SluggerInterface＄重击者）｛＄这->棒球强击手=＄重击者；｝公共函数someMethod（）｛＄鼻涕虫＝＄这->重击者->蛞蝓('...'）;}}弯曲物
5.1
inflector特性是在Symfony 5.1中引入的。欧宝娱乐app下载地址
在一些场景中，例如代码生成和代码自省，您需要将单词从/转换为单数/复数。例如，要了解与加法器方法时，必须将复数形式(addStories ()方法)到奇异(美元的故事属性)。
大多数人类语言都有简单的复数规则，但同时也定义了很多例外。例如，英语的一般规则是加一个年代在单词的末尾(书->书)但即使是常用词也有很多例外(女人->女性，生活->生活，欧宝app在哪里找->欧宝app在哪里找，半径->半径等)。
此组件提供EnglishInflector类转换英语单词从/到单数/复数与信心:
1 2 3 4 5 6 7 8 9 10 11
使用欧宝娱乐app下载地址＼组件＼字符串＼弯曲物＼EnglishInflector；＄弯曲物＝新EnglishInflector ();＄结果＝＄弯曲物->使显著(“牙齿”）;/ /(“牙”)＄结果＝＄弯曲物->使显著(“半径”）;/ /(“半径”)＄结果＝＄弯曲物->使显著(“叶子”）;// ['leaf'， 'leave'， 'leaff']＄结果＝＄弯曲物->兼职(“细菌”）;/ /(“细菌”)＄结果＝＄弯曲物->兼职(“欧宝app在哪里找新闻”）;/ /(“欧宝app在哪里找新闻”)＄结果＝＄弯曲物->兼职(“人”）;// ['persons'， 'people']这两个方法返回的值总是一个数组，因为有时不可能确定给定单词的唯一单数/复数形式。
此工作，包括代码示例，是根据创作共用BY-SA 3.0许可证。
