| java.lang.Object
 com.ibm.icu.lang.UScriptRun
| UScriptRun | | final public class UScriptRun (Code) | | UScriptRun is used to find runs of characters in
the same script, as defined in the UScript class.
It implements a simple iterator over an array of characters.
The iterator will assign COMMON and INHERITED
characters to the same script as the preceeding characters. If the
COMMON and INHERITED characters are first, they will be assigned to
the same script as the following characters.
The iterator will try to match paired punctuation. If it sees an
opening punctuation character, it will remember the script that
was assigned to that character, and assign the same script to the
matching closing punctuation.
No attempt is made to combine related scripts into a single run. In
particular, Hiragana, Katakana, and Han characters will appear in seperate
runs.
Here is an example of how to iterate over script runs:
void printScriptRuns(char[] text)
{
UScriptRun scriptRun = new UScriptRun(text);
while (scriptRun.next()) {
int start = scriptRun.getScriptStart();
int limit = scriptRun.getScriptLimit();
int script = scriptRun.getScriptCode();
System.out.println("Script \"" + UScript.getName(script) + "\" from " +
start + " to " + limit + ".");
}
}
|
| Constructor Summary | |
| public | UScriptRun()
Construct an empty UScriptRun object. | | public | UScriptRun(String text)
Construct a UScriptRun object which iterates over the
characters in the given string. | | public | UScriptRun(String text, int start, int count)
Construct a UScriptRun object which iterates over a subrange
of the characetrs in the given string. | | public | UScriptRun(char[] chars)
Construct a UScriptRun object which iterates over the given
characetrs. | | public | UScriptRun(char[] chars, int start, int count)
Construct a UScriptRun object which iterates over a subrange
of the given characetrs. |
| Method Summary | |
| final public int | getScriptCode()
Get the script code for the script of the current script run. | | final public int | getScriptLimit()
Get the index of the first character after the current script run. | | final public int | getScriptStart()
Get the starting index of the current script run. | | final public boolean | next()
Find the next script run. | | final public void | reset()
Reset the iterator to the start of the text. | | final public void | reset(int start, int count)
Reset the iterator to iterate over the given range of the text. | | final public void | reset(char[] chars, int start, int count)
Reset the iterator to iterate over count characters
in chars starting at start. | | final public void | reset(char[] chars)
Reset the iterator to iterate over the characters
in chars. | | final public void | reset(String text, int start, int count)
Reset the iterator to iterate over count characters
in text starting at start. | | final public void | reset(String text)
Reset the iterator to iterate over the characters
in text. |
| UScriptRun | | public UScriptRun()(Code) | | Construct an empty UScriptRun object. The next()
method will return false the first time it is called.
|
| UScriptRun | | public UScriptRun(String text)(Code) | | Construct a UScriptRun object which iterates over the
characters in the given string.
Parameters:
text - the string of characters over which to iterate. |
| UScriptRun | | public UScriptRun(String text, int start, int count)(Code) | | Construct a UScriptRun object which iterates over a subrange
of the characetrs in the given string.
Parameters:
text - the string of characters over which to iterate.
Parameters:
start - the index of the first character over which to iterate
Parameters:
count - the number of characters over which to iterate |
| UScriptRun | | public UScriptRun(char[] chars)(Code) | | Construct a UScriptRun object which iterates over the given
characetrs.
Parameters:
chars - the array of characters over which to iterate. |
| UScriptRun | | public UScriptRun(char[] chars, int start, int count)(Code) | | Construct a UScriptRun object which iterates over a subrange
of the given characetrs.
Parameters:
chars - the array of characters over which to iterate.
Parameters:
start - the index of the first character over which to iterate
Parameters:
count - the number of characters over which to iterate |
| getScriptCode | | final public int getScriptCode()(Code) | | Get the script code for the script of the current script run.
the script code for the script of the current script run.
See Also: com.ibm.icu.lang.UScript |
| getScriptLimit | | final public int getScriptLimit()(Code) | | Get the index of the first character after the current script run.
the index of the first character after the current script run. |
| getScriptStart | | final public int getScriptStart()(Code) | | Get the starting index of the current script run.
the index of the first character in the current script run. |
| next | | final public boolean next()(Code) | | Find the next script run. Returns false if there
isn't another run, returns true if there is.
false if there isn't another run, true if there is. |
| reset | | final public void reset()(Code) | | Reset the iterator to the start of the text.
|
| reset | | final public void reset(int start, int count) throws IllegalArgumentException(Code) | | Reset the iterator to iterate over the given range of the text. Throws
IllegalArgumentException if the range is outside of the bounds of the
character array.
Parameters:
start - the index of the new first character over which to iterate
Parameters:
count - the new number of characters over which to iterate.
exception:
IllegalArgumentException - |
| reset | | final public void reset(char[] chars, int start, int count)(Code) | | Reset the iterator to iterate over count characters
in chars starting at start. This allows
clients to reuse an iterator.
Parameters:
chars - the new array of characters over which to iterate.
Parameters:
start - the index of the first character over which to iterate.
Parameters:
count - the number of characters over which to iterate. |
| reset | | final public void reset(char[] chars)(Code) | | Reset the iterator to iterate over the characters
in chars. This allows clients to reuse an iterator.
Parameters:
chars - the new array of characters over which to iterate. |
| reset | | final public void reset(String text, int start, int count)(Code) | | Reset the iterator to iterate over count characters
in text starting at start. This allows
clients to reuse an iterator.
Parameters:
text - the new string of characters over which to iterate.
Parameters:
start - the index of the first character over which to iterate.
Parameters:
count - the nuber of characters over which to iterate. |
| reset | | final public void reset(String text)(Code) | | Reset the iterator to iterate over the characters
in text. This allows clients to reuse an iterator.
Parameters:
text - the new string of characters over which to iterate. |
|
|