$sanitizer->word() method

Return first word in given string

Available since version 3.0.162.

Usage

// basic usage
$string = $sanitizer->word(string $value);

// usage with all arguments
$string = $sanitizer->word(string $value, array $options = []);

Arguments

NameType(s)Description
valuestring

String containing one or more words

options (optional)array

Options to adjust behavior:

  • keepNumbers (bool): Allow numbers as return value? (default=true)
  • keepNumberFormat (bool): Keep minus/comma/period in numbers rather than splitting into words? Also requires keepNumbers==true. (default=false)
  • keepUnderscore (bool): Keep underscores as part of words? (default=false)
  • keepHyphen (bool): Keep hyphenated words? (default=false)
  • keepChars (array): Specify any of these to also keep as part of words ['.', ',', ';', '/', '*', ':', '+', '<', '>', '_', '-' ] (default=[])
  • minWordLength (int): Minimum word length (default=1)
  • maxWordLength (int): Maximum word length (default=80)
  • maxWords (int): Maximum words (default=1 or 99 if a seperator option is specified)
  • maxLength (int): Maximum returned string length (default=1024)
  • stripTags (bool): Strip markup tags so they don’t contribute to returned word? (default=true)
  • `separator' (string): Merge multiple words into one word split by this character? (default='', disabled) 3.0.195+
  • ascii (bool): Allow only ASCII word characters? (default=false)
  • beautify (bool): Make ugly strings more pretty? This collapses and trims redundant separators (default=false)

Return value

string

See Also


$sanitizer methods and properties

API reference based on ProcessWire core version 3.0.209

Twitter updates

  • Adding custom actions to ProcessWire image fields in the admin, part of this week’s dev branch additions: More
    27 January 2023
  • ProcessWire 3.0.210 new main/master version released— More
    6 January 2023
  • ProcessWire 3.0.209: Core updates and an interesting AI that knows ProcessWire– More
    30 December 2022

Latest news

  • ProcessWire Weekly #455
    In the 455th issue of ProcessWire Weekly we'll check out the latest core updates, introduce a new third party module called JkPublishPages, and more. Read on!
    Weekly.pw / 28 January 2023
  • ProcessWire 3.0.210 new main/master version
    140 commits, 55 resolved issues, dozens of new features, eight contributors, and five new pull requests make yet another great new version of ProcessWire.
    Blog / 6 January 2023
  • Subscribe to weekly ProcessWire news

“The end client and designer love the ease at which they can update the website. Training beyond how to log in wasn’t even necessary since ProcessWire’s default interface is straightforward.” —Jonathan Lahijani