libraries/string.lib.php

   1 <?php
   2 /* vim: set expandtab sw=4 ts=4 sts=4: */
   3 /**
   4  * Specialized String Functions for phpMyAdmin
   5  *
   6  * Copyright 2002 Robin Johnson <robbat2@users.sourceforge.net>
   7  * http://www.orbis-terrarum.net/?l=people.robbat2
   8  *
   9  * Defines a set of function callbacks that have a pure C version available if
  10  * the "ctype" extension is available, but otherwise have PHP versions to use
  11  * (that are slower).
  12  *
  13  * The SQL Parser code relies heavily on these functions.
  14  *
  15  * @todo a .lib filename should not have code in main(), split or rename file
  16  * @package phpMyAdmin
  17  */
  18 if (! defined('PHPMYADMIN')) {
  19     exit;
  20 }
  21
  22 /**
  23  * Load proper code for handling input.
  24  */
  25 if (@function_exists('mb_strlen')) {
  26     mb_internal_encoding('utf-8');
  27     require './libraries/string_mb.lib.php';
  28 } else {
  29     require './libraries/string_native.lib.php';
  30 }
  31
  32 /**
  33  * Load ctype handler.
  34  */
  35 if (@extension_loaded('ctype')) {
  36     require './libraries/string_type_ctype.lib.php';
  37 } else {
  38     require './libraries/string_type_native.lib.php';
  39 }
  40
  41 /**
  42  * Checks if a given character position in the string is escaped or not
  43  *
  44  * @param string   string to check for
  45  * @param integer  the character to check for
  46  * @param integer  starting position in the string
  47  * @return  boolean  whether the character is escaped or not
  48  */
  49 function PMA_STR_charIsEscaped($string, $pos, $start = 0)
  50 {
  51     $pos = max(intval($pos), 0);
  52     $start = max(intval($start), 0);
  53     $len = PMA_strlen($string);
  54     // Base case:
  55     // Check for string length or invalid input or special case of input
  56     // (pos == $start)
  57     if ($pos <= $start || $len <= max($pos, $start)) {
  58         return false;
  59     }
  60
  61     $pos--;
  62     $escaped     = false;
  63     while ($pos >= $start && PMA_substr($string, $pos, 1) == '\\') {
  64         $escaped = !$escaped;
  65         $pos--;
  66     } // end while
  67
  68     return $escaped;
  69 } // end of the "PMA_STR_charIsEscaped()" function
  70
  71
  72 /**
  73  * Checks if a number is in a range
  74  *
  75  * @param integer  number to check for
  76  * @param integer  lower bound
  77  * @param integer  upper bound
  78  * @return  boolean  whether the number is in the range or not
  79  */
  80 function PMA_STR_numberInRangeInclusive($num, $lower, $upper)
  81 {
  82     return ($num >= $lower && $num <= $upper);
  83 } // end of the "PMA_STR_numberInRangeInclusive()" function
  84
  85 /**
  86  * Checks if a character is an SQL identifier
  87  *
  88  * @param string   character to check for
  89  * @param boolean  whether the dot character is valid or not
  90  * @return  boolean  whether the character is an SQL identifier or not
  91  */
  92 function PMA_STR_isSqlIdentifier($c, $dot_is_valid = false)
  93 {
  94     return (PMA_STR_isAlnum($c)
  95         || ($ord_c = ord($c)) && $ord_c >= 192 && $ord_c != 215 && $ord_c != 249
  96         || $c == '_'
  97         || $c == '$'
  98         || ($dot_is_valid != false && $c == '.'));
  99 } // end of the "PMA_STR_isSqlIdentifier()" function
 100
 101 ?>