includes/compat/normal/UtfNormalUtil.php

   1 <?php
   2 /**
   3  * Some of these functions are adapted from places in MediaWiki.
   4  * Should probably merge them for consistency.
   5  *
   6  * Copyright © 2004 Brion Vibber <brion@pobox.com>
   7  * https://www.mediawiki.org/
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write to the Free Software Foundation, Inc.,
  21  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  22  * http://www.gnu.org/copyleft/gpl.html
  23  *
  24  * @file
  25  * @ingroup UtfNormal
  26  */
  27
  28
  29 use UtfNormal\Utils;
  30
  31 /**
  32  * Return UTF-8 sequence for a given Unicode code point.
  33  *
  34  * @param $codepoint Integer:
  35  * @return String
  36  * @throws InvalidArgumentException if fed out of range data.
  37  * @public
  38  * @deprecated since 1.25, use UtfNormal\Utils directly
  39  */
  40 function codepointToUtf8( $codepoint ) {
  41         return Utils::codepointToUtf8( $codepoint );
  42 }
  43
  44 /**
  45  * Take a series of space-separated hexadecimal numbers representing
  46  * Unicode code points and return a UTF-8 string composed of those
  47  * characters. Used by UTF-8 data generation and testing routines.
  48  *
  49  * @param $sequence String
  50  * @return String
  51  * @throws InvalidArgumentException if fed out of range data.
  52  * @private
  53  * @deprecated since 1.25, use UtfNormal\Utils directly
  54  */
  55 function hexSequenceToUtf8( $sequence ) {
  56         return Utils::hexSequenceToUtf8( $sequence );
  57 }
  58
  59 /**
  60  * Take a UTF-8 string and return a space-separated series of hex
  61  * numbers representing Unicode code points. For debugging.
  62  *
  63  * @fixme this is private but extensions + maint scripts are using it
  64  * @param string $str UTF-8 string.
  65  * @return string
  66  * @private
  67  */
  68 function utf8ToHexSequence( $str ) {
  69         $buf = '';
  70         foreach ( preg_split( '//u', $str, -1, PREG_SPLIT_NO_EMPTY ) as $cp ) {
  71                 $buf .= sprintf( '%04x ', UtfNormal\Utils::utf8ToCodepoint( $cp ) );
  72         }
  73
  74         return rtrim( $buf );
  75 }
  76
  77 /**
  78  * Determine the Unicode codepoint of a single-character UTF-8 sequence.
  79  * Does not check for invalid input data.
  80  *
  81  * @param $char String
  82  * @return Integer
  83  * @public
  84  * @deprecated since 1.25, use UtfNormal\Utils directly
  85  */
  86 function utf8ToCodepoint( $char ) {
  87         return Utils::utf8ToCodepoint( $char );
  88 }
  89
  90 /**
  91  * Escape a string for inclusion in a PHP single-quoted string literal.
  92  *
  93  * @param string $string string to be escaped.
  94  * @return String: escaped string.
  95  * @public
  96  * @deprecated since 1.25, use UtfNormal\Utils directly
  97  */
  98 function escapeSingleString( $string ) {
  99         return Utils::escapeSingleString( $string );
 100 }