mb_truncate

パラメータの位置必須デフォルト概要
1integerNo80切り捨てを行うキャラクタ数
2stringNo...切り捨てが発生した際に終端に付加するキャラクタ

指定したキャラクタ数(デフォルトは80)で変数を切り捨てます。 第2パラメータには、変数が切り捨てられた時に終端に付加するキャラクタを指定する事が出来ます。 このキャラクタの長さは元の切り捨ての長さに含まれます。デフォルトでは単語の境界で切り捨てを行います。 Artisan Smartyオリジナルであり、マルチバイト文字に対応しています。 mb_strimwidthモディファーと違う点は、キャラクタのカウント開始が必ず、0文字目からである事と、文字幅ではなく、文字数で計算する点です。

例 5-20. mb_truncate

<?php
    
$smarty
= new Smarty;
$smarty->assign('articleTitle', 'Two Sisters Reunite after Eighteen Years at Checkout Counter.');
$smarty->display('index.tpl');

?>

index.tpl :

{$articleTitle}
{$articleTitle|mb_truncate}
{$articleTitle|mb_truncate:30}
{$articleTitle|mb_truncate:30:""}
{$articleTitle|mb_truncate:30:"---"}
{$articleTitle|mb_truncate:30:"":true}
{$articleTitle|mb_truncate:30:"...":true}

出力 :

Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after Eighteen Years at Checkout Counter.
Two Sisters Reunite after...
Two Sisters Reunite after
Two Sisters Reunite after---
Two Sisters Reunite after Eigh
Two Sisters Reunite after E...