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 |