projects
/
civicrm-core.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
formatting changes
[civicrm-core.git]
/
CRM
/
Utils
/
String.php
diff --git
a/CRM/Utils/String.php
b/CRM/Utils/String.php
index a86d859d2702fd27f7a8148d108f89e1844310d3..b561cad091520ce2d7915a0d803cabe34aff5ade 100644
(file)
--- a/
CRM/Utils/String.php
+++ b/
CRM/Utils/String.php
@@
-23,20
+23,19
@@
| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
| GNU Affero General Public License or the licensing of CiviCRM, |
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
+--------------------------------------------------------------------+
-*/
+
*/
/**
*
* @package CRM
* @copyright CiviCRM LLC (c) 2004-2014
* $Id$
/**
*
* @package CRM
* @copyright CiviCRM LLC (c) 2004-2014
* $Id$
- *
*/
require_once 'HTML/QuickForm/Rule/Email.php';
/**
*/
require_once 'HTML/QuickForm/Rule/Email.php';
/**
- * This class contains string functions
+ * This class contains string functions
.
*
*/
class CRM_Utils_String {
*
*/
class CRM_Utils_String {
@@
-48,16
+47,13
@@
class CRM_Utils_String {
const ALPHANUMERIC = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890';
/**
const ALPHANUMERIC = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890';
/**
- * Convert a display name into a potential variable
- * name that we could use in forms/code
- *
- * @param name Name of the string
+ * Convert a display name into a potential variable name.
*
*
+ * @param $title title of the string
* @param int $maxLength
*
* @return string
* An equivalent variable name.
* @param int $maxLength
*
* @return string
* An equivalent variable name.
- * @static
*/
public static function titleToVar($title, $maxLength = 31) {
$variable = self::munge($title, '_', $maxLength);
*/
public static function titleToVar($title, $maxLength = 31) {
$variable = self::munge($title, '_', $maxLength);
@@
-72,8
+68,7
@@
class CRM_Utils_String {
}
/**
}
/**
- * Given a string, replace all non alpha numeric characters and
- * spaces with the replacement character
+ * Replace all non alpha numeric characters and spaces with the replacement character.
*
* @param string $name
* The name to be worked on.
*
* @param string $name
* The name to be worked on.
@@
-82,13
+77,11
@@
class CRM_Utils_String {
* @param int $len
* Length of valid variables.
*
* @param int $len
* Length of valid variables.
*
- *
* @return string
* returns the manipulated string
* @return string
* returns the manipulated string
- * @static
*/
public static function munge($name, $char = '_', $len = 63) {
*/
public static function munge($name, $char = '_', $len = 63) {
- //
r
eplace all white space and non-alpha numeric with $char
+ //
R
eplace all white space and non-alpha numeric with $char
// we only use the ascii character set since mysql does not create table names / field names otherwise
// CRM-11744
$name = preg_replace('/[^a-zA-Z0-9]+/', $char, trim($name));
// we only use the ascii character set since mysql does not create table names / field names otherwise
// CRM-11744
$name = preg_replace('/[^a-zA-Z0-9]+/', $char, trim($name));
@@
-104,12
+97,11
@@
class CRM_Utils_String {
/**
* Convert possibly underscore separated words to camel case with special handling for 'UF'
/**
* Convert possibly underscore separated words to camel case with special handling for 'UF'
- * e.g
- *
membership_payment returns MembershipPayment
+ * e.g
membership_payment returns MembershipPayment
+ *
* @param string $string
*
* @return string
* @param string $string
*
* @return string
- * string
*/
public static function convertStringToCamel($string) {
$fragments = explode('_', $string);
*/
public static function convertStringToCamel($string) {
$fragments = explode('_', $string);
@@
-124,8
+116,7
@@
class CRM_Utils_String {
}
/**
}
/**
- *
- * Takes a variable name and munges it randomly into another variable name
+ * Takes a variable name and munges it randomly into another variable name.
*
* @param string $name
* Initial Variable Name.
*
* @param string $name
* Initial Variable Name.
@@
-134,7
+125,6
@@
class CRM_Utils_String {
*
* @return string
* Randomized Variable Name
*
* @return string
* Randomized Variable Name
- * @static
*/
public static function rename($name, $len = 4) {
$rand = substr(uniqid(), 0, $len);
*/
public static function rename($name, $len = 4) {
$rand = substr(uniqid(), 0, $len);
@@
-143,16
+133,16
@@
class CRM_Utils_String {
/**
* Takes a string and returns the last tuple of the string.
/**
* Takes a string and returns the last tuple of the string.
- * useful while converting file names to class names etc
+ *
+ * Useful while converting file names to class names etc
*
* @param string $string
* The input string.
*
* @param string $string
* The input string.
- * @param
\char|string $char $char the character used to demarcate the componets
- *
+ * @param
string $char
+ *
Character used to demarcate the components
*
* @return string
*
* @return string
- * the last component
- * @static
+ * The last component
*/
public static function getClassName($string, $char = '_') {
$names = array();
*/
public static function getClassName($string, $char = '_') {
$names = array();
@@
-165,8
+155,9
@@
class CRM_Utils_String {
}
/**
}
/**
- * Appends a name to a string and seperated by delimiter.
- * does the right thing for an empty string
+ * Appends a name to a string and separated by delimiter.
+ *
+ * Does the right thing for an empty string
*
* @param string $str
* The string to be appended to.
*
* @param string $str
* The string to be appended to.
@@
-174,9
+165,6
@@
class CRM_Utils_String {
* The delimiter to use.
* @param mixed $name
* The string (or array of strings) to append.
* The delimiter to use.
* @param mixed $name
* The string (or array of strings) to append.
- *
- * @return void
- * @static
*/
public static function append(&$str, $delim, $name) {
if (empty($name)) {
*/
public static function append(&$str, $delim, $name) {
if (empty($name)) {
@@
-207,16
+195,15
@@
class CRM_Utils_String {
}
/**
}
/**
- * Determine if the string is composed only of ascii characters
+ * Determine if the string is composed only of ascii characters
.
*
* @param string $str
* Input string.
* @param bool $utf8
* Attempt utf8 match on failure (default yes).
*
*
* @param string $str
* Input string.
* @param bool $utf8
* Attempt utf8 match on failure (default yes).
*
- * @return bool
ean
+ * @return bool
* true if string is ascii
* true if string is ascii
- * @static
*/
public static function isAscii($str, $utf8 = TRUE) {
if (!function_exists('mb_detect_encoding')) {
*/
public static function isAscii($str, $utf8 = TRUE) {
if (!function_exists('mb_detect_encoding')) {
@@
-251,7
+238,7
@@
class CRM_Utils_String {
}
/**
}
/**
- * Determine the string replacements for redaction
+ * Determine the string replacements for redaction
.
* on the basis of the regular expressions
*
* @param string $str
* on the basis of the regular expressions
*
* @param string $str
@@
-261,7
+248,6
@@
class CRM_Utils_String {
*
* @return array
* array of strings w/ corresponding redacted outputs
*
* @return array
* array of strings w/ corresponding redacted outputs
- * @static
*/
public static function regex($str, $regexRules) {
//redact the regular expressions
*/
public static function regex($str, $regexRules) {
//redact the regular expressions
@@
-318,9
+304,8
@@
class CRM_Utils_String {
*
* @param string $str
* Input string.
*
* @param string $str
* Input string.
- * @static
*
*
- * @return bool
ean
+ * @return bool
*/
public static function isUtf8($str) {
if (!function_exists(mb_detect_encoding)) {
*/
public static function isUtf8($str) {
if (!function_exists(mb_detect_encoding)) {
@@
-328,9
+313,9
@@
class CRM_Utils_String {
$str = preg_replace('/\s+/', '', $str);
/* pattern stolen from the php.net function documentation for
$str = preg_replace('/\s+/', '', $str);
/* pattern stolen from the php.net function documentation for
-
* utf8decode();
-
* comment by JF Sebastian, 30-Mar-2005
-
*/
+ * utf8decode();
+ * comment by JF Sebastian, 30-Mar-2005
+ */
return preg_match('/^([\x00-\x7f]|[\xc2-\xdf][\x80-\xbf]|\xe0[\xa0-\xbf][\x80-\xbf]|[\xe1-\xec][\x80-\xbf]{2}|\xed[\x80-\x9f][\x80-\xbf]|[\xee-\xef][\x80-\xbf]{2}|f0[\x90-\xbf][\x80-\xbf]{2}|[\xf1-\xf3][\x80-\xbf]{3}|\xf4[\x80-\x8f][\x80-\xbf]{2})*$/', $str);
// ||
return preg_match('/^([\x00-\x7f]|[\xc2-\xdf][\x80-\xbf]|\xe0[\xa0-\xbf][\x80-\xbf]|[\xe1-\xec][\x80-\xbf]{2}|\xed[\x80-\x9f][\x80-\xbf]|[\xee-\xef][\x80-\xbf]{2}|f0[\x90-\xbf][\x80-\xbf]{2}|[\xf1-\xf3][\x80-\xbf]{3}|\xf4[\x80-\x8f][\x80-\xbf]{2})*$/', $str);
// ||
@@
-350,9
+335,8
@@
class CRM_Utils_String {
* @param string $url2
* The second url to be matched against.
*
* @param string $url2
* The second url to be matched against.
*
- * @return bool
ean
+ * @return bool
* true if the urls match, else false
* true if the urls match, else false
- * @static
*/
public static function match($url1, $url2) {
$url1 = strtolower($url1);
*/
public static function match($url1, $url2) {
$url1 = strtolower($url1);
@@
-370,13
+354,13
@@
class CRM_Utils_String {
}
/**
}
/**
- * Extract
variable values
+ * Extract
the civicrm path from the url.
*
*
- * @param
mix
$query
- *
This is basically url
.
+ * @param
string
$query
+ *
A url string
.
*
*
- * @return
mix $v returns civicrm url (eg: civicrm/contact/search/...)
- *
@static
+ * @return
string|null
+ *
civicrm url (eg: civicrm/contact/search)
*/
public static function extractURLVarValue($query) {
$config = CRM_Core_Config::singleton();
*/
public static function extractURLVarValue($query) {
$config = CRM_Core_Config::singleton();
@@
-400,8
+384,7
@@
class CRM_Utils_String {
* @param string $str
* The string to be translated.
*
* @param string $str
* The string to be translated.
*
- * @return boolean
- * @static
+ * @return bool
*/
public static function strtobool($str) {
if (!is_scalar($str)) {
*/
public static function strtobool($str) {
if (!is_scalar($str)) {
@@
-420,8
+403,7
@@
class CRM_Utils_String {
* @param string $str
* The string to be translated.
*
* @param string $str
* The string to be translated.
*
- * @return boolean
- * @static
+ * @return bool
*/
public static function strtoboolstr($str) {
if (!is_scalar($str)) {
*/
public static function strtoboolstr($str) {
if (!is_scalar($str)) {
@@
-447,7
+429,6
@@
class CRM_Utils_String {
*
* @return string
* the converted string
*
* @return string
* the converted string
- * @static
*/
public static function htmlToText($html) {
require_once 'packages/html2text/rcube_html2text.php';
*/
public static function htmlToText($html) {
require_once 'packages/html2text/rcube_html2text.php';
@@
-564,7
+545,6
@@
class CRM_Utils_String {
*
* @return string
* the cleaned string
*
* @return string
* the cleaned string
- * @static
*/
public static function stripSpaces($string) {
return (empty($string)) ? $string : preg_replace("/\s{2,}/", " ", trim($string));
*/
public static function stripSpaces($string) {
return (empty($string)) ? $string : preg_replace("/\s{2,}/", " ", trim($string));
@@
-583,9
+563,8
@@
class CRM_Utils_String {
*
* @return string
* the sanitized string
*
* @return string
* the sanitized string
- * @static
*/
*/
- static function stripPathChars(
+
public
static function stripPathChars(
$string,
$search = NULL,
$replace = NULL
$string,
$search = NULL,
$replace = NULL
@@
-599,10
+578,23
@@
class CRM_Utils_String {
if ($_searchChars == NULL) {
$_searchChars = array(
if ($_searchChars == NULL) {
$_searchChars = array(
- '&', ';', ',', '=', '$',
- '"', "'", '\\',
- '<', '>', '(', ')',
- ' ', "\r", "\r\n", "\n", "\t",
+ '&',
+ ';',
+ ',',
+ '=',
+ '$',
+ '"',
+ "'",
+ '\\',
+ '<',
+ '>',
+ '(',
+ ')',
+ ' ',
+ "\r",
+ "\r\n",
+ "\n",
+ "\t",
);
$_replaceChar = '_';
}
);
$_replaceChar = '_';
}
@@
-629,7
+621,6
@@
class CRM_Utils_String {
*
* @return string
* the cleaned up string
*
* @return string
* the cleaned up string
- * @static
*/
public static function purifyHTML($string) {
static $_filter = NULL;
*/
public static function purifyHTML($string) {
static $_filter = NULL;
@@
-665,7
+656,7
@@
class CRM_Utils_String {
}
/**
}
/**
- * Generate a random string
+ * Generate a random string
.
*
* @param $len
* @param $alphabet
*
* @param $len
* @param $alphabet
@@
-723,14
+714,14
@@
class CRM_Utils_String {
$offset = floor(($len - $maskCount) / 2);
$masked = substr($user, 0, $offset)
$offset = floor(($len - $maskCount) / 2);
$masked = substr($user, 0, $offset)
-
. str_repeat($maskChar, $maskCount)
-
. substr($user, $maskCount + $offset);
+ . str_repeat($maskChar, $maskCount)
+ . substr($user, $maskCount + $offset);
return ($masked . '@' . $domain);
}
/**
return ($masked . '@' . $domain);
}
/**
- * This function compares two strings
+ * This function compares two strings
.
*
* @param string $strOne
* String one.
*
* @param string $strOne
* String one.
@@
-739,7
+730,7
@@
class CRM_Utils_String {
* @param bool $case
* Boolean indicating whether you want the comparison to be case sensitive or not.
*
* @param bool $case
* Boolean indicating whether you want the comparison to be case sensitive or not.
*
- * @return bool
ean
+ * @return bool
* TRUE (string are identical); FALSE (strings are not identical)
*/
public static function compareStr($strOne, $strTwo, $case) {
* TRUE (string are identical); FALSE (strings are not identical)
*/
public static function compareStr($strOne, $strTwo, $case) {
@@
-773,7
+764,7
@@
class CRM_Utils_String {
* (because most other odd characters are %-escaped in URLs; and %-escaped
* strings don't need any extra escaping in HTML).
*
* (because most other odd characters are %-escaped in URLs; and %-escaped
* strings don't need any extra escaping in HTML).
*
- * @param string $
u
rl
+ * @param string $
htmlU
rl
* URL with HTML entities.
* @return string
* URL without HTML entities
* URL with HTML entities.
* @return string
* URL without HTML entities
@@
-781,4
+772,20
@@
class CRM_Utils_String {
public static function unstupifyUrl($htmlUrl) {
return str_replace('&', '&', $htmlUrl);
}
public static function unstupifyUrl($htmlUrl) {
return str_replace('&', '&', $htmlUrl);
}
+
+ /**
+ * Formats a string of attributes for insertion in an html tag.
+ *
+ * @param array $attributes
+ *
+ * @return string
+ */
+ public static function htmlAttributes($attributes) {
+ $output = '';
+ foreach ($attributes as $name => $vals) {
+ $output .= " $name=\"" . htmlspecialchars(implode(' ', (array) $vals)) . '"';
+ }
+ return ltrim($output);
+ }
+
}
}