changeset 54580:ea6826b20f20 intrinsics-project

more api changes
author vromero
date Wed, 30 Jan 2019 19:52:12 -0500
parents 7393d04a0b90
children 1920d753c07f
files src/java.base/share/classes/java/io/PrintStream.java src/java.base/share/classes/java/io/PrintWriter.java src/java.base/share/classes/java/lang/String.java
diffstat 3 files changed, 120 insertions(+), 24 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/io/PrintStream.java	Tue Jan 29 20:52:30 2019 -0500
+++ b/src/java.base/share/classes/java/io/PrintStream.java	Wed Jan 30 19:52:12 2019 -0500
@@ -1003,8 +1003,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  format
      *         A format string as described in <a
@@ -1056,8 +1064,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during
@@ -1112,8 +1128,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  format
      *         A format string as described in <a
@@ -1172,8 +1196,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during
--- a/src/java.base/share/classes/java/io/PrintWriter.java	Tue Jan 29 20:52:30 2019 -0500
+++ b/src/java.base/share/classes/java/io/PrintWriter.java	Wed Jan 30 19:52:12 2019 -0500
@@ -857,8 +857,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  format
      *         A format string as described in <a
@@ -911,8 +919,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during
@@ -967,8 +983,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  format
      *         A format string as described in <a
@@ -1028,8 +1052,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during
--- a/src/java.base/share/classes/java/lang/String.java	Tue Jan 29 20:52:30 2019 -0500
+++ b/src/java.base/share/classes/java/lang/String.java	Wed Jan 30 19:52:12 2019 -0500
@@ -2959,8 +2959,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  format
      *         A <a href="../util/Formatter.html#syntax">format string</a>
@@ -3001,8 +3009,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during
@@ -3054,8 +3070,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  args
      *         Arguments referenced by the format specifiers in the format
@@ -3095,8 +3119,16 @@
      *
      * @implNote
      * An invocation of this method may be intrinsified {@link java.lang.compiler.IntrinsicCandidate}
-     * if the {@code format} string is a constant expression. Note that the locale used depends on the
-     * default locale in effect <i>at compile time</i>.
+     * if the {@code format} string is a constant expression. Intrinsification replaces the method
+     * invocation with a string concatenation operation. No checks are made during intrinsification
+     * on the content of the {@code format} string, so an IllegalFormatException is possible at
+     * run time.
+     * <p>
+     * The treatment of subsequent arguments is the same as without intrinsification: arguments that
+     * are constant expressions are evaluated at compile time, and arguments that are not constant
+     * expressions are evaluated at run time. (An argument that is a nested invocation of an
+     * intrinsifiable method may be evaluated at compile time and/or run time, per the compiler's
+     * usual discretion on when and how to intrinsify.)
      *
      * @param  l
      *         The {@linkplain java.util.Locale locale} to apply during