PHP 字符串 wordwrap() 函数

2024年9月4日 | 3 分钟阅读

wordwrap() 字符串函数是 PHP 的一个内置函数。它用于使用字符串换行符将字符串包装到给定数量的字符。PHP 4.0.2以上版本支持此函数。简单来说,当字符串达到给定长度时,它会将字符串换行到新行。

注意:此函数可能会在行首留下空格。

语法

wordwrap() 函数的语法如下,它接受四个参数。

参数

wordwrap() 函数接受四个参数,其中只有 $string 参数是必须传递的,其他三个参数是可选的。这些参数将在下面详细讨论

$string (必需):这是此函数的强制参数。它指定需要断开成行的输入字符串。

$width (可选):这是此函数的可选参数。它指定最大行宽。默认情况下,它取 75。

$break (可选):这是此函数的可选参数。它提供一个字符作为断行符。默认是 "\n"。

$cut (可选):这也是此函数的一个可选参数,其中包含布尔值。默认情况下,wordwrap() 将此参数的布尔值设置为 "FALSE"

  • 如果此参数的值设置为"TRUE",则字符串将始终在指定宽度处或之前换行。因此,如果单词宽度大于给定的 $width,则它会被断开(参见示例 3)。
  • 如果值为"FALSE",则即使单词宽度大于 $width,该函数也不会拆分单词。

返回值

wordwrap() 函数返回按指定长度包装的字符串,即成功时字符串会断开成行,失败时返回 FALSE。

Changelog

$cut 参数是在 PHP 4.0.3 中添加的。

示例

有一些示例,通过这些示例我们可以了解 wordwrap() 函数的工作原理。让我们看看下面的示例

示例 1

输出

在上面的示例中,字符串每隔个字符就被换行符断开。在这里,我们没有传递 $cut 参数。

An example
of the
wordwrap()
function
to break
the string

注意:当未将第四个参数作为 TRUE 传递时,即使给定宽度小于单词宽度,此函数也不会从中间断开单词。

示例 2

输出

在此示例中,我们没有从给定宽度(即 8)处断开“Congratulations”一词,因为此函数不会在中间断开字符。

Congratulations!
to all

示例 3:当 $cut 作为 "TRUE" 传递时

输出

在此示例中,我们从给定宽度(即 8)处断开“Congratulations”一词,并传递了值为 TRUE 的 $cut 参数。因此此函数每隔八个字符就断开字符串。

Congratu
lations!
to all

示例 4:当 $cut 作为 "FALSE" 传递时

输出

Be a
part of
javatpoint

下一个主题PHP 字符串函数