--- old/jdk/src/java.base/share/classes/sun/text/normalizer/RangeValueIterator.java 2015-07-13 16:12:08.000000000 +0900 +++ /dev/null 2015-07-13 16:12:08.000000000 +0900 @@ -1,141 +0,0 @@ -/* - * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -/* - ******************************************************************************* - * (C) Copyright IBM Corp. 1996-2005 - All Rights Reserved * - * * - * The original version of this source code and documentation is copyrighted * - * and owned by IBM, These materials are provided under terms of a License * - * Agreement between IBM and Sun. This technology is protected by multiple * - * US and International patents. This notice and attribution to IBM may not * - * to removed. * - ******************************************************************************* - */ - -package sun.text.normalizer; - -/** - *

Interface for enabling iteration over sets of - * {@code }, - * where index is the sorted integer index in ascending order and value, its - * associated integer value. - *

The result for each iteration is the consecutive range of - * {@code } with the same value. Result is represented by - * {@code } where - *

- *

- * Hence value(start) = value(start + 1) = .... = value(start + n) = .... = - * value(limit - 1). However value(start -1) != value(start) and - * value(limit) != value(start). - * - *

Most implementations will be created by factory methods, such as the - * character type iterator in UCharacter.getTypeIterator. See example below. - * - * Example of use:
- *

- * RangeValueIterator iterator = UCharacter.getTypeIterator();
- * RangeValueIterator.Element result = new RangeValueIterator.Element();
- * while (iterator.next(result)) {
- *     System.out.println("Codepoint \\u" +
- *                        Integer.toHexString(result.start) +
- *                        " to codepoint \\u" +
- *                        Integer.toHexString(result.limit - 1) +
- *                        " has the character type " + result.value);
- * }
- * 
- * @author synwee - * @stable ICU 2.6 - */ -public interface RangeValueIterator -{ - // public inner class --------------------------------------------- - - /** - * Return result wrapper for com.ibm.icu.util.RangeValueIterator. - * Stores the start and limit of the continous result range and the - * common value all integers between [start, limit - 1] has. - * @stable ICU 2.6 - */ - public class Element - { - // public data member --------------------------------------------- - - /** - * Starting integer of the continuous result range that has the same - * value - * @stable ICU 2.6 - */ - public int start; - /** - * (End + 1) integer of continuous result range that has the same - * value - * @stable ICU 2.6 - */ - public int limit; - /** - * Gets the common value of the continous result range - * @stable ICU 2.6 - */ - public int value; - - // public constructor -------------------------------------------- - - /** - * Empty default constructor to make javadoc happy - * @stable ICU 2.4 - */ - public Element() - { - } - } - - // public methods ------------------------------------------------- - - /** - *

Gets the next maximal result range with a common value and returns - * true if we are not at the end of the iteration, false otherwise.

- *

If the return boolean is a false, the contents of elements will not - * be updated.

- * @param element for storing the result range and value - * @return true if we are not at the end of the iteration, false otherwise. - * @see Element - * @stable ICU 2.6 - */ - public boolean next(Element element); - - /** - * Resets the iterator to the beginning of the iteration. - * @stable ICU 2.6 - */ - public void reset(); -}