Working with Text |
If your non-Unicode text is stored in a byte array, you can convert it to Unicode with one of theString
constructor methods. Conversely, you can convert aString
object into a byte array of non-Unicode characters with theString.getBytes
method. When invoking each of these methods, you specify the encoding identifier as one of the parameters.The example that follows converts characters between UTF8 and Unicode. UTF8 is a compact binary form for encoding 16-bit Unicode characters into 8 bits. The source code for the example is in the file named
StringConverter.java
.The
StringConverter
program starts by creating aString
containing Unicode characters:String original = new String("A" + "\u00ea" + "\u00f1" + "\u00fc" + "C");When printed, the
String
namedoriginal
appears as:To convert theAêñüCString
object to UTF8, invoke thegetBytes
method and specify the appropriate encoding identifier as a parameter. ThegetBytes
method returns an array of bytes in UTF8 format. To create aString
object from an array of non-Unicode bytes, invoke theString
constructor with the encoding parameter. The code that makes these calls is enclosed in atry
block, in case the specified encoding is unsupported:Thetry { byte[] utf8Bytes = original.getBytes("UTF8"); byte[] defaultBytes = original.getBytes(); String roundTrip = new String(utf8Bytes, "UTF8"); System.out.println("roundTrip = " + roundTrip); System.out.println(); printBytes(utf8Bytes, "utf8Bytes"); System.out.println(); printBytes(defaultBytes, "defaultBytes"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); }StringConverter
program prints out the values in theutf8Bytes
anddefaultBytes
arrays to demonstrate an important point: The length of the converted text might not be the same as the length of the source text. Some Unicode characters translate into single bytes, and others into pairs of bytes.The
printBytes
method displays the byte arrays by invoking thebyteToHex
method, which is defined in theUnicodeFormatter.java
source file. Here is theprintBytes
method:The output of thepublic static void printBytes(byte[] array, String name) { for (int k = 0; k < array.length; k++) { System.out.println(name + "[" + k + "] = " + "0x" + UnicodeFormatter.byteToHex(array[k])); } }printBytes
method follows. Note that only the first and last bytes, the "A" and "C" characters, are the same in both arrays:utf8Bytes[0] = 0x41 utf8Bytes[1] = 0xc3 utf8Bytes[2] = 0xaa utf8Bytes[3] = 0xc3 utf8Bytes[4] = 0xb1 utf8Bytes[5] = 0xc3 utf8Bytes[6] = 0xbc utf8Bytes[7] = 0x43 defaultBytes[0] = 0x41 defaultBytes[1] = 0xea defaultBytes[2] = 0xf1 defaultBytes[3] = 0xfc defaultBytes[4] = 0x43
Working with Text |