File Source for CharsetC.php

<?php
/**
* ----------------------------------------------------------------------
*
* Copyright (c) 2006-2013 Khaled Al-Sham'aa.
*
* http://www.ar-php.org
*
* PHP Version 5
*
* ----------------------------------------------------------------------
*
* LICENSE
*
* This program is open source product; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License (LGPL)
* as published by the Free Software Foundation; either version 3
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/lgpl.txt>.
*
* ----------------------------------------------------------------------
*
* Class Name: Arabic Charset Converter
*
* Filename: CharsetC.php
*
* Original Author(s): Khaled Al-Sham'aa <khaled@ar-php.org>
*
* Purpose: Convert a given Arabic string from one Arabic character set to
* another, those available character sets includes the most popular
* three: Windows-1256, ISO 8859-6, and UTF-8
*
* ----------------------------------------------------------------------
*
* Arabic Charset Converter
*
* PHP class to convert a given Arabic string from one Arabic character set
* to another, those available character sets includes the most popular three:
* Windows-1256, ISO 8859-6, and UTF-8.
*
* Example:
* <code>
* include('./I18N/Arabic.php');
* $obj = new I18N_Arabic('CharsetC');
*
* $obj->setInputCharset('windows-1256');
* $obj->setOutputCharset('utf-8');
*
* $charset = $obj->getOutputCharset();
*
* $text = $obj->convert($text);
* </code>
*
* @category I18N
* @package I18N_Arabic
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
* @copyright 2006-2013 Khaled Al-Sham'aa
*
* @license LGPL <http://www.gnu.org/licenses/lgpl.txt>
* @link http://www.ar-php.org
*/
// New in PHP V5.3: Namespaces
// namespace I18N\Arabic;
//
// $obj = new I18N\Arabic\CharsetC();
//
// use I18N\Arabic;
// $obj = new Arabic\CharsetC();
//
// use I18N\Arabic\CharsetC as CharsetC;
// $obj = new CharsetC();
/**
* This PHP class converts a given Arabic string from
* one Arabic character set to another
*
* @category I18N
* @package I18N_Arabic
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
* @copyright 2006-2013 Khaled Al-Sham'aa
*
* @license LGPL <http://www.gnu.org/licenses/lgpl.txt>
* @link http://www.ar-php.org
*/
class I18N_Arabic_CharsetC
{
private $_utfStr = '';
private $_winStr = '';
private $_isoStr = '';
private $_htmlStr = '';
// Hold an instance of the class
private static $_instance;
/**
* Loads initialize values (this should be private method because of singleton)
*
* @param array $sets Charsets you would like to support
*/
public function __construct($sets = array('windows-1256', 'utf-8'))
{
$handle = fopen(dirname(__FILE__).'/data/charset/charset.src', 'r');
if ($handle) {
$this->_utfStr = fgets($handle, 4096);
$this->_winStr = fgets($handle, 4096);
$this->_isoStr = fgets($handle, 4096);
$this->_htmlStr = fgets($handle, 4096);
fclose($handle);
}
if (in_array('windows-1256', $sets)) {
include dirname(__FILE__).'/data/charset/_windows1256.php';
}
if (in_array('iso-8859-6', $sets)) {
include dirname(__FILE__).'/data/charset/_iso88596.php';
}
if (in_array('utf-8', $sets)) {
include dirname(__FILE__).'/data/charset/_utf8.php';
}
if (in_array('bug', $sets)) {
include dirname(__FILE__).'/data/charset/_bug.php';
}
if (in_array('html', $sets)) {
include dirname(__FILE__).'/data/charset/_html.php';
}
}
/**
* The singleton method
*
* @return object Instance of this class
*
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public static function singleton()
{
// if (!(self::$_instance instanceof self)) {
if (!isset(self::$_instance)) {
$c = __CLASS__;
self::$_instance = new $c;
}
return self::$_instance;
}
/**
* Prevent users to clone the instance
*
* @return void
*/
private function __clone()
{
trigger_error('Clone is not allowed.', E_USER_ERROR);
}
/**
* Get HTML entity from given position
*
* @param integer $index Extract position
*
* @return string HTML entity
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function getHTML($index)
{
return trim(substr($this->_htmlStr, $index*4, 4));
}
/**
* Get UTF character from given position
*
* @param integer $index Extract position
*
* @return string UTF character
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function getUTF($index)
{
return trim(substr($this->_utfStr, $index*2, 2));
}
/**
* Get extract position of a given UTF character
*
* @param string $char UTF character
*
* @return integer Extract position
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function findUTF($char)
{
if (!$char) {
return false;
}
return strpos($this->_utfStr, $char)/2;
}
/**
* Get Windows-1256 character from given position
*
* @param integer $index Extract position
*
* @return string Windows-1256 character
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function getWIN($index)
{
return substr($this->_winStr, $index, 1);
}
/**
* Get extract position of a given Windows-1256 character
*
* @param string $char Windows-1256 character
*
* @return integer Extract position
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function findWIN($char)
{
if (!$char) {
return false;
}
return strpos($this->_winStr, $char);
}
/**
* Get ISO-8859-6 character from given position
*
* @param integer $index Extract position
*
* @return string ISO-8859-6 character
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function getISO($index)
{
return substr($this->_isoStr, $index, 1);
}
/**
* Get extract position of a given ISO-8859-6 character
*
* @param string $char ISO-8859-6 character
*
* @return integer Extract position
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
protected function findISO($char)
{
if (!$char) {
return false;
}
return strpos($this->_isoStr, $char);
}
/**
* Convert Arabic string from Windows-1256 to ISO-8859-6 format
*
* @param string $string Original Arabic string in Windows-1256 format
*
* @return string Converted Arabic string in ISO-8859-6 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function win2iso($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findWIN($char);
if (is_int($key)) {
$converted .= $this->getISO($key);
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from Windows-1256 to UTF-8 format
*
* @param string $string Original Arabic string in Windows-1256 format
*
* @return string Converted Arabic string in Windows-1256 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function win2utf($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findWIN($char);
if (is_int($key)) {
$converted .= $this->getUTF($key);
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from Windows-1256 to HTML entities format
*
* @param string $string Original Arabic string in Windows-1256 format
*
* @return string Converted Arabic string in HTML entities format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function win2html($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findWIN($char);
if (is_int($key) && $key < 58) {
$converted .= '&#' . $this->getHTML($key) . ';';
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from ISO-8859-6 to HTML entities format
*
* @param string $string Original Arabic string in ISO-8859-6 format
*
* @return string Converted Arabic string in HTML entities format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function iso2html($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findISO($char);
if (is_int($key) && $key < 58) {
$converted .= '&#' . $this->getHTML($key) . ';';
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from UTF-8 to HTML entities format
*
* @param string $string Original Arabic string in UTF-8 format
*
* @return string Converted Arabic string in HTML entities format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function utf2html($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 216 || $ascii == 217) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = $this->findUTF($code);
if (is_int($key) && $key < 58) {
$converted .= '&#' . $this->getHTML($key) . ';';
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from ISO-8859-6 to Windows-1256 format
*
* @param string $string Original Arabic string in ISO-8859-6 format
*
* @return string Converted Arabic string in Windows-1256 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function iso2win($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findISO($char);
if (is_int($key)) {
$converted .= $this->getWIN($key);
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from ISO-8859-6 to UTF-8 format
*
* @param string $string Original Arabic string in ISO-8859-6 format
*
* @return string Converted Arabic string in UTF-8 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function iso2utf($string)
{
$chars = preg_split('//', $string);
$converted = null;
foreach ($chars as $char) {
$key = $this->findISO($char);
if (is_int($key)) {
$converted .= $this->getUTF($key);
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from UTF-8 to Windows-1256 format
*
* @param string $string Original Arabic string in UTF-8 format
*
* @return string Converted Arabic string in Windows-1256 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function utf2win($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 216 || $ascii == 217) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = $this->findUTF($code);
if (is_int($key)) {
$converted .= $this->getWIN($key);
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert Arabic string from UTF-8 to ISO-8859-6 format
*
* @param string $string Original Arabic string in UTF-8 format
*
* @return string Converted Arabic string in ISO-8859-6 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function utf2iso($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 216 || $ascii == 217) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = $this->findUTF($code);
if (is_int($key)) {
$converted .= $this->getISO($key);
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert buggy Arabic imported database string to Windows-1256 format
*
* @param string $string Original corrupted Arabic string, usually when export
* database from MySQL < 4.1 into MySQL >= 4.1
* using phpMyAdmin tool where each Arabic UTF-8
* character translate as two ISO-8859-1 characters in
* export, then translate them into UTF-8 format in import.
*
* @return string Converted Arabic string in Windows-1256 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function bug2win($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 195 || $ascii == 194) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = array_search($code, $this->bug);
if (is_int($key)) {
$converted .= $this->getWIN($key);
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert buggy Arabic imported database string to UTF-8 format
*
* @param string $string Original corrupted Arabic string, usually when export
* database from MySQL < 4.1 into MySQL >= 4.1 using
* phpMyAdmin tool where each Arabic UTF-8 character
* translate as two ISO-8859-1 characters in export,
* then translate them into UTF-8 format in import.
*
* @return string Converted Arabic string in UTF-8 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function bug2utf($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 195 || $ascii == 194) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = array_search($code, $this->bug);
if (is_int($key)) {
$converted .= $this->getUTF($key);
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert buggy Arabic imported database string to ISO-8859-6 format
*
* @param string $string Original corrupted Arabic string, usually when export
* database from MySQL < 4.1 into MySQL >= 4.1 using
* phpMyAdmin tool where each Arabic UTF-8 character
* translate as two ISO-8859-1 characters in export,
* then translate them into UTF-8 format in import.
*
* @return string Converted Arabic string in ISO-8859-6 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function bug2iso($string)
{
$chars = preg_split('//', $string);
$converted = null;
$cmp = false;
foreach ($chars as $char) {
$ascii = ord($char);
if (($ascii == 195 || $ascii == 194) && !$cmp) {
$code = $char;
$cmp = true;
continue;
}
if ($cmp) {
$code .= $char;
$cmp = false;
$key = array_search($code, $this->bug);
if (is_int($key)) {
$converted .= $this->getISO($key);
}
} else {
$converted .= $char;
}
}
return $converted;
}
/**
* Convert buggy Arabic string as HTML entities to UTF-8 format
*
* @param string $string Original corrupted Arabic string, usually when insert
* Arabic string as HTML entities.
*
* @return string Converted Arabic string in UTF-8 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function html2utf($string)
{
$converted = preg_replace($this->html, $this->utf8, $string);
return $converted;
}
/**
* Convert buggy Arabic string as HTML entities to Windows-1256 format
*
* @param string $string Original corrupted Arabic string, usually when insert
* Arabic string as HTML entities.
*
* @return string Converted Arabic string in Windows-1256 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function html2win($string)
{
$converted = preg_replace($this->html, $this->windows1256, $string);
return $converted;
}
/**
* Convert buggy Arabic string as HTML entities to ISO-8859-6 format
*
* @param string $string Original corrupted Arabic string, usually when insert
* Arabic string as HTML entities.
*
* @return string Converted Arabic string in ISO-8859-6 format
* @author Khaled Al-Sham'aa <khaled@ar-php.org>
*/
public function html2iso($string)
{
$converted = preg_replace($this->html, $this->iso88596, $string);
return $converted;
}
}

Source for file CharsetC.php