Source for file ucwords.php

Documentation is available at ucwords.php

  1. <?php
  2. /**
  3. * @version $Id: ucwords.php,v 1.1 2007/09/09 20:39:49 pitlinz Exp $
  4. * @package utf8
  5. * @subpackage strings
  6. */
  7.  
  8. //---------------------------------------------------------------
  9. /**
  10. * UTF-8 aware alternative to ucwords
  11. * Uppercase the first character of each word in a string
  12. * Note: requires utf8_substr_replace and utf8_strtoupper
  13. * @param string 
  14. * @return string with first char of each word uppercase
  15. * @see http://www.php.net/ucwords
  16. * @package utf8
  17. * @subpackage strings
  18. */
  19. function utf8_ucwords($str) {
  20.     // Note: [\x0c\x09\x0b\x0a\x0d\x20] matches;
  21.     // form feeds, horizontal tabs, vertical tabs, linefeeds and carriage returns
  22.     // This corresponds to the definition of a "word" defined at http://www.php.net/ucwords
  23.     $pattern = '/(^|([\x0c\x09\x0b\x0a\x0d\x20]+))([^\x0c\x09\x0b\x0a\x0d\x20]{1})[^\x0c\x09\x0b\x0a\x0d\x20]*/u';
  24.     return preg_replace_callback($pattern, 'utf8_ucwords_callback',$str);
  25. }
  26.  
  27. //---------------------------------------------------------------
  28. /**
  29. * Callback function for preg_replace_callback call in utf8_ucwords
  30. * You don't need to call this yourself
  31. * @param array of matches corresponding to a single word
  32. * @return string with first char of the word in uppercase
  33. * @see utf8_ucwords
  34. * @see utf8_strtoupper
  35. * @package utf8
  36. * @subpackage strings
  37. */
  38. function utf8_ucwords_callback($matches) {
  39.     $leadingws = $matches[2];
  40.     $ucfirst = utf8_strtoupper($matches[3]);
  41.     $ucword = utf8_substr_replace(ltrim($matches[0]),$ucfirst,0,1);
  42.     return $leadingws . $ucword;
  43. }

Documentation generated on Thu, 08 Jan 2009 17:48:59 +0100 by phpDocumentor 1.4.0a2