converted to unix-style eol
[www-register-wizard.git] / helpers / string_helper.php
index 4e376a8..319002e 100644 (file)
-<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');\r
-/**\r
- * CodeIgniter\r
- *\r
- * An open source application development framework for PHP 4.3.2 or newer\r
- *\r
- * @package            CodeIgniter\r
- * @author             ExpressionEngine Dev Team\r
- * @copyright  Copyright (c) 2008, EllisLab, Inc.\r
- * @license            http://codeigniter.com/user_guide/license.html\r
- * @link               http://codeigniter.com\r
- * @since              Version 1.0\r
- * @filesource\r
- */\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * CodeIgniter String Helpers\r
- *\r
- * @package            CodeIgniter\r
- * @subpackage Helpers\r
- * @category   Helpers\r
- * @author             ExpressionEngine Dev Team\r
- * @link               http://codeigniter.com/user_guide/helpers/string_helper.html\r
- */\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Trim Slashes\r
- *\r
- * Removes any leading/traling slashes from a string:\r
- *\r
- * /this/that/theother/\r
- *\r
- * becomes:\r
- *\r
- * this/that/theother\r
- *\r
- * @access     public\r
- * @param      string\r
- * @return     string\r
- */    \r
-if ( ! function_exists('trim_slashes'))\r
-{\r
-       function trim_slashes($str)\r
-       {\r
-               return trim($str, '/');\r
-       } \r
-}\r
-       \r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Strip Slashes\r
- *\r
- * Removes slashes contained in a string or in an array\r
- *\r
- * @access     public\r
- * @param      mixed   string or array\r
- * @return     mixed   string or array\r
- */    \r
-if ( ! function_exists('strip_slashes'))\r
-{\r
-       function strip_slashes($str)\r
-       {\r
-               if (is_array($str))\r
-               {       \r
-                       foreach ($str as $key => $val)\r
-                       {\r
-                               $str[$key] = strip_slashes($val);\r
-                       }\r
-               }\r
-               else\r
-               {\r
-                       $str = stripslashes($str);\r
-               }\r
-       \r
-               return $str;\r
-       }\r
-}\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Strip Quotes\r
- *\r
- * Removes single and double quotes from a string\r
- *\r
- * @access     public\r
- * @param      string\r
- * @return     string\r
- */    \r
-if ( ! function_exists('strip_quotes'))\r
-{\r
-       function strip_quotes($str)\r
-       {\r
-               return str_replace(array('"', "'"), '', $str);\r
-       }\r
-}\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Quotes to Entities\r
- *\r
- * Converts single and double quotes to entities\r
- *\r
- * @access     public\r
- * @param      string\r
- * @return     string\r
- */    \r
-if ( ! function_exists('quotes_to_entities'))\r
-{\r
-       function quotes_to_entities($str)\r
-       {       \r
-               return str_replace(array("\'","\"","'",'"'), array("&#39;","&quot;","&#39;","&quot;"), $str);\r
-       }\r
-}\r
-\r
-// ------------------------------------------------------------------------\r
-/**\r
- * Reduce Double Slashes\r
- *\r
- * Converts double slashes in a string to a single slash,\r
- * except those found in http://\r
- *\r
- * http://www.some-site.com//index.php\r
- *\r
- * becomes:\r
- *\r
- * http://www.some-site.com/index.php\r
- *\r
- * @access     public\r
- * @param      string\r
- * @return     string\r
- */    \r
-if ( ! function_exists('reduce_double_slashes'))\r
-{\r
-       function reduce_double_slashes($str)\r
-       {\r
-               return preg_replace("#([^:])//+#", "\\1/", $str);\r
-       }\r
-}\r
-       \r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Reduce Multiples\r
- *\r
- * Reduces multiple instances of a particular character.  Example:\r
- *\r
- * Fred, Bill,, Joe, Jimmy\r
- *\r
- * becomes:\r
- *\r
- * Fred, Bill, Joe, Jimmy\r
- *\r
- * @access     public\r
- * @param      string\r
- * @param      string  the character you wish to reduce\r
- * @param      bool    TRUE/FALSE - whether to trim the character from the beginning/end\r
- * @return     string\r
- */    \r
-if ( ! function_exists('reduce_multiples'))\r
-{\r
-       function reduce_multiples($str, $character = ',', $trim = FALSE)\r
-       {\r
-               $str = preg_replace('#'.preg_quote($character, '#').'{2,}#', $character, $str);\r
-\r
-               if ($trim === TRUE)\r
-               {\r
-                       $str = trim($str, $character);\r
-               }\r
-\r
-               return $str;\r
-       }\r
-}\r
-       \r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Create a Random String\r
- *\r
- * Useful for generating passwords or hashes.\r
- *\r
- * @access     public\r
- * @param      string  type of random string.  Options: alunum, numeric, nozero, unique\r
- * @param      integer number of characters\r
- * @return     string\r
- */\r
-if ( ! function_exists('random_string'))\r
-{      \r
-       function random_string($type = 'alnum', $len = 8)\r
-       {                                       \r
-               switch($type)\r
-               {\r
-                       case 'alnum'    :\r
-                       case 'numeric'  :\r
-                       case 'nozero'   :\r
-               \r
-                                       switch ($type)\r
-                                       {\r
-                                               case 'alnum'    :       $pool = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';\r
-                                                       break;\r
-                                               case 'numeric'  :       $pool = '0123456789';\r
-                                                       break;\r
-                                               case 'nozero'   :       $pool = '123456789';\r
-                                                       break;\r
-                                       }\r
-\r
-                                       $str = '';\r
-                                       for ($i=0; $i < $len; $i++)\r
-                                       {\r
-                                               $str .= substr($pool, mt_rand(0, strlen($pool) -1), 1);\r
-                                       }\r
-                                       return $str;\r
-                         break;\r
-                       case 'unique' : return md5(uniqid(mt_rand()));\r
-                         break;\r
-               }\r
-       }\r
-}\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Alternator\r
- *\r
- * Allows strings to be alternated.  See docs...\r
- *\r
- * @access     public\r
- * @param      string (as many parameters as needed)\r
- * @return     string\r
- */    \r
-if ( ! function_exists('alternator'))\r
-{\r
-       function alternator()\r
-       {\r
-               static $i;      \r
-\r
-               if (func_num_args() == 0)\r
-               {\r
-                       $i = 0;\r
-                       return '';\r
-               }\r
-               $args = func_get_args();\r
-               return $args[($i++ % count($args))];\r
-       }\r
-}\r
-\r
-// ------------------------------------------------------------------------\r
-\r
-/**\r
- * Repeater function\r
- *\r
- * @access     public\r
- * @param      string\r
- * @param      integer number of repeats\r
- * @return     string\r
- */    \r
-if ( ! function_exists('repeater'))\r
-{\r
-       function repeater($data, $num = 1)\r
-       {\r
-               return (($num > 0) ? str_repeat($data, $num) : '');\r
-       } \r
-}\r
-\r
-\r
-/* End of file string_helper.php */\r
+<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');
+/**
+ * CodeIgniter
+ *
+ * An open source application development framework for PHP 4.3.2 or newer
+ *
+ * @package            CodeIgniter
+ * @author             ExpressionEngine Dev Team
+ * @copyright  Copyright (c) 2008, EllisLab, Inc.
+ * @license            http://codeigniter.com/user_guide/license.html
+ * @link               http://codeigniter.com
+ * @since              Version 1.0
+ * @filesource
+ */
+
+// ------------------------------------------------------------------------
+
+/**
+ * CodeIgniter String Helpers
+ *
+ * @package            CodeIgniter
+ * @subpackage Helpers
+ * @category   Helpers
+ * @author             ExpressionEngine Dev Team
+ * @link               http://codeigniter.com/user_guide/helpers/string_helper.html
+ */
+
+// ------------------------------------------------------------------------
+
+/**
+ * Trim Slashes
+ *
+ * Removes any leading/traling slashes from a string:
+ *
+ * /this/that/theother/
+ *
+ * becomes:
+ *
+ * this/that/theother
+ *
+ * @access     public
+ * @param      string
+ * @return     string
+ */    
+if ( ! function_exists('trim_slashes'))
+{
+       function trim_slashes($str)
+       {
+               return trim($str, '/');
+       } 
+}
+       
+// ------------------------------------------------------------------------
+
+/**
+ * Strip Slashes
+ *
+ * Removes slashes contained in a string or in an array
+ *
+ * @access     public
+ * @param      mixed   string or array
+ * @return     mixed   string or array
+ */    
+if ( ! function_exists('strip_slashes'))
+{
+       function strip_slashes($str)
+       {
+               if (is_array($str))
+               {       
+                       foreach ($str as $key => $val)
+                       {
+                               $str[$key] = strip_slashes($val);
+                       }
+               }
+               else
+               {
+                       $str = stripslashes($str);
+               }
+       
+               return $str;
+       }
+}
+
+// ------------------------------------------------------------------------
+
+/**
+ * Strip Quotes
+ *
+ * Removes single and double quotes from a string
+ *
+ * @access     public
+ * @param      string
+ * @return     string
+ */    
+if ( ! function_exists('strip_quotes'))
+{
+       function strip_quotes($str)
+       {
+               return str_replace(array('"', "'"), '', $str);
+       }
+}
+
+// ------------------------------------------------------------------------
+
+/**
+ * Quotes to Entities
+ *
+ * Converts single and double quotes to entities
+ *
+ * @access     public
+ * @param      string
+ * @return     string
+ */    
+if ( ! function_exists('quotes_to_entities'))
+{
+       function quotes_to_entities($str)
+       {       
+               return str_replace(array("\'","\"","'",'"'), array("&#39;","&quot;","&#39;","&quot;"), $str);
+       }
+}
+
+// ------------------------------------------------------------------------
+/**
+ * Reduce Double Slashes
+ *
+ * Converts double slashes in a string to a single slash,
+ * except those found in http://
+ *
+ * http://www.some-site.com//index.php
+ *
+ * becomes:
+ *
+ * http://www.some-site.com/index.php
+ *
+ * @access     public
+ * @param      string
+ * @return     string
+ */    
+if ( ! function_exists('reduce_double_slashes'))
+{
+       function reduce_double_slashes($str)
+       {
+               return preg_replace("#([^:])//+#", "\\1/", $str);
+       }
+}
+       
+// ------------------------------------------------------------------------
+
+/**
+ * Reduce Multiples
+ *
+ * Reduces multiple instances of a particular character.  Example:
+ *
+ * Fred, Bill,, Joe, Jimmy
+ *
+ * becomes:
+ *
+ * Fred, Bill, Joe, Jimmy
+ *
+ * @access     public
+ * @param      string
+ * @param      string  the character you wish to reduce
+ * @param      bool    TRUE/FALSE - whether to trim the character from the beginning/end
+ * @return     string
+ */    
+if ( ! function_exists('reduce_multiples'))
+{
+       function reduce_multiples($str, $character = ',', $trim = FALSE)
+       {
+               $str = preg_replace('#'.preg_quote($character, '#').'{2,}#', $character, $str);
+
+               if ($trim === TRUE)
+               {
+                       $str = trim($str, $character);
+               }
+
+               return $str;
+       }
+}
+       
+// ------------------------------------------------------------------------
+
+/**
+ * Create a Random String
+ *
+ * Useful for generating passwords or hashes.
+ *
+ * @access     public
+ * @param      string  type of random string.  Options: alunum, numeric, nozero, unique
+ * @param      integer number of characters
+ * @return     string
+ */
+if ( ! function_exists('random_string'))
+{      
+       function random_string($type = 'alnum', $len = 8)
+       {                                       
+               switch($type)
+               {
+                       case 'alnum'    :
+                       case 'numeric'  :
+                       case 'nozero'   :
+               
+                                       switch ($type)
+                                       {
+                                               case 'alnum'    :       $pool = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+                                                       break;
+                                               case 'numeric'  :       $pool = '0123456789';
+                                                       break;
+                                               case 'nozero'   :       $pool = '123456789';
+                                                       break;
+                                       }
+
+                                       $str = '';
+                                       for ($i=0; $i < $len; $i++)
+                                       {
+                                               $str .= substr($pool, mt_rand(0, strlen($pool) -1), 1);
+                                       }
+                                       return $str;
+                         break;
+                       case 'unique' : return md5(uniqid(mt_rand()));
+                         break;
+               }
+       }
+}
+
+// ------------------------------------------------------------------------
+
+/**
+ * Alternator
+ *
+ * Allows strings to be alternated.  See docs...
+ *
+ * @access     public
+ * @param      string (as many parameters as needed)
+ * @return     string
+ */    
+if ( ! function_exists('alternator'))
+{
+       function alternator()
+       {
+               static $i;      
+
+               if (func_num_args() == 0)
+               {
+                       $i = 0;
+                       return '';
+               }
+               $args = func_get_args();
+               return $args[($i++ % count($args))];
+       }
+}
+
+// ------------------------------------------------------------------------
+
+/**
+ * Repeater function
+ *
+ * @access     public
+ * @param      string
+ * @param      integer number of repeats
+ * @return     string
+ */    
+if ( ! function_exists('repeater'))
+{
+       function repeater($data, $num = 1)
+       {
+               return (($num > 0) ? str_repeat($data, $num) : '');
+       } 
+}
+
+
+/* End of file string_helper.php */
 /* Location: ./system/helpers/string_helper.php */
\ No newline at end of file