Replaceable is an interface representing a
- * string of characters that supports the replacement of a range of
- * itself with a new string of characters. It is used by APIs that
- * change a piece of text while retaining metadata. Metadata is data
- * other than the Unicode characters returned by char32At(). One
- * example of metadata is style attributes; another is an edit
- * history, marking each character with an author and revision number.
- *
- * An implicit aspect of the Replaceable API is that
- * during a replace operation, new characters take on the metadata of
- * the old characters. For example, if the string "the bold
- * font" has range (4, 8) replaced with "strong", then it becomes "the
- * strong font".
- *
- *
Replaceable specifies ranges using a start
- * offset and a limit offset. The range of characters thus specified
- * includes the characters at offset start..limit-1. That is, the
- * start offset is inclusive, and the limit offset is exclusive.
- *
- *
Replaceable also includes API to access characters
- * in the string: length(), charAt(),
- * char32At(), and extractBetween().
- *
- *
For a subclass to support metadata, typical behavior of
- * replace() is the following:
- *
Copyright © IBM Corporation 1999. All rights reserved.
- *
- * @author Alan Liu
- * @stable ICU 2.0
- */
-interface Replaceable {
- /**
- * Returns the number of 16-bit code units in the text.
- * @return number of 16-bit code units in text
- * @stable ICU 2.0
- */
- int length();
-
- /**
- * Returns the 16-bit code unit at the given offset into the text.
- * @param offset an integer between 0 and length()-1
- * inclusive
- * @return 16-bit code unit of text at given offset
- * @stable ICU 2.0
- */
- char charAt(int offset);
-
- /**
- * Copies characters from this object into the destination
- * character array. The first character to be copied is at index
- * srcStart; the last character to be copied is at
- * index srcLimit-1 (thus the total number of
- * characters to be copied is srcLimit-srcStart). The
- * characters are copied into the subarray of dst
- * starting at index dstStart and ending at index
- * dstStart + (srcLimit-srcStart) - 1.
- *
- * @param srcStart the beginning index to copy, inclusive;
- * {@code 0 <= start <= limit}.
- * @param srcLimit the ending index to copy, exclusive;
- * {@code start <= limit <= length()}.
- * @param dst the destination array.
- * @param dstStart the start offset in the destination array.
- * @stable ICU 2.0
- */
- void getChars(int srcStart, int srcLimit, char dst[], int dstStart);
-}
--- /dev/null 2020-01-10 13:50:39.000000000 -0800
+++ new/src/java.base/share/classes/jdk/internal/icu/text/Replaceable.java 2020-01-10 13:50:39.000000000 -0800
@@ -0,0 +1,121 @@
+/*
+ * Copyright (c) 2005, 2020, 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 jdk.internal.icu.text;
+
+/**
+ * Replaceable is an interface representing a
+ * string of characters that supports the replacement of a range of
+ * itself with a new string of characters. It is used by APIs that
+ * change a piece of text while retaining metadata. Metadata is data
+ * other than the Unicode characters returned by char32At(). One
+ * example of metadata is style attributes; another is an edit
+ * history, marking each character with an author and revision number.
+ *
+ *
An implicit aspect of the Replaceable API is that
+ * during a replace operation, new characters take on the metadata of
+ * the old characters. For example, if the string "the bold
+ * font" has range (4, 8) replaced with "strong", then it becomes "the
+ * strong font".
+ *
+ *
Replaceable specifies ranges using a start
+ * offset and a limit offset. The range of characters thus specified
+ * includes the characters at offset start..limit-1. That is, the
+ * start offset is inclusive, and the limit offset is exclusive.
+ *
+ *
Replaceable also includes API to access characters
+ * in the string: length(), charAt(),
+ * char32At(), and extractBetween().
+ *
+ *
For a subclass to support metadata, typical behavior of
+ * replace() is the following:
+ *
Copyright © IBM Corporation 1999. All rights reserved.
+ *
+ * @author Alan Liu
+ * @stable ICU 2.0
+ */
+public interface Replaceable {
+ /**
+ * Returns the number of 16-bit code units in the text.
+ * @return number of 16-bit code units in text
+ * @stable ICU 2.0
+ */
+ int length();
+
+ /**
+ * Returns the 16-bit code unit at the given offset into the text.
+ * @param offset an integer between 0 and length()-1
+ * inclusive
+ * @return 16-bit code unit of text at given offset
+ * @stable ICU 2.0
+ */
+ char charAt(int offset);
+
+ /**
+ * Copies characters from this object into the destination
+ * character array. The first character to be copied is at index
+ * srcStart; the last character to be copied is at
+ * index srcLimit-1 (thus the total number of
+ * characters to be copied is srcLimit-srcStart). The
+ * characters are copied into the subarray of dst
+ * starting at index dstStart and ending at index
+ * dstStart + (srcLimit-srcStart) - 1.
+ *
+ * @param srcStart the beginning index to copy, inclusive;
+ * {@code 0 <= start <= limit}.
+ * @param srcLimit the ending index to copy, exclusive;
+ * {@code start <= limit <= length()}.
+ * @param dst the destination array.
+ * @param dstStart the start offset in the destination array.
+ * @stable ICU 2.0
+ */
+ void getChars(int srcStart, int srcLimit, char dst[], int dstStart);
+}