首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

preg_split

(PHP 4, PHP 5, PHP 7)

preg_split - 按正则表达式拆分字符串

描述

代码语言:javascript
复制
array preg_split ( string $pattern , string $subject [, int $limit = -1 [, int $flags = 0 ]] )

用正则表达式分割给定的字符串。

参数

pattern

作为字符串搜索的模式。

subject

输入字符串。

limit

如果指定,则只有子字符串达到极限才返回,其余字符串放在最后一个子字符串中。 限制为-1,0或NULL意味着“没有限制”,并且,对于PHP中的标准,您可以使用NULL跳至flags参数。

flags

flags可以是以下标志(与组合的任何组合|位运算符):

PREG_SPLIT_NO_EMPTY如果设置了此标志,preg_split()将只返回非空片段。 PREG_SPLIT_DELIM_CAPTURE如果设置了此标志,则分隔符模式中的括号表达式将被捕获并返回。PREG_SPLIT_OFFSET_CAPTURE

如果设置了此标志,则对于每次发生的匹配,附属字符串偏移量也将被返回。 请注意,这会更改数组中的返回值,其中每个元素都是由偏移量为0的匹配字符串组成的数组,并且它的字符串偏移量为偏移量为1的主体。

返回值

返回一个数组,其中包含沿着与pattern匹配的边界分割的主题的子字符串,或者失败时返回FALSE。

例子

示例#1 preg_split()示例:获取搜索字符串的各个部分

代码语言:javascript
复制
<?php
// split the phrase by any number of commas or space characters,
// which include " ", \r, \t, \n and \f
$keywords = preg_split("/[\s,]+/", "hypertext language, programming");
print_r($keywords);
?>

上面的例子将输出:

代码语言:javascript
复制
Array
(
    [0] => hypertext
    [1] => language
    [2] => programming
)

示例#2 将字符串拆分为组件字符

代码语言:javascript
复制
<?php
$str = 'string';
$chars = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($chars);
?>

上面的例子将输出:

代码语言:javascript
复制
Array
(
    [0] => s
    [1] => t
    [2] => r
    [3] => i
    [4] => n
    [5] => g
)

Example#3 将一个字符串分割成匹配及其偏移量

代码语言:javascript
复制
<?php
$str = 'hypertext language programming';
$chars = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($chars);
?>

上面的例子将输出:

代码语言:javascript
复制
Array
(
    [0] => Array
        (
            [0] => hypertext
            [1] => 0
        )

    [1] => Array
        (
            [0] => language
            [1] => 10
        )

    [2] => Array
        (
            [0] => programming
            [1] => 19
        )

)

注意

提示

如果你不需要正则表达式的力量,你可以选择更快(尽管比较简单),比如explode()或str_split()。

提示

如果匹配失败,将返回一个包含输入字符串的单个元素的数组。

扩展内容

  • preg_quote() - 引用正则表达式字符
  • implode() - 使用字符串加入数组元素
  • preg_match() - 执行正则表达式匹配
  • preg_match_all() - 执行全局正则表达式匹配
  • preg_replace() - 执行正则表达式搜索并替换
  • preg_last_error() - 返回上一次PCRE正则表达式执行的错误代码

← preg_replace

扫码关注腾讯云开发者

领取腾讯云代金券