74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
|
# wordwrap
|
||
|
|
||
|
Wraps a string to a column width, the default is 80. As an optional
|
||
|
second parameter, you can specify a string of text to wrap the text to
|
||
|
the next line, the default is a carriage return `"\n"`. By default,
|
||
|
`wordwrap` will attempt to wrap at a word boundary. If you want to cut
|
||
|
off at the exact character length, pass the optional third parameter as
|
||
|
TRUE. This is equivalent to the PHP
|
||
|
[`wordwrap()`](https://www.php.net/wordwrap) function.
|
||
|
|
||
|
## Basic usage
|
||
|
```smarty
|
||
|
{$myVar|wordwrap:30}
|
||
|
```
|
||
|
|
||
|
## Parameters
|
||
|
|
||
|
| Parameter Position | Type | Required | Default | Description |
|
||
|
|--------------------|---------|----------|---------|-----------------------------------------------------------------------------------------------|
|
||
|
| 1 | integer | No | 80 | This determines how many columns to wrap to. |
|
||
|
| 2 | string | No | \\n | This is the string used to wrap words with. |
|
||
|
| 3 | boolean | No | FALSE | This determines whether to wrap at a word boundary (FALSE), or at the exact character (TRUE). |
|
||
|
|
||
|
## Examples
|
||
|
|
||
|
```php
|
||
|
<?php
|
||
|
|
||
|
$smarty->assign('articleTitle',
|
||
|
"Blind woman gets new kidney from dad she hasn't seen in years."
|
||
|
);
|
||
|
|
||
|
```
|
||
|
|
||
|
Where template is
|
||
|
|
||
|
```smarty
|
||
|
{$articleTitle}
|
||
|
|
||
|
{$articleTitle|wordwrap:30}
|
||
|
|
||
|
{$articleTitle|wordwrap:20}
|
||
|
|
||
|
{$articleTitle|wordwrap:30:"<br />\n"}
|
||
|
|
||
|
{$articleTitle|wordwrap:26:"\n":true}
|
||
|
```
|
||
|
|
||
|
Will output:
|
||
|
|
||
|
```html
|
||
|
Blind woman gets new kidney from dad she hasn't seen in years.
|
||
|
|
||
|
Blind woman gets new kidney
|
||
|
from dad she hasn't seen in
|
||
|
years.
|
||
|
|
||
|
Blind woman gets new
|
||
|
kidney from dad she
|
||
|
hasn't seen in
|
||
|
years.
|
||
|
|
||
|
Blind woman gets new kidney<br />
|
||
|
from dad she hasn't seen in<br />
|
||
|
years.
|
||
|
|
||
|
Blind woman gets new kidn
|
||
|
ey from dad she hasn't se
|
||
|
en in years.
|
||
|
```
|
||
|
|
||
|
See also [`nl2br`](language-modifier-nl2br.md) and
|
||
|
[`{textformat}`](../language-custom-functions/language-function-textformat.md).
|