fop 1.1

org.apache.fop.complexscripts.util
Class UTF32

java.lang.Object
  extended by org.apache.fop.complexscripts.util.UTF32

public final class UTF32
extends java.lang.Object

UTF32 related utilities.

This work was originally authored by Glenn Adams (gadams@apache.org).


Method Summary
static java.lang.String fromUTF32(java.lang.Integer[] sa)
          Convert a Unicode scalar array (UTF-32) a Java string (UTF-16).
static java.lang.Integer[] toUTF32(java.lang.String s, int substitution, boolean errorOnSubstitution)
          Convert Java string (UTF-16) to a Unicode scalar array (UTF-32).
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

toUTF32

public static java.lang.Integer[] toUTF32(java.lang.String s,
                                          int substitution,
                                          boolean errorOnSubstitution)
                                   throws java.lang.IllegalArgumentException
Convert Java string (UTF-16) to a Unicode scalar array (UTF-32). Note that if there are any non-BMP encoded characters present in the input, then the number of entries in the output array will be less than the number of elements in the input string. Any

Parameters:
s - input string
substitution - value to substitute for ill-formed surrogate
errorOnSubstitution - throw runtime exception (IllegalArgumentException) in case this argument is true and a substitution would be attempted
Returns:
output scalar array
Throws:
java.lang.IllegalArgumentException - if substitution required and errorOnSubstitution is not false

fromUTF32

public static java.lang.String fromUTF32(java.lang.Integer[] sa)
                                  throws java.lang.IllegalArgumentException
Convert a Unicode scalar array (UTF-32) a Java string (UTF-16).

Parameters:
sa - input scalar array
Returns:
output (UTF-16) string
Throws:
java.lang.IllegalArgumentException - if an input scalar value is illegal, e.g., a surrogate or out of range

fop 1.1

Copyright 1999-2012 The Apache Software Foundation. All Rights Reserved.