ConvertCharset Class v. 1.1 2007-10-30 23:11ConvertCharset Class v. 1.1 2007-10-30 23:11You should know about...For good understanding this class you shouls read all this stuff first :) but if you are in a hurry just start the demo.php and see what's inside.
In a few words...Why ConvertCharset class?I have made this class because I had a lot of problems with diferent charsets. First because people from Microsoft wanted to have thair own encoding, second because people from Macromedia didn't thought about other languages, third because sometimes I need to use text written on MAC, and of course it has its own encoding :) Notice & remember:
So, this are main FEATURES of this class:
This is a list of charsets you can operate with, the basic rule is that a char have to be in both charsets, otherwise you'll get an error.
Now, to the point...Here are main variables.DEBUG_MODE You can set this value to:
Default value is 1, and during first steps with class it should be left as is. CONVERT_TABLES_DIR This is a place where you store all files with charset encodings. Filenames should have the same names as encodings. My advise is to keep existing names, because thay were taken from unicode.org ( www.unicode.org ), and after update to unicode 3.0 or 4.0 the names of files will be the same, so if you want to save your time...uff, leave the names as thay are for future updates. The directory with edings files should be in a class location directory by default, but of course you can change it if you like. @packageAll about charset...
|
Convert| PHP | string Convert(string $StringToChange) | v. 1.1 2007-10-30 01:09 |
|---|
ConvertCharset::Convert()
This is a basic function you are using. I hope that you can figure out this function syntax :-)
Arguments
The string you want to change :)
Return
Converted string in brand new encoding :)
ConvertArray| PHP | ConvertArray(mixed $array) |
|---|
ConvertCharset::ConvertArray()
This method converts all values from multi-dimentional array according to *From* and *To* charset. This method is available since v.1.1
Arguments
This can be multi-dimentional array or string. The $array argument is teken as reference (no return statement).
ConvertCharset| PHP | ConvertCharset(string $FromCharset, string $ToCharset, boolean $TurnOnEntities) |
|---|
ConvertCharset::ConvertCharset()
Arguments
DebugOutput| PHP | string DebugOutput(integer $Group, integer $Number, mix $Value) |
|---|
ConvertCharset::DebugOutput()
This function is not really necessary, the debug output could stay inside of source code but like this, it's easier to manage and translate. Besides I couldn't find good coment/debug class :-) Maybe I'll write one someday...
All messages depend on DEBUG_MODE level, as I was writing before you can set this value to:
Arguments
Message groupe: error - 0, notice - 1
Following message number
This walue is whatever you want, usualy it's some parameter value, for better message understanding.
Return
String with a proper message.
HexToUtf| PHP | string HexToUtf(string $UtfCharInHex) |
|---|
ConvertCharset::HexToUtf()
This simple function gets unicode char up to 4 bytes and return it as a regular char. It is very similar to UnicodeEntity function (link below). There is one difference in returned format. This time it's a regular char(s), in most cases it will be one or two chars.
| See also |
|---|
| ConvertCharset::UnicodeEntity() |
Arguments
Hexadecimal value of a unicode char.
Return
Encoded hexadecimal value as a regular char.
MakeConvertTable| PHP | array MakeConvertTable(string $FromCharset, string $ToCharset) |
|---|
CharsetChange::MakeConvertTable()
This function creates table with two SBCS (Single Byte Character Set). Every conversion is through this table.
"Format A" encoding file, if you have to build it by yourself should aplly these rules:
# # The entries are in ANSI X3.4 order. # 0x00 0x0000 # NULL end extra comment, if needed 0x01 0x0001 # START OF HEADING # Oh, one more thing, you can make comments inside of a rows if you like. 0x02 0x0002 # START OF TEXT 0x03 0x0003 # END OF TEXT next line, and so on...
You can get full tables with encodings from http://www.unicode.org
Arguments
Name of first encoding and first encoding filename (thay have to be the same)
Name of second encoding and second encoding filename (thay have to be the same). Optional for building a joined table.
Return
Table necessary to change one encoding to another.
UnicodeEntity| PHP | string UnicodeEntity(string $UnicodeString) |
|---|
CharsetChange::NumUnicodeEntity()
Unicode encoding bytes, bits representation. Each b represents a bit that can be used to store character data.
This function is written in a "long" way, for everyone who woluld like to analize the process of unicode encoding and understand it. All other functions like HexToUtf will be written in a "shortest" way I can write tham :) it does'n mean thay are short of course. You can chech it in HexToUtf() (link below) - very similar function.
IMPORTANT: Remember that $UnicodeString input CANNOT have single byte upper half extended ASCII codes, why? Because there is a posibility that this function will eat the following char thinking it's multibyte unicode char.
| See also |
|---|
| ConvertCharset::HexToUtf() |
Arguments
Input Unicode string (1 char can take more than 1 byte)
Return
This is an input string also with unicode chars, bus saved as entities
