vendor/symfony/polyfill-ctype/Ctype.php

   1 <?php
   2
   3 /*
   4  * This file is part of the Symfony package.
   5  *
   6  * (c) Fabien Potencier <fabien@symfony.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Symfony\Polyfill\Ctype;
  13
  14 /**
  15  * Ctype implementation through regex.
  16  *
  17  * @internal
  18  *
  19  * @author Gert de Pagter <BackEndTea@gmail.com>
  20  */
  21 final class Ctype
  22 {
  23     /**
  24      * Returns TRUE if every character in text is either a letter or a digit, FALSE otherwise.
  25      *
  26      * @see https://php.net/ctype-alnum
  27      *
  28      * @param string|int $text
  29      *
  30      * @return bool
  31      */
  32     public static function ctype_alnum($text)
  33     {
  34         $text = self::convert_int_to_char_for_ctype($text);
  35
  36         return \is_string($text) && '' !== $text && !preg_match('/[^A-Za-z0-9]/', $text);
  37     }
  38
  39     /**
  40      * Returns TRUE if every character in text is a letter, FALSE otherwise.
  41      *
  42      * @see https://php.net/ctype-alpha
  43      *
  44      * @param string|int $text
  45      *
  46      * @return bool
  47      */
  48     public static function ctype_alpha($text)
  49     {
  50         $text = self::convert_int_to_char_for_ctype($text);
  51
  52         return \is_string($text) && '' !== $text && !preg_match('/[^A-Za-z]/', $text);
  53     }
  54
  55     /**
  56      * Returns TRUE if every character in text is a control character from the current locale, FALSE otherwise.
  57      *
  58      * @see https://php.net/ctype-cntrl
  59      *
  60      * @param string|int $text
  61      *
  62      * @return bool
  63      */
  64     public static function ctype_cntrl($text)
  65     {
  66         $text = self::convert_int_to_char_for_ctype($text);
  67
  68         return \is_string($text) && '' !== $text && !preg_match('/[^\x00-\x1f\x7f]/', $text);
  69     }
  70
  71     /**
  72      * Returns TRUE if every character in the string text is a decimal digit, FALSE otherwise.
  73      *
  74      * @see https://php.net/ctype-digit
  75      *
  76      * @param string|int $text
  77      *
  78      * @return bool
  79      */
  80     public static function ctype_digit($text)
  81     {
  82         $text = self::convert_int_to_char_for_ctype($text);
  83
  84         return \is_string($text) && '' !== $text && !preg_match('/[^0-9]/', $text);
  85     }
  86
  87     /**
  88      * Returns TRUE if every character in text is printable and actually creates visible output (no white space), FALSE otherwise.
  89      *
  90      * @see https://php.net/ctype-graph
  91      *
  92      * @param string|int $text
  93      *
  94      * @return bool
  95      */
  96     public static function ctype_graph($text)
  97     {
  98         $text = self::convert_int_to_char_for_ctype($text);
  99
 100         return \is_string($text) && '' !== $text && !preg_match('/[^!-~]/', $text);
 101     }
 102
 103     /**
 104      * Returns TRUE if every character in text is a lowercase letter.
 105      *
 106      * @see https://php.net/ctype-lower
 107      *
 108      * @param string|int $text
 109      *
 110      * @return bool
 111      */
 112     public static function ctype_lower($text)
 113     {
 114         $text = self::convert_int_to_char_for_ctype($text);
 115
 116         return \is_string($text) && '' !== $text && !preg_match('/[^a-z]/', $text);
 117     }
 118
 119     /**
 120      * Returns TRUE if every character in text will actually create output (including blanks). Returns FALSE if text contains control characters or characters that do not have any output or control function at all.
 121      *
 122      * @see https://php.net/ctype-print
 123      *
 124      * @param string|int $text
 125      *
 126      * @return bool
 127      */
 128     public static function ctype_print($text)
 129     {
 130         $text = self::convert_int_to_char_for_ctype($text);
 131
 132         return \is_string($text) && '' !== $text && !preg_match('/[^ -~]/', $text);
 133     }
 134
 135     /**
 136      * Returns TRUE if every character in text is printable, but neither letter, digit or blank, FALSE otherwise.
 137      *
 138      * @see https://php.net/ctype-punct
 139      *
 140      * @param string|int $text
 141      *
 142      * @return bool
 143      */
 144     public static function ctype_punct($text)
 145     {
 146         $text = self::convert_int_to_char_for_ctype($text);
 147
 148         return \is_string($text) && '' !== $text && !preg_match('/[^!-\/\:-@\[-`\{-~]/', $text);
 149     }
 150
 151     /**
 152      * Returns TRUE if every character in text creates some sort of white space, FALSE otherwise. Besides the blank character this also includes tab, vertical tab, line feed, carriage return and form feed characters.
 153      *
 154      * @see https://php.net/ctype-space
 155      *
 156      * @param string|int $text
 157      *
 158      * @return bool
 159      */
 160     public static function ctype_space($text)
 161     {
 162         $text = self::convert_int_to_char_for_ctype($text);
 163
 164         return \is_string($text) && '' !== $text && !preg_match('/[^\s]/', $text);
 165     }
 166
 167     /**
 168      * Returns TRUE if every character in text is an uppercase letter.
 169      *
 170      * @see https://php.net/ctype-upper
 171      *
 172      * @param string|int $text
 173      *
 174      * @return bool
 175      */
 176     public static function ctype_upper($text)
 177     {
 178         $text = self::convert_int_to_char_for_ctype($text);
 179
 180         return \is_string($text) && '' !== $text && !preg_match('/[^A-Z]/', $text);
 181     }
 182
 183     /**
 184      * Returns TRUE if every character in text is a hexadecimal 'digit', that is a decimal digit or a character from [A-Fa-f] , FALSE otherwise.
 185      *
 186      * @see https://php.net/ctype-xdigit
 187      *
 188      * @param string|int $text
 189      *
 190      * @return bool
 191      */
 192     public static function ctype_xdigit($text)
 193     {
 194         $text = self::convert_int_to_char_for_ctype($text);
 195
 196         return \is_string($text) && '' !== $text && !preg_match('/[^A-Fa-f0-9]/', $text);
 197     }
 198
 199     /**
 200      * Converts integers to their char versions according to normal ctype behaviour, if needed.
 201      *
 202      * If an integer between -128 and 255 inclusive is provided,
 203      * it is interpreted as the ASCII value of a single character
 204      * (negative values have 256 added in order to allow characters in the Extended ASCII range).
 205      * Any other integer is interpreted as a string containing the decimal digits of the integer.
 206      *
 207      * @param string|int $int
 208      *
 209      * @return mixed
 210      */
 211     private static function convert_int_to_char_for_ctype($int)
 212     {
 213         if (!\is_int($int)) {
 214             return $int;
 215         }
 216
 217         if ($int < -128 || $int > 255) {
 218             return (string) $int;
 219         }
 220
 221         if ($int < 0) {
 222             $int += 256;
 223         }
 224
 225         return \chr($int);
 226     }
 227 }