Lines Matching full:code
39 * <code>Transliterator</code> is an abstract class that
50 * In fact, <code>Transliterator</code> defines a very general API
53 * entirely by subclasses of <code>Transliterator</code>.
57 * <p><code>Transliterator</code> objects are <em>stateless</em>; they
59 * <code>transliterate()</code>. (However, this does <em>not</em>
67 * <code>Transliterator</code> objects are stateless, the source text
75 * transliteration. For example, given a string <code>input</code>
76 * and a transliterator <code>t</code>, the call
78 * \htmlonly<blockquote>\endhtmlonly<code>String result = t.transliterate(input);
79 * </code>\htmlonly</blockquote>\endhtmlonly
93 * <p>In keyboard transliteration, a <code>Replaceable</code> buffer
99 * <p>Consider the simple <code>RuleBasedTransliterator</code>:
101 * \htmlonly<blockquote>\endhtmlonly<code>
104 * </code>\htmlonly</blockquote>\endhtmlonly
111 * \htmlonly<blockquote>\endhtmlonly<code>
114 * </code>\htmlonly</blockquote>\endhtmlonly
120 * <code>transliterate()</code>. Typically, the cursor will
126 * <code>transliterate()</code>, including the cursor, start,
128 * passed in an <code>int[]</code> array. The <code>START</code> index
131 * the committed index; that's the <code>CURSOR</code>). The
132 * <code>CURSOR</code> index, described above, marks the point at
135 * between possible inputs. The <code>CURSOR</code> can also be
136 * explicitly set by rules in a <code>RuleBasedTransliterator</code>.
137 * Any characters before the <code>CURSOR</code> index are frozen;
140 * <code>LIMIT</code> index, which marks the end of the substring that
146 * for more characters to arrive. When the client code knows that no
149 * <code>finishTransliteration()</code> to complete any
163 * The <code>Transliterator</code> method <code>getInverse()</code>
165 * <code>null</code> otherwise. However, the result of
166 * <code>getInverse()</code> usually will <em>not</em> be a true
184 * <b>AB</b><code>.getInverse()</code> could legitimately return
209 * <p>In general, client code should use the factory method
212 * <code>getAvailableIDs()</code>. Since transliterators are mutable,
218 * <code>registerInstance()</code> at run time. A registered instance
231 * <code>handleTransliterate()</code>. <p>Subclasses should override
232 * the <code>transliterate()</code> method taking a
233 * <code>Replaceable</code> and the <code>transliterate()</code>
234 * method taking a <code>String</code> and <code>StringBuffer</code>
382 * @param start the beginning index, inclusive; <code>0 <= start
383 * <= limit</code>.
384 * @param limit the ending index, exclusive; <code>start <= limit
385 * <= text.length()</code>.
386 * @return The new limit index. The text previously occupying <code>[start,
387 * limit)</code> has been transliterated, possibly to a string of a different
388 * length, at <code>[start, </code><em>new-limit</em><code>)</code>, where
407 * <code>insertion</code> will be inserted into <code>text</code>
408 * at <code>index.limit</code>, advancing
409 * <code>index.limit</code> by <code>insertion.length()</code>.
411 * <code>text</code> between <code>index.cursor</code> and
412 * <code>index.limit</code>. Characters before
413 * <code>index.cursor</code> will not be changed.
415 * <p>Upon return, values in <code>index</code> will be updated.
416 * <code>index.start</code> will be advanced to the first
418 * <code>index.cursor</code> and <code>index.limit</code> will
423 * with <code>index.start</code> and <code>index.limit</code>
424 * set to indicate the portion of <code>text</code> to be
425 * transliterated, and <code>index.cursor == index.start</code>.
426 * Thereafter, <code>index</code> can be used without
428 * <code>text</code> are made via this method.
442 * <ul><li><code>index.start</code>: the beginning index,
443 * inclusive; <code>0 <= index.start <= index.limit</code>.
445 * <li><code>index.limit</code>: the ending index, exclusive;
446 * <code>index.start <= index.limit <= text.length()</code>.
447 * <code>insertion</code> is inserted at
448 * <code>index.limit</code>.
450 * <li><code>index.cursor</code>: the next character to be
451 * considered for transliteration; <code>index.start <=
452 * index.cursor <= index.limit</code>. Characters before
453 * <code>index.cursor</code> will not be changed by future calls
458 * <code>index.limit</code>. If <code>null</code> then no text
462 * @exception IllegalArgumentException if <code>index</code>
481 * <code>index.limit</code>.
511 * <code>transliterate()</code>.
535 * <code>index.limit</code>.
549 * <code>originalStart</code> refer to the value of
550 * <code>pos.start</code> upon entry.
553 * <li>If <code>incremental</code> is false, then this method
555 * <code>pos.start</code> and <code>pos.limit</code>. Upon return
556 * <code>pos.start</code> must == <code> pos.limit</code>.</li>
558 * <li>If <code>incremental</code> is true, then this method
560 * <code>pos.start</code> and <code>pos.limit</code> that can be
562 * of text at <code>pos.limit</code>. Upon return,
563 * <code>pos.start</code> should be in the range
564 * [<code>originalStart</code>, <code>pos.limit</code>).
565 * <code>pos.start</code> should be positioned such that
566 * characters [<code>originalStart</code>, <code>
567 * pos.start</code>) will not be changed in the future by this
568 * transliterator and characters [<code>pos.start</code>,
569 * <code>pos.limit</code>) are unchanged.</li>
576 * <li> <code>pos.limit</code> and <code>pos.contextLimit</code>
578 * between <code>pos.start</code> and <code>pos.limit</code>. The
579 * difference <code> pos.contextLimit - pos.limit</code> should
582 * <li><code>pos.contextStart</code> should not change.</li>
584 * <li>Upon return, neither <code>pos.start</code> nor
585 * <code>pos.limit</code> should be less than
586 * <code>originalStart</code>.</li>
588 * <li>Text before <code>originalStart</code> and text after
589 * <code>pos.limit</code> should not change.</li>
591 * <li>Text before <code>pos.contextStart</code> and text after
592 * <code> pos.contextLimit</code> should be ignored.</li>
596 * [<code>pos.start</code>, <code>pos.limit</code>) are filtered.
599 * <code>filteredTransliterate()</code>.
603 * [<code>pos.start</code>, <code>pos.limit</code>) without
604 * applying the filter. End user code should call <code>
605 * transliterate()</code> instead of this method. Subclass code
607 * <code>filteredTransliterate()</code> instead of this method.<p>
616 * <code>pos.limit</code> and act accordingly. Otherwise,
617 * transliterate all text between <code>pos.start</code> and
618 * <code>pos.limit</code> and move <code>pos.start</code> up to
619 * <code>pos.limit</code>.
683 * by <code>Transliterator</code> returns zero; subclasses
709 * If this identifier is passed to <code>createInstance()</code>, it
735 * <code>java.text</code> package.
739 * <code>MessageFormat</code> pattern from the resource data. The
792 * resulting transliterator. That is, if <code>getID()</code>
794 * <code>createInstance("B-A")</code>, or <code>null</code> if that
802 * exact, of this transliterator, or <code>null</code> if no such
810 * Returns a <code>Transliterator</code> object given its ID.
812 * using <code>registerInstance()</code>.
814 * @param ID a valid ID, as enumerated by <code>getAvailableIDs()</code>
819 * @return A <code>Transliterator</code> object with the given ID
831 * Returns a <code>Transliterator</code> object given its ID.
833 * using <code>registerInstance()</code>.
834 * @param ID a valid ID, as enumerated by <code>getAvailableIDs()</code>
837 * @return A <code>Transliterator</code> object with the given ID
845 * Returns a <code>Transliterator</code> object constructed from
856 * @param status Output param set to success/failure code.
905 * @param ec input-output error code
981 * <code>Transliterator</code> with the system. When
990 * <code>Transliterator</code> that defines <tt>clone()</tt>
1086 * @return the <code>Object</code> that was registered with
1087 * <code>ID</code>, or <code>null</code> if none was
1099 * @param ec input-output error code
