Class Text

_wordWrapsource protected static

_wordWrap( string $text , integer $width 72 , string $break "\n" , boolean $cut false )

Unicode aware version of wordwrap as helper method.

Parameters

string $text

The text to format.

integer $width optional 72

The width to wrap to. Defaults to 72.

string $break optional "\n"

The line is broken using the optional break parameter. Defaults to '\n'.

boolean $cut optional false

If the cut is set to true, the string is always wrapped at the specified width.

Returns

string
Formatted text.

asciisource public static

ascii( array $array )

Converts the decimal value of a multibyte character string to a string

Parameters

array $array

Array

Returns

string
string

cleanInsertsource public static

cleanInsert( string $str , array $options )

Cleans up a Text::insert() formatted string with given $options depending on the 'clean' key in $options. The default method used is text but html is also available. The goal of this function is to replace all whitespace and unneeded markup around placeholders that did not get replaced by Text::insert().

Parameters

string $str

String to clean.

array $options

Options list.

Returns

string
string

See

Cake\Utility\Text::insert()

excerptsource public static

excerpt( string $text , string $phrase , integer $radius 100 , string $ellipsis '...' )

Extracts an excerpt from the text surrounding the phrase with a number of characters on each side determined by radius.

Parameters

string $text

String to search the phrase in

string $phrase

Phrase that will be searched for

integer $radius optional 100

The amount of characters that will be returned on each side of the founded phrase

string $ellipsis optional '...'

Ending that will be appended

Returns

string
Modified string

Link

http://book.cakephp.org/3.0/en/core-libraries/string.html#extracting-an-excerpt

highlightsource public static

highlight( string $text , string|array $phrase , array $options [] )

Highlights a given phrase in a text. You can specify any expression in highlighter that may include the \1 expression to include the $phrase found.

Options:

• format The piece of HTML with that the phrase will be highlighted
• html If true, will ignore any HTML tags, ensuring that only the correct text is highlighted
• regex a custom regex rule that is used to match words, default is '|$tag|iu'

Parameters

string $text

Text to search the phrase in.

string|array $phrase

The phrase or phrases that will be searched.

array $options optional []

An array of HTML attributes and options.

Returns

string
The highlighted text

Link

http://book.cakephp.org/3.0/en/core-libraries/string.html#highlighting-substrings

insertsource public static

insert( string $str , array $data , array $options [] )

Replaces variable placeholders inside a $str with any given $data. Each key in the $data array corresponds to a variable placeholder name in $str. Example:

Text::insert(':name is :age years old.', ['name' => 'Bob', '65']);

Returns: Bob is 65 years old.

Available $options are:

• before: The character or string in front of the name of the variable placeholder (Defaults to :)
• after: The character or string after the name of the variable placeholder (Defaults to null)
• escape: The character or string used to escape the before character / string (Defaults to \)
• format: A regex to use for matching variable placeholders. Default is: /(?<!\&#x29;\:%s/ (Overwrites before, after, breaks escape / clean)
• clean: A boolean or array with instructions for Text::cleanInsert

Parameters

string $str

A string containing variable placeholders

array $data

A key => val array where each key stands for a placeholder variable name to be replaced with val

array $options optional []

An array of options, see description above

Returns

string
string

isMultibytesource public static

isMultibyte( string $string )

Check if the string contain multibyte characters

Parameters

string $string

value to test

Returns

boolean
bool

parseFileSizesource public static

parseFileSize( string $size , mixed $default false )

Converts filesize from human readable string to bytes

Parameters

string $size

Size in human readable string like '5MB', '5M', '500B', '50kb' etc.

mixed $default optional false

Value to be returned when invalid size was used, for example 'Unknown type'

Returns

mixed
Number of bytes as integer on success, $default on failure if not false

Throws

InvalidArgumentException
On invalid Unit type.

Link

http://book.cakephp.org/3.0/en/core-libraries/helpers/text.html

stripLinkssource public static

stripLinks( string $text )

Strips given text of all links (<a href=....).

Parameters

string $text

Text

Returns

string
The text without links

tailsource public static

tail( string $text , integer $length 100 , array $options [] )

Truncates text starting from the end.

Cuts a string to the length of $length and replaces the first characters with the ellipsis if the text is longer than length.

Options:

• ellipsis Will be used as Beginning and prepended to the trimmed string
• exact If false, $text will not be cut mid-word

Parameters

string $text

String to truncate.

integer $length optional 100

Length of returned string, including ellipsis.

array $options optional []

An array of options.

Returns

string
Trimmed string.

toListsource public static

toList( array $list , string $and null , string $separator ', ' )

Creates a comma separated list where the last two items are joined with 'and', forming natural language.

Parameters

array $list

The list to be joined.

string $and optional null

The word used to join the last and second last items together with. Defaults to 'and'.

string $separator optional ', '

The separator used to join all the other items together. Defaults to ', '.

Returns

string
The glued together string.

Link

http://book.cakephp.org/3.0/en/core-libraries/string.html#converting-an-array-to-sentence-form

tokenizesource public static

tokenize( string $data , string $separator ',' , string $leftBound '(' , string $rightBound ')' )

Tokenizes a string using $separator, ignoring any instance of $separator that appears between $leftBound and $rightBound.

Parameters

string $data

The data to tokenize.

string $separator optional ','

The token to split the data on.

string $leftBound optional '('

The left boundary to ignore separators in.

string $rightBound optional ')'

The right boundary to ignore separators in.

Returns

array|string
Array of tokens in $data or original input if empty.

truncatesource public static

truncate( string $text , integer $length 100 , array $options [] )

Truncates text.

Cuts a string to the length of $length and replaces the last characters with the ellipsis if the text is longer than length.

Options:

• ellipsis Will be used as ending and appended to the trimmed string
• exact If false, $text will not be cut mid-word
• html If true, HTML tags would be handled correctly

Parameters

string $text

String to truncate.

integer $length optional 100

Length of returned string, including ellipsis.

array $options optional []

An array of HTML attributes and options.

Returns

string
Trimmed string.

Link

http://book.cakephp.org/3.0/en/core-libraries/string.html#truncating-text

utf8source public static

utf8( string $string )

Converts a multibyte character string to the decimal value of the character

Parameters

string $string

String to convert.

Returns

array
array

uuidsource public static

uuid( )

Generate a random UUID version 4

Warning: This method should not be used as a random seed for any cryptographic operations. Instead you should use the openssl or mcrypt extensions.

Returns

string
RFC 4122 UUID

Copyright

Matt Farina MIT License https://github.com/lootils/uuid/blob/master/LICENSE

See

http://www.ietf.org/rfc/rfc4122.txt

wordWrapsource public static

wordWrap( string $text , integer $width 72 , string $break "\n" , boolean $cut false )

Unicode and newline aware version of wordwrap.

Parameters

string $text

The text to format.

integer $width optional 72

The width to wrap to. Defaults to 72.

string $break optional "\n"

The line is broken using the optional break parameter. Defaults to '\n'.

boolean $cut optional false

If the cut is set to true, the string is always wrapped at the specified width.

Returns

string
Formatted text.

wrapsource public static

wrap( string $text , array|integer $options [] )

Wraps text to a specific width, can optionally wrap at word breaks.

Options

• width The width to wrap to. Defaults to 72.
• wordWrap Only wrap on words breaks (spaces) Defaults to true.
• indent String to indent with. Defaults to null.
• indentAt 0 based index to start indenting at. Defaults to 0.

Parameters

string $text

The text to format.

array|integer $options optional []

Array of options to use, or an integer to wrap the text to.

Returns

string
Formatted text.

wrapBlocksource public static

wrapBlock( string $text , array|integer $options [] )

Wraps a complete block of text to a specific width, can optionally wrap at word breaks.

Options

• width The width to wrap to. Defaults to 72.
• wordWrap Only wrap on words breaks (spaces) Defaults to true.
• indent String to indent with. Defaults to null.
• indentAt 0 based index to start indenting at. Defaults to 0.

Parameters

string $text

The text to format.

array|integer $options optional []

Array of options to use, or an integer to wrap the text to.

Returns

string
Formatted text.