61 * When a parser encounters this character, it calls parseReference()
62 * with the position immediately following the SYMBOL_REF. The symbol
63 * table parses the name, if there is one, and returns it.
64 *
65 * @draft ICU 2.8
66 * @deprecated This is a draft API and might change in a future release of ICU.
67 */
68 @Deprecated
69 public interface SymbolTable {
70
71 /**
72 * The character preceding a symbol reference name.
73 * @draft ICU 2.8
74 * @deprecated This is a draft API and might change in a future release of ICU.
75 */
76 @Deprecated
77 static final char SYMBOL_REF = '$';
78
79 /**
80 * Lookup the characters associated with this string and return it.
81 * Return <tt>null</tt> if no such name exists. The resultant
82 * array may have length zero.
83 * @param s the symbolic name to lookup
84 * @return a char array containing the name's value, or null if
85 * there is no mapping for s.
86 * @draft ICU 2.8
87 * @deprecated This is a draft API and might change in a future release of ICU.
88 */
89 @Deprecated
90 char[] lookup(String s);
91
92 /**
93 * Lookup the UnicodeMatcher associated with the given character, and
94 * return it. Return <tt>null</tt> if not found.
95 * @param ch a 32-bit code point from 0 to 0x10FFFF inclusive.
96 * @return the UnicodeMatcher object represented by the given
97 * character, or null if there is no mapping for ch.
98 * @draft ICU 2.8
99 * @deprecated This is a draft API and might change in a future release of ICU.
100 */
101 @Deprecated
102 UnicodeMatcher lookupMatcher(int ch);
103
104 /**
105 * Parse a symbol reference name from the given string, starting
106 * at the given position. If no valid symbol reference name is
107 * found, return null and leave pos unchanged. That is, if the
108 * character at pos cannot start a name, or if pos is at or after
109 * text.length(), then return null. This indicates an isolated
110 * SYMBOL_REF character.
111 * @param text the text to parse for the name
112 * @param pos on entry, the index of the first character to parse.
113 * This is the character following the SYMBOL_REF character. On
114 * exit, the index after the last parsed character. If the parse
|
61 * When a parser encounters this character, it calls parseReference()
62 * with the position immediately following the SYMBOL_REF. The symbol
63 * table parses the name, if there is one, and returns it.
64 *
65 * @draft ICU 2.8
66 * @deprecated This is a draft API and might change in a future release of ICU.
67 */
68 @Deprecated
69 public interface SymbolTable {
70
71 /**
72 * The character preceding a symbol reference name.
73 * @draft ICU 2.8
74 * @deprecated This is a draft API and might change in a future release of ICU.
75 */
76 @Deprecated
77 static final char SYMBOL_REF = '$';
78
79 /**
80 * Lookup the characters associated with this string and return it.
81 * Return {@code null} if no such name exists. The resultant
82 * array may have length zero.
83 * @param s the symbolic name to lookup
84 * @return a char array containing the name's value, or null if
85 * there is no mapping for s.
86 * @draft ICU 2.8
87 * @deprecated This is a draft API and might change in a future release of ICU.
88 */
89 @Deprecated
90 char[] lookup(String s);
91
92 /**
93 * Lookup the UnicodeMatcher associated with the given character, and
94 * return it. Return {@code null} if not found.
95 * @param ch a 32-bit code point from 0 to 0x10FFFF inclusive.
96 * @return the UnicodeMatcher object represented by the given
97 * character, or null if there is no mapping for ch.
98 * @draft ICU 2.8
99 * @deprecated This is a draft API and might change in a future release of ICU.
100 */
101 @Deprecated
102 UnicodeMatcher lookupMatcher(int ch);
103
104 /**
105 * Parse a symbol reference name from the given string, starting
106 * at the given position. If no valid symbol reference name is
107 * found, return null and leave pos unchanged. That is, if the
108 * character at pos cannot start a name, or if pos is at or after
109 * text.length(), then return null. This indicates an isolated
110 * SYMBOL_REF character.
111 * @param text the text to parse for the name
112 * @param pos on entry, the index of the first character to parse.
113 * This is the character following the SYMBOL_REF character. On
114 * exit, the index after the last parsed character. If the parse
|