當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


PHP String wordwrap()用法及代碼示例


wordwrap() 字符串函數是 PHP 的內置函數。它用於使用字符串分隔符將字符串包裝到給定數量的字符。 PHP 4.0.2 及以上版本支持此函數。簡單來說,當字符串達到給定的長度時,它會將字符串包裝成新行。

注意:此函數可能會在行首留下空格。

用法

wordwrap() 函數的語法如下所示,它接受四個參數。

wordwrap ($string, $width, $break, $cut)

參數

wordwrap() 函數接受四個參數,其中隻有 $string 參數是強製傳遞的,其他三個參數是可選的。下麵詳細討論這些論點:

$string(必填):它是這個函數的一個強製性參數。它指定需要分解成行的輸入字符串。

$width(可選):該函數的可選參數。它指定最大線寬。默認情況下,它需要 75。

$break(可選):該函數的可選參數。它提供了一個用作休息的字符。默認為 "\n"。

$cut(可選):也是本函數的可選參數,包含布爾值。默認情況下,wordwrap() 將此參數的布爾值作為 "FALSE":

  • 如果此參數的值設置為 "TRUE",則字符串將始終在指定寬度處或之前換行。因此,如果字寬大於給定的 $width,則將其分解(參見示例 3)。
  • 如果值為"FALSE",則即使字寬大於$width,函數也不會拆分字。

返回值

wordwrap() 函數返回由指定長度包的字符串,即成功時將字符串分成幾行,失敗時返回 FALSE。

變更日誌

$cut 參數是在 PHP 4.0.3 中添加的。

例子

有一些例子,我們可以通過這些例子來了解 wordwrap() 函數的工作。讓我們看看下麵給出的例子:

例子1

<?php
	$strinn1 = "An example of the wordwrap() function to break the string";
	$width = 10;
	$break = "</br>";
	echo wordwrap($strinn1, $width, $break);
?>

輸出:

在上麵的例子中,一個字符串在每十個字符後被換行符中斷。在這裏,我們沒有傳遞 $cut 參數。

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

注意:當第四個參數未作為 TRUE 傳遞時,即使給定的寬度小於字寬,此函數也不會從兩者之間中斷一個字。

例子2

<?php
	$strinn1 = "Congratulations! to all";
	$width = 8;
	$break = "</br>";
	echo wordwrap($strinn1, $width, $break);
?>

輸出:

在這個例子中,我們沒有從給定的寬度(即 8)斷開 "Congratulations" 單詞,因為這個函數不會斷開它們之間的字符。

Congratulations!
to all

範例3:當 $cut 作為 "TRUE" 傳遞時

<?php
	$strinn1 = "Congratulations! to all";
	$width = 8;
	$break = "</br>";
	$cut = true;
	echo wordwrap($strinn1, $width, $break, $cut);
?>

輸出:

在此示例中,我們從給定的寬度(即 8)中拆分 "Congratulations" 字,並傳遞值為 TRUE 的 $cut 參數。所以這個函數在每八個字符後中斷字符串。

Congratu
lations!
to all

範例4:當 $cut 作為 "FALSE" 傳遞時

<?php
	$strinn1 = "Be a part of javatpoint";
	$width = 7;
	$break = "</br>";
	$cut = false;
	echo wordwrap($strinn1, $width, $break, $cut);
?>

輸出:

Be a
part of
javatpoint






相關用法


注:本文由純淨天空篩選整理自 PHP String wordwrap() Function。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。