# HG changeset patch # User jjg # Date 1493247955 25200 # Node ID b3f9f5bf40b2409ccee6a05b6eeb0df2f78720b3 # Parent 3b829f6434d8c72a35f67bc112b25caf179eeaa8 8179367: update use of align, valign attributes in java.base to use style attribute Reviewed-by: martin, mchung diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/io/RandomAccessFile.java --- a/jdk/src/java.base/share/classes/java/io/RandomAccessFile.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/io/RandomAccessFile.java Wed Apr 26 16:05:55 2017 -0700 @@ -137,19 +137,19 @@ * meanings are: * * - * - * + * + * * - * + * * - * + * * - * + * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/lang/Class.java --- a/jdk/src/java.base/share/classes/java/lang/Class.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/lang/Class.java Wed Apr 26 16:05:55 2017 -0700 @@ -726,16 +726,16 @@ * *
ValueMeaning
{@code "r"}
ValueMeaning
{@code "r"} Open for reading only. Invoking any of the {@code write} * methods of the resulting object will cause an * {@link java.io.IOException} to be thrown.
{@code "rw"}
{@code "rw"} Open for reading and writing. If the file does not already * exist then an attempt will be made to create it.
{@code "rws"}
{@code "rws"} Open for reading and writing, as with {@code "rw"}, and also * require that every update to the file's content or metadata be * written synchronously to the underlying storage device.
{@code "rwd"}
{@code "rwd"} Open for reading and writing, as with {@code "rw"}, and also * require that every update to the file's content be written * synchronously to the underlying storage device.
*
Element Type     Encoding - *
boolean     Z - *
byte     B - *
char     C + *
boolean     Z + *
byte     B + *
char     C *
class or interface - *     Lclassname; - *
double     D - *
float     F - *
int     I - *
long     J - *
short     S + *     Lclassname; + *
double     D + *
float     F + *
int     I + *
long     J + *
short     S *
* *

The class or interface name classname is the binary name of diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/lang/String.java --- a/jdk/src/java.base/share/classes/java/lang/String.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/lang/String.java Wed Apr 26 16:05:55 2017 -0700 @@ -2209,23 +2209,23 @@ * Limit * Result * - * : - * 2 + * : + * 2 * {@code { "boo", "and:foo" }} - * : - * 5 + * : + * 5 * {@code { "boo", "and", "foo" }} - * : - * -2 + * : + * -2 * {@code { "boo", "and", "foo" }} - * o - * 5 + * o + * 5 * {@code { "b", "", ":and:f", "", "" }} - * o - * -2 + * o + * -2 * {@code { "b", "", ":and:f", "", "" }} - * o - * 0 + * o + * 0 * {@code { "b", "", ":and:f" }} * * @@ -2331,9 +2331,9 @@ * Regex * Result * - * : + * : * {@code { "boo", "and", "foo" }} - * o + * o * {@code { "b", "", ":and:f" }} * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java --- a/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java Wed Apr 26 16:05:55 2017 -0700 @@ -109,22 +109,22 @@ * Overview of kind of presence detected by different AnnotatedElement methods * Kind of Presence * MethodDirectly PresentIndirectly PresentPresentAssociated - * {@code T}{@link #getAnnotation(Class) getAnnotation(Class<T>)} + * {@code T}{@link #getAnnotation(Class) getAnnotation(Class<T>)} * X * - * {@code Annotation[]}{@link #getAnnotations getAnnotations()} + * {@code Annotation[]}{@link #getAnnotations getAnnotations()} * X * - * {@code T[]}{@link #getAnnotationsByType(Class) getAnnotationsByType(Class<T>)} + * {@code T[]}{@link #getAnnotationsByType(Class) getAnnotationsByType(Class<T>)} * X * - * {@code T}{@link #getDeclaredAnnotation(Class) getDeclaredAnnotation(Class<T>)} + * {@code T}{@link #getDeclaredAnnotation(Class) getDeclaredAnnotation(Class<T>)} * X * - * {@code Annotation[]}{@link #getDeclaredAnnotations getDeclaredAnnotations()} + * {@code Annotation[]}{@link #getDeclaredAnnotations getDeclaredAnnotations()} * X * - * {@code T[]}{@link #getDeclaredAnnotationsByType(Class) getDeclaredAnnotationsByType(Class<T>)} + * {@code T[]}{@link #getDeclaredAnnotationsByType(Class) getDeclaredAnnotationsByType(Class<T>)} * XX * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/math/RoundingMode.java --- a/jdk/src/java.base/share/classes/java/math/RoundingMode.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/math/RoundingMode.java Wed Apr 26 16:05:55 2017 -0700 @@ -55,7 +55,7 @@ * Summary of Rounding Operations Under Different Rounding Modes * Result of rounding input to one digit with the given * rounding mode - * + * * Input Number {@code UP} * {@code DOWN} * {@code CEILING} @@ -65,16 +65,16 @@ * {@code HALF_EVEN} * {@code UNNECESSARY} * - * 5.5 6 5 6 5 6 5 6 throw {@code ArithmeticException} - * 2.5 3 2 3 2 3 2 2 throw {@code ArithmeticException} - * 1.6 2 1 2 1 2 2 2 throw {@code ArithmeticException} - * 1.1 2 1 2 1 1 1 1 throw {@code ArithmeticException} - * 1.0 1 1 1 1 1 1 1 1 - * -1.0 -1 -1 -1 -1 -1 -1 -1 -1 - * -1.1 -2 -1 -1 -2 -1 -1 -1 throw {@code ArithmeticException} - * -1.6 -2 -1 -1 -2 -2 -2 -2 throw {@code ArithmeticException} - * -2.5 -3 -2 -2 -3 -3 -2 -2 throw {@code ArithmeticException} - * -5.5 -6 -5 -5 -6 -6 -5 -6 throw {@code ArithmeticException} + * 5.5 6 5 6 5 6 5 6 throw {@code ArithmeticException} + * 2.5 3 2 3 2 3 2 2 throw {@code ArithmeticException} + * 1.6 2 1 2 1 2 2 2 throw {@code ArithmeticException} + * 1.1 2 1 2 1 1 1 1 throw {@code ArithmeticException} + * 1.0 1 1 1 1 1 1 1 1 + * -1.0 -1 -1 -1 -1 -1 -1 -1 -1 + * -1.1 -2 -1 -1 -2 -1 -1 -1 throw {@code ArithmeticException} + * -1.6 -2 -1 -1 -2 -2 -2 -2 throw {@code ArithmeticException} + * -2.5 -3 -2 -2 -3 -3 -2 -2 throw {@code ArithmeticException} + * -5.5 -6 -5 -5 -6 -6 -5 -6 throw {@code ArithmeticException} * * * @@ -102,18 +102,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode UP Examples
Input Number
Input NumberInput rounded to one digit
with {@code UP} rounding - *
5.5 6
2.5 3
1.6 2
1.1 2
1.0 1
-1.0 -1
-1.1 -2
-1.6 -2
-2.5 -3
-5.5 -6
5.5 6
2.5 3
1.6 2
1.1 2
1.0 1
-1.0 -1
-1.1 -2
-1.6 -2
-2.5 -3
-5.5 -6
*/ UP(BigDecimal.ROUND_UP), @@ -126,18 +126,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode DOWN Examples
Input Number
Input NumberInput rounded to one digit
with {@code DOWN} rounding - *
5.5 5
2.5 2
1.6 1
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -1
-2.5 -2
-5.5 -5
5.5 5
2.5 2
1.6 1
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -1
-2.5 -2
-5.5 -5
*/ DOWN(BigDecimal.ROUND_DOWN), @@ -151,18 +151,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode CEILING Examples
Input Number
Input NumberInput rounded to one digit
with {@code CEILING} rounding - *
5.5 6
2.5 3
1.6 2
1.1 2
1.0 1
-1.0 -1
-1.1 -1
-1.6 -1
-2.5 -2
-5.5 -5
5.5 6
2.5 3
1.6 2
1.1 2
1.0 1
-1.0 -1
-1.1 -1
-1.6 -1
-2.5 -2
-5.5 -5
*/ CEILING(BigDecimal.ROUND_CEILING), @@ -176,18 +176,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode FLOOR Examples
Input Number
Input NumberInput rounded to one digit
with {@code FLOOR} rounding - *
5.5 5
2.5 2
1.6 1
1.1 1
1.0 1
-1.0 -1
-1.1 -2
-1.6 -2
-2.5 -3
-5.5 -6
5.5 5
2.5 2
1.6 1
1.1 1
1.0 1
-1.0 -1
-1.1 -2
-1.6 -2
-2.5 -3
-5.5 -6
*/ FLOOR(BigDecimal.ROUND_FLOOR), @@ -203,18 +203,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode HALF_UP Examples
Input Number
Input NumberInput rounded to one digit
with {@code HALF_UP} rounding - *
5.5 6
2.5 3
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -3
-5.5 -6
5.5 6
2.5 3
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -3
-5.5 -6
*/ HALF_UP(BigDecimal.ROUND_HALF_UP), @@ -229,18 +229,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode HALF_DOWN Examples
Input Number
Input NumberInput rounded to one digit
with {@code HALF_DOWN} rounding - *
5.5 5
2.5 2
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -2
-5.5 -5
5.5 5
2.5 2
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -2
-5.5 -5
*/ HALF_DOWN(BigDecimal.ROUND_HALF_DOWN), @@ -262,18 +262,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode HALF_EVEN Examples
Input Number
Input NumberInput rounded to one digit
with {@code HALF_EVEN} rounding - *
5.5 6
2.5 2
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -2
-5.5 -6
5.5 6
2.5 2
1.6 2
1.1 1
1.0 1
-1.0 -1
-1.1 -1
-1.6 -2
-2.5 -2
-5.5 -6
*/ HALF_EVEN(BigDecimal.ROUND_HALF_EVEN), @@ -286,18 +286,18 @@ *

Example: * * - * + * * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * *
Rounding mode UNNECESSARY Examples
Input Number
Input NumberInput rounded to one digit
with {@code UNNECESSARY} rounding - *
5.5 throw {@code ArithmeticException}
2.5 throw {@code ArithmeticException}
1.6 throw {@code ArithmeticException}
1.1 throw {@code ArithmeticException}
1.0 1
-1.0 -1
-1.1 throw {@code ArithmeticException}
-1.6 throw {@code ArithmeticException}
-2.5 throw {@code ArithmeticException}
-5.5 throw {@code ArithmeticException}
5.5 throw {@code ArithmeticException}
2.5 throw {@code ArithmeticException}
1.6 throw {@code ArithmeticException}
1.1 throw {@code ArithmeticException}
1.0 1
-1.0 -1
-1.1 throw {@code ArithmeticException}
-1.6 throw {@code ArithmeticException}
-2.5 throw {@code ArithmeticException}
-5.5 throw {@code ArithmeticException}
*/ UNNECESSARY(BigDecimal.ROUND_UNNECESSARY); diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/nio/charset/Charset.java --- a/jdk/src/java.base/share/classes/java/nio/charset/Charset.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/charset/Charset.java Wed Apr 26 16:05:55 2017 -0700 @@ -148,21 +148,21 @@ * of such optional charsets may differ between implementations. * *

- * - * + * + * * - * + * * - * + * * - * + * * - * + * * - * + * * *
CharsetDescription
{@code US-ASCII}
CharsetDescription
{@code US-ASCII}Seven-bit ASCII, a.k.a. {@code ISO646-US}, * a.k.a. the Basic Latin block of the Unicode character set
ISO-8859-1  
ISO-8859-1  ISO Latin Alphabet No. 1, a.k.a. {@code ISO-LATIN-1}
{@code UTF-8}
{@code UTF-8}Eight-bit UCS Transformation Format
{@code UTF-16BE}
{@code UTF-16BE}Sixteen-bit UCS Transformation Format, * big-endian byte order
{@code UTF-16LE}
{@code UTF-16LE}Sixteen-bit UCS Transformation Format, * little-endian byte order
{@code UTF-16}
{@code UTF-16}Sixteen-bit UCS Transformation Format, * byte order identified by an optional byte-order mark
diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/text/DecimalFormat.java --- a/jdk/src/java.base/share/classes/java/text/DecimalFormat.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/text/DecimalFormat.java Wed Apr 26 16:05:55 2017 -0700 @@ -175,11 +175,11 @@ * * - * + * * + * * + * * + * * + * * + * *
Symbol - * Location - * Localized? - * Meaning - *
Symbol + * Location + * Localized? + * Meaning + *
0 * Number * Yes @@ -189,7 +189,7 @@ * Number * Yes * Digit, zero shows as absent - *
. * Number * Yes @@ -199,7 +199,7 @@ * Number * Yes * Minus sign - *
, * Number * Yes @@ -210,7 +210,7 @@ * Yes * Separates mantissa and exponent in scientific notation. * Need not be quoted in prefix or suffix. - *
; * Subpattern boundary * Yes @@ -220,7 +220,7 @@ * Prefix or suffix * Yes * Multiply by 100 and show as percentage - *
\u2030 * Prefix or suffix * Yes @@ -233,7 +233,7 @@ * doubled, replaced by international currency symbol. * If present in a pattern, the monetary decimal separator * is used instead of the decimal separator. - *
' * Prefix or suffix * No diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/text/SimpleDateFormat.java --- a/jdk/src/java.base/share/classes/java/text/SimpleDateFormat.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/text/SimpleDateFormat.java Wed Apr 26 16:05:55 2017 -0700 @@ -94,10 +94,10 @@ *
* * - * *
Letter - * Date or Time Component - * Presentation - * Examples + * Letter + * Date or Time Component + * Presentation + * Examples *
G * Era designator @@ -372,8 +372,8 @@ *
* * - * *
Date and Time Pattern - * Result + * Date and Time Pattern + * Result *
"yyyy.MM.dd G 'at' HH:mm:ss z" * 2001.07.04 AD at 12:08:56 PDT diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/time/chrono/HijrahChronology.java --- a/jdk/src/java.base/share/classes/java/time/chrono/HijrahChronology.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/time/chrono/HijrahChronology.java Wed Apr 26 16:05:55 2017 -0700 @@ -106,10 +106,10 @@ * * * - * - * - * - * + * + * + * + * * * * @@ -150,9 +150,9 @@ *
Chronology IDCalendar TypeLocale extension, see {@link java.util.Locale}DescriptionChronology IDCalendar TypeLocale extension, see {@link java.util.Locale}Description
* * - * - * - * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/time/chrono/IsoEra.java --- a/jdk/src/java.base/share/classes/java/time/chrono/IsoEra.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/time/chrono/IsoEra.java Wed Apr 26 16:05:55 2017 -0700 @@ -73,9 +73,9 @@ *
Property Name Property value Description Property Name Property value Description
* * - * - * - * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/time/chrono/MinguoEra.java --- a/jdk/src/java.base/share/classes/java/time/chrono/MinguoEra.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/time/chrono/MinguoEra.java Wed Apr 26 16:05:55 2017 -0700 @@ -74,10 +74,10 @@ *
year-of-eraeraproleptic-yearyear-of-eraeraproleptic-year
* * - * - * - * - * + * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/time/chrono/ThaiBuddhistEra.java --- a/jdk/src/java.base/share/classes/java/time/chrono/ThaiBuddhistEra.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/time/chrono/ThaiBuddhistEra.java Wed Apr 26 16:05:55 2017 -0700 @@ -74,10 +74,10 @@ *
year-of-eraeraproleptic-yearISO proleptic-yearyear-of-eraeraproleptic-yearISO proleptic-year
* * - * - * - * - * + * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/time/format/DateTimeFormatter.java --- a/jdk/src/java.base/share/classes/java/time/format/DateTimeFormatter.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/time/format/DateTimeFormatter.java Wed Apr 26 16:05:55 2017 -0700 @@ -153,9 +153,9 @@ *
year-of-eraeraproleptic-yearISO proleptic-yearyear-of-eraeraproleptic-yearISO proleptic-year
* * - * - * - * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/Deque.java --- a/jdk/src/java.base/share/classes/java/util/Deque.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/Deque.java Wed Apr 26 16:05:55 2017 -0700 @@ -60,15 +60,15 @@ * * * - * - * + * + * * * * - * - * - * - * + * + * + * + * * * * @@ -102,8 +102,8 @@ *
FormatterDescriptionExampleFormatterDescriptionExample
Summary of Deque methods
First Element (Head) Last Element (Tail) First Element (Head) Last Element (Tail)
Throws exceptionSpecial valueThrows exceptionSpecial valueThrows exceptionSpecial valueThrows exceptionSpecial value
Insert
* * - * - * + * + * * * * @@ -140,8 +140,8 @@ *
Comparison of Queue and Deque methods
{@code Queue} Method Equivalent {@code Deque} Method {@code Queue} Method Equivalent {@code Deque} Method
{@link java.util.Queue#add add(e)}
* * - * - * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/Formatter.java --- a/jdk/src/java.base/share/classes/java/util/Formatter.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/Formatter.java Wed Apr 26 16:05:55 2017 -0700 @@ -292,77 +292,77 @@ * *
Comparison of Stack and Deque methods
Stack Method Equivalent {@code Deque} Method Stack Method Equivalent {@code Deque} Method
{@link #push push(e)}
* - *
Conversion - * Argument Category - * Description - * - *
{@code 'b'}, {@code 'B'} - * general + *
Conversion + * Argument Category + * Description + * + *
{@code 'b'}, {@code 'B'} + * general * If the argument arg is {@code null}, then the result is * "{@code false}". If arg is a {@code boolean} or {@link * Boolean}, then the result is the string returned by {@link * String#valueOf(boolean) String.valueOf(arg)}. Otherwise, the result is * "true". * - *
{@code 'h'}, {@code 'H'} - * general + *
{@code 'h'}, {@code 'H'} + * general * The result is obtained by invoking * {@code Integer.toHexString(arg.hashCode())}. * - *
{@code 's'}, {@code 'S'} - * general + *
{@code 's'}, {@code 'S'} + * general * If arg implements {@link Formattable}, then * {@link Formattable#formatTo arg.formatTo} is invoked. Otherwise, the * result is obtained by invoking {@code arg.toString()}. * - *
{@code 'c'}, {@code 'C'} - * character + *
{@code 'c'}, {@code 'C'} + * character * The result is a Unicode character * - *
{@code 'd'} - * integral + *
{@code 'd'} + * integral * The result is formatted as a decimal integer * - *
{@code 'o'} - * integral + *
{@code 'o'} + * integral * The result is formatted as an octal integer * - *
{@code 'x'}, {@code 'X'} - * integral + *
{@code 'x'}, {@code 'X'} + * integral * The result is formatted as a hexadecimal integer * - *
{@code 'e'}, {@code 'E'} - * floating point + *
{@code 'e'}, {@code 'E'} + * floating point * The result is formatted as a decimal number in computerized * scientific notation * - *
{@code 'f'} - * floating point + *
{@code 'f'} + * floating point * The result is formatted as a decimal number * - *
{@code 'g'}, {@code 'G'} - * floating point + *
{@code 'g'}, {@code 'G'} + * floating point * The result is formatted using computerized scientific notation or * decimal format, depending on the precision and the value after rounding. * - *
{@code 'a'}, {@code 'A'} - * floating point + *
{@code 'a'}, {@code 'A'} + * floating point * The result is formatted as a hexadecimal floating-point number with * a significand and an exponent. This conversion is not supported * for the {@code BigDecimal} type despite the latter's being in the * floating point argument category. * - *
{@code 't'}, {@code 'T'} - * date/time + *
{@code 't'}, {@code 'T'} + * date/time * Prefix for date and time conversion characters. See Date/Time Conversions. * - *
{@code '%'} - * percent + *
{@code '%'} + * percent * The result is a literal {@code '%'} ('\u0025') * - *
{@code 'n'} - * line separator + *
{@code 'n'} + * line separator * The result is the platform-specific line separator * *
@@ -383,44 +383,44 @@ * * * - *
{@code 'H'} + *
{@code 'H'} * Hour of the day for the 24-hour clock, formatted as two digits with * a leading zero as necessary i.e. {@code 00 - 23}. * - *
{@code 'I'} + *
{@code 'I'} * Hour for the 12-hour clock, formatted as two digits with a leading * zero as necessary, i.e. {@code 01 - 12}. * - *
{@code 'k'} + *
{@code 'k'} * Hour of the day for the 24-hour clock, i.e. {@code 0 - 23}. * - *
{@code 'l'} + *
{@code 'l'} * Hour for the 12-hour clock, i.e. {@code 1 - 12}. * - *
{@code 'M'} + *
{@code 'M'} * Minute within the hour formatted as two digits with a leading zero * as necessary, i.e. {@code 00 - 59}. * - *
{@code 'S'} + *
{@code 'S'} * Seconds within the minute, formatted as two digits with a leading * zero as necessary, i.e. {@code 00 - 60} ("{@code 60}" is a special * value required to support leap seconds). * - *
{@code 'L'} + *
{@code 'L'} * Millisecond within the second formatted as three digits with * leading zeros as necessary, i.e. {@code 000 - 999}. * - *
{@code 'N'} + *
{@code 'N'} * Nanosecond within the second, formatted as nine digits with leading * zeros as necessary, i.e. {@code 000000000 - 999999999}. * - *
{@code 'p'} + *
{@code 'p'} * Locale-specific {@linkplain * java.text.DateFormatSymbols#getAmPmStrings morning or afternoon} marker * in lower case, e.g."{@code am}" or "{@code pm}". Use of the conversion * prefix {@code 'T'} forces this output to upper case. * - *
{@code 'z'} + *
{@code 'z'} * RFC 822 * style numeric time zone offset from GMT, e.g. {@code -0800}. This * value will be adjusted as necessary for Daylight Saving Time. For @@ -428,7 +428,7 @@ * the {@linkplain TimeZone#getDefault() default time zone} for this * instance of the Java virtual machine. * - *
{@code 'Z'} + *
{@code 'Z'} * A string representing the abbreviation for the time zone. This * value will be adjusted as necessary for Daylight Saving Time. For * {@code long}, {@link Long}, and {@link Date} the time zone used is @@ -436,12 +436,12 @@ * instance of the Java virtual machine. The Formatter's locale will * supersede the locale of the argument (if any). * - *
{@code 's'} + *
{@code 's'} * Seconds since the beginning of the epoch starting at 1 January 1970 * {@code 00:00:00} UTC, i.e. {@code Long.MIN_VALUE/1000} to * {@code Long.MAX_VALUE/1000}. * - *
{@code 'Q'} + *
{@code 'Q'} * Milliseconds since the beginning of the epoch starting at 1 January * 1970 {@code 00:00:00} UTC, i.e. {@code Long.MIN_VALUE} to * {@code Long.MAX_VALUE}. @@ -452,54 +452,54 @@ * * * - *
{@code 'B'} + *
{@code 'B'} * Locale-specific {@linkplain java.text.DateFormatSymbols#getMonths * full month name}, e.g. {@code "January"}, {@code "February"}. * - *
{@code 'b'} + *
{@code 'b'} * Locale-specific {@linkplain * java.text.DateFormatSymbols#getShortMonths abbreviated month name}, * e.g. {@code "Jan"}, {@code "Feb"}. * - *
{@code 'h'} + *
{@code 'h'} * Same as {@code 'b'}. * - *
{@code 'A'} + *
{@code 'A'} * Locale-specific full name of the {@linkplain * java.text.DateFormatSymbols#getWeekdays day of the week}, * e.g. {@code "Sunday"}, {@code "Monday"} * - *
{@code 'a'} + *
{@code 'a'} * Locale-specific short name of the {@linkplain * java.text.DateFormatSymbols#getShortWeekdays day of the week}, * e.g. {@code "Sun"}, {@code "Mon"} * - *
{@code 'C'} + *
{@code 'C'} * Four-digit year divided by {@code 100}, formatted as two digits * with leading zero as necessary, i.e. {@code 00 - 99} * - *
{@code 'Y'} + *
{@code 'Y'} * Year, formatted as at least four digits with leading zeros as * necessary, e.g. {@code 0092} equals {@code 92} CE for the Gregorian * calendar. * - *
{@code 'y'} + *
{@code 'y'} * Last two digits of the year, formatted with leading zeros as * necessary, i.e. {@code 00 - 99}. * - *
{@code 'j'} + *
{@code 'j'} * Day of year, formatted as three digits with leading zeros as * necessary, e.g. {@code 001 - 366} for the Gregorian calendar. * - *
{@code 'm'} + *
{@code 'm'} * Month, formatted as two digits with leading zeros as necessary, * i.e. {@code 01 - 13}. * - *
{@code 'd'} + *
{@code 'd'} * Day of month, formatted as two digits with leading zeros as * necessary, i.e. {@code 01 - 31} * - *
{@code 'e'} + *
{@code 'e'} * Day of month, formatted as two digits, i.e. {@code 1 - 31}. * *
@@ -509,25 +509,25 @@ * * * - *
{@code 'R'} + *
{@code 'R'} * Time formatted for the 24-hour clock as {@code "%tH:%tM"} * - *
{@code 'T'} + *
{@code 'T'} * Time formatted for the 24-hour clock as {@code "%tH:%tM:%tS"}. * - *
{@code 'r'} + *
{@code 'r'} * Time formatted for the 12-hour clock as {@code "%tI:%tM:%tS %Tp"}. * The location of the morning or afternoon marker ({@code '%Tp'}) may be * locale-dependent. * - *
{@code 'D'} + *
{@code 'D'} * Date formatted as {@code "%tm/%td/%ty"}. * - *
{@code 'F'} + *
{@code 'F'} * ISO 8601 * complete date formatted as {@code "%tY-%tm-%td"}. * - *
{@code 'c'} + *
{@code 'c'} * Date and time formatted as {@code "%ta %tb %td %tT %tZ %tY"}, * e.g. {@code "Sun Jul 20 16:17:00 EDT 1969"}. * @@ -543,60 +543,60 @@ * * * - *
Flag General - * Character Integral - * Floating Point - * Date/Time - * Description - * - *
'-' y - * y - * y - * y - * y + *
Flag General + * Character Integral + * Floating Point + * Date/Time + * Description + * + *
'-' y + * y + * y + * y + * y * The result will be left-justified. * - *
'#' y1 - * - - * y3 - * y - * - + *
'#' y1 + * - + * y3 + * y + * - * The result should use a conversion-dependent alternate form * - *
'+' - - * - - * y4 - * y - * - + *
'+' - + * - + * y4 + * y + * - * The result will always include a sign * - *
'  ' - - * - - * y4 - * y - * - + *
'  ' - + * - + * y4 + * y + * - * The result will include a leading space for positive values * - *
'0' - - * - - * y - * y - * - + *
'0' - + * - + * y + * y + * - * The result will be zero-padded * - *
',' - - * - - * y2 - * y5 - * - + *
',' - + * - + * y2 + * y5 + * - * The result will include locale-specific {@linkplain * java.text.DecimalFormatSymbols#getGroupingSeparator grouping separators} * - *
'(' - - * - - * y4 - * y5 - * - + *
'(' - + * - + * y4 + * y5 + * - * The result will enclose negative numbers in parentheses * *
@@ -707,8 +707,8 @@ * * * - *
{@code 'b'} - * '\u0062' + *
{@code 'b'} + * '\u0062' * Produces either "{@code true}" or "{@code false}" as returned by * {@link Boolean#toString(boolean)}. * @@ -721,12 +721,12 @@ *

If the {@code '#'} flag is given, then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'B'} - * '\u0042' + *
{@code 'B'} + * '\u0042' * The upper-case variant of {@code 'b'}. * - *
{@code 'h'} - * '\u0068' + *
{@code 'h'} + * '\u0068' * Produces a string representing the hash code value of the object. * *

The result is obtained by invoking @@ -735,12 +735,12 @@ *

If the {@code '#'} flag is given, then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'H'} - * '\u0048' + *
{@code 'H'} + * '\u0048' * The upper-case variant of {@code 'h'}. * - *
{@code 's'} - * '\u0073' + *
{@code 's'} + * '\u0073' * Produces a string. * *

If the argument implements {@link Formattable}, then @@ -752,8 +752,8 @@ * Formattable} , then a {@link FormatFlagsConversionMismatchException} * will be thrown. * - *

{@code 'S'} - * '\u0053' + *
{@code 'S'} + * '\u0053' * The upper-case variant of {@code 's'}. * *
@@ -762,16 +762,16 @@ * * * - *
{@code '-'} - * '\u002d' + *
{@code '-'} + * '\u002d' * Left justifies the output. Spaces ('\u0020') will be * added at the end of the converted value as required to fill the minimum * width of the field. If the width is not provided, then a {@link * MissingFormatWidthException} will be thrown. If this flag is not given * then the output will be right-justified. * - *
{@code '#'} - * '\u0023' + *
{@code '#'} + * '\u0023' * Requires the output use an alternate form. The definition of the * form is specified by the conversion. * @@ -803,8 +803,8 @@ * * * - *
{@code 'c'} - * '\u0063' + *
{@code 'c'} + * '\u0063' * Formats the argument as a Unicode character as described in Unicode Character * Representation. This may be more than one 16-bit {@code char} in @@ -813,8 +813,8 @@ *

If the {@code '#'} flag is given, then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'C'} - * '\u0043' + *
{@code 'C'} + * '\u0043' * The upper-case variant of {@code 'c'}. * *
@@ -904,8 +904,8 @@ * * * - *
{@code 'd'} - * '\u0064' + *
{@code 'd'} + * '\u0064' * Formats the argument as a decimal integer. The localization algorithm is applied. * @@ -915,8 +915,8 @@ *

If the {@code '#'} flag is given then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'o'} - * '\u006f' + *
{@code 'o'} + * '\u006f' * Formats the argument as an integer in base eight. No localization * is applied. * @@ -937,8 +937,8 @@ * are given then a {@link FormatFlagsConversionMismatchException} will be * thrown. * - *
{@code 'x'} - * '\u0078' + *
{@code 'x'} + * '\u0078' * Formats the argument as an integer in base sixteen. No * localization is applied. * @@ -960,8 +960,8 @@ * {@code ','} flags are given then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *
{@code 'X'} - * '\u0058' + *
{@code 'X'} + * '\u0058' * The upper-case variant of {@code 'x'}. The entire string * representing the number will be converted to {@linkplain * String#toUpperCase upper case} including the {@code 'x'} (if any) and @@ -984,8 +984,8 @@ * * * - *
{@code '+'} - * '\u002b' + *
{@code '+'} + * '\u002b' * Requires the output to include a positive sign for all positive * numbers. If this flag is not given then only negative values will * include a sign. @@ -993,16 +993,16 @@ *

If both the {@code '+'} and '  ' flags are given * then an {@link IllegalFormatFlagsException} will be thrown. * - *

'  ' - * '\u0020' + *
'  ' + * '\u0020' * Requires the output to include a single extra space * ('\u0020') for non-negative values. * *

If both the {@code '+'} and '  ' flags are given * then an {@link IllegalFormatFlagsException} will be thrown. * - *

{@code '0'} - * '\u0030' + *
{@code '0'} + * '\u0030' * Requires the output to be padded with leading {@linkplain * java.text.DecimalFormatSymbols#getZeroDigit zeros} to the minimum field * width following any sign or radix indicator except when converting NaN @@ -1012,15 +1012,15 @@ *

If both the {@code '-'} and {@code '0'} flags are given then an * {@link IllegalFormatFlagsException} will be thrown. * - *

{@code ','} - * '\u002c' + *
{@code ','} + * '\u002c' * Requires the output to include the locale-specific {@linkplain * java.text.DecimalFormatSymbols#getGroupingSeparator group separators} as * described in the "group" section of the * localization algorithm. * - *
{@code '('} - * '\u0028' + *
{@code '('} + * '\u0028' * Requires the output to prepend a {@code '('} * ('\u0028') and append a {@code ')'} * ('\u0029') to negative values. @@ -1062,16 +1062,16 @@ * * * - *
{@code 'd'} - * '\u0064' + *
{@code 'd'} + * '\u0064' * Requires the output to be formatted as a decimal integer. The localization algorithm is applied. * *

If the {@code '#'} flag is given {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'o'} - * '\u006f' + *
{@code 'o'} + * '\u006f' * Requires the output to be formatted as an integer in base eight. * No localization is applied. * @@ -1093,8 +1093,8 @@ *

If the {@code ','} flag is given then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'x'} - * '\u0078' + *
{@code 'x'} + * '\u0078' * Requires the output to be formatted as an integer in base * sixteen. No localization is applied. * @@ -1117,8 +1117,8 @@ *

If the {@code ','} flag is given then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'X'} - * '\u0058' + *
{@code 'X'} + * '\u0058' * The upper-case variant of {@code 'x'}. The entire string * representing the number will be converted to {@linkplain * String#toUpperCase upper case} including the {@code 'x'} (if any) and @@ -1156,8 +1156,8 @@ * * * - *
{@code 'e'} - * '\u0065' + *
{@code 'e'} + * '\u0065' * Requires the output to be formatted using computerized scientific notation. The localization algorithm is applied. @@ -1204,13 +1204,13 @@ *

If the {@code ','} flag is given, then an {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'E'} - * '\u0045' + *
{@code 'E'} + * '\u0045' * The upper-case variant of {@code 'e'}. The exponent symbol * will be {@code 'E'} ('\u0045'). * - *
{@code 'g'} - * '\u0067' + *
{@code 'g'} + * '\u0067' * Requires the output to be formatted in general scientific notation * as described below. The localization * algorithm is applied. @@ -1234,12 +1234,12 @@ *

If the {@code '#'} flag is given then an {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'G'} - * '\u0047' + *
{@code 'G'} + * '\u0047' * The upper-case variant of {@code 'g'}. * - *
{@code 'f'} - * '\u0066' + *
{@code 'f'} + * '\u0066' * Requires the output to be formatted using decimal * format. The localization algorithm is * applied. @@ -1270,8 +1270,8 @@ * Float#toString(float)} or {@link Double#toString(double)} as * appropriate. * - *
{@code 'a'} - * '\u0061' + *
{@code 'a'} + * '\u0061' * Requires the output to be formatted in hexadecimal exponential * form. No localization is applied. * @@ -1323,8 +1323,8 @@ *

If the {@code '('} or {@code ','} flags are given, then a {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'A'} - * '\u0041' + *
{@code 'A'} + * '\u0041' * The upper-case variant of {@code 'a'}. The entire string * representing the number will be converted to upper case including the * {@code 'x'} ('\u0078') and {@code 'p'} @@ -1390,8 +1390,8 @@ * * * - *
{@code 'e'} - * '\u0065' + *
{@code 'e'} + * '\u0065' * Requires the output to be formatted using computerized scientific notation. The localization algorithm is applied. @@ -1432,13 +1432,13 @@ *

If the {@code ','} flag is given, then an {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'E'} - * '\u0045' + *
{@code 'E'} + * '\u0045' * The upper-case variant of {@code 'e'}. The exponent symbol * will be {@code 'E'} ('\u0045'). * - *
{@code 'g'} - * '\u0067' + *
{@code 'g'} + * '\u0067' * Requires the output to be formatted in general scientific notation * as described below. The localization * algorithm is applied. @@ -1462,12 +1462,12 @@ *

If the {@code '#'} flag is given then an {@link * FormatFlagsConversionMismatchException} will be thrown. * - *

{@code 'G'} - * '\u0047' + *
{@code 'G'} + * '\u0047' * The upper-case variant of {@code 'g'}. * - *
{@code 'f'} - * '\u0066' + *
{@code 'f'} + * '\u0066' * Requires the output to be formatted using decimal * format. The localization algorithm is * applied. @@ -1514,11 +1514,11 @@ * * * - *
{@code 't'} - * '\u0074' + *
{@code 't'} + * '\u0074' * Prefix for date and time conversion characters. - *
{@code 'T'} - * '\u0054' + *
{@code 'T'} + * '\u0054' * The upper-case variant of {@code 't'}. * *
@@ -1534,53 +1534,53 @@ * * * - *
{@code 'H'} - * '\u0048' + *
{@code 'H'} + * '\u0048' * Hour of the day for the 24-hour clock, formatted as two digits with * a leading zero as necessary i.e. {@code 00 - 23}. {@code 00} * corresponds to midnight. * - *
{@code 'I'} - * '\u0049' + *
{@code 'I'} + * '\u0049' * Hour for the 12-hour clock, formatted as two digits with a leading * zero as necessary, i.e. {@code 01 - 12}. {@code 01} corresponds to * one o'clock (either morning or afternoon). * - *
{@code 'k'} - * '\u006b' + *
{@code 'k'} + * '\u006b' * Hour of the day for the 24-hour clock, i.e. {@code 0 - 23}. * {@code 0} corresponds to midnight. * - *
{@code 'l'} - * '\u006c' + *
{@code 'l'} + * '\u006c' * Hour for the 12-hour clock, i.e. {@code 1 - 12}. {@code 1} * corresponds to one o'clock (either morning or afternoon). * - *
{@code 'M'} - * '\u004d' + *
{@code 'M'} + * '\u004d' * Minute within the hour formatted as two digits with a leading zero * as necessary, i.e. {@code 00 - 59}. * - *
{@code 'S'} - * '\u0053' + *
{@code 'S'} + * '\u0053' * Seconds within the minute, formatted as two digits with a leading * zero as necessary, i.e. {@code 00 - 60} ("{@code 60}" is a special * value required to support leap seconds). * - *
{@code 'L'} - * '\u004c' + *
{@code 'L'} + * '\u004c' * Millisecond within the second formatted as three digits with * leading zeros as necessary, i.e. {@code 000 - 999}. * - *
{@code 'N'} - * '\u004e' + *
{@code 'N'} + * '\u004e' * Nanosecond within the second, formatted as nine digits with leading * zeros as necessary, i.e. {@code 000000000 - 999999999}. The precision * of this value is limited by the resolution of the underlying operating * system or hardware. * - *
{@code 'p'} - * '\u0070' + *
{@code 'p'} + * '\u0070' * Locale-specific {@linkplain * java.text.DateFormatSymbols#getAmPmStrings morning or afternoon} marker * in lower case, e.g."{@code am}" or "{@code pm}". Use of the @@ -1589,8 +1589,8 @@ * GNU {@code date} and POSIX {@code strftime(3c)} which produce * upper-case output.) * - *
{@code 'z'} - * '\u007a' + *
{@code 'z'} + * '\u007a' * RFC 822 * style numeric time zone offset from GMT, e.g. {@code -0800}. This * value will be adjusted as necessary for Daylight Saving Time. For @@ -1598,8 +1598,8 @@ * the {@linkplain TimeZone#getDefault() default time zone} for this * instance of the Java virtual machine. * - *
{@code 'Z'} - * '\u005a' + *
{@code 'Z'} + * '\u005a' * A string representing the abbreviation for the time zone. This * value will be adjusted as necessary for Daylight Saving Time. For * {@code long}, {@link Long}, and {@link Date} the time zone used is @@ -1607,14 +1607,14 @@ * instance of the Java virtual machine. The Formatter's locale will * supersede the locale of the argument (if any). * - *
{@code 's'} - * '\u0073' + *
{@code 's'} + * '\u0073' * Seconds since the beginning of the epoch starting at 1 January 1970 * {@code 00:00:00} UTC, i.e. {@code Long.MIN_VALUE/1000} to * {@code Long.MAX_VALUE/1000}. * - *
{@code 'Q'} - * '\u004f' + *
{@code 'Q'} + * '\u004f' * Milliseconds since the beginning of the epoch starting at 1 January * 1970 {@code 00:00:00} UTC, i.e. {@code Long.MIN_VALUE} to * {@code Long.MAX_VALUE}. The precision of this value is limited by @@ -1626,69 +1626,69 @@ * * * - *
{@code 'B'} - * '\u0042' + *
{@code 'B'} + * '\u0042' * Locale-specific {@linkplain java.text.DateFormatSymbols#getMonths * full month name}, e.g. {@code "January"}, {@code "February"}. * - *
{@code 'b'} - * '\u0062' + *
{@code 'b'} + * '\u0062' * Locale-specific {@linkplain * java.text.DateFormatSymbols#getShortMonths abbreviated month name}, * e.g. {@code "Jan"}, {@code "Feb"}. * - *
{@code 'h'} - * '\u0068' + *
{@code 'h'} + * '\u0068' * Same as {@code 'b'}. * - *
{@code 'A'} - * '\u0041' + *
{@code 'A'} + * '\u0041' * Locale-specific full name of the {@linkplain * java.text.DateFormatSymbols#getWeekdays day of the week}, * e.g. {@code "Sunday"}, {@code "Monday"} * - *
{@code 'a'} - * '\u0061' + *
{@code 'a'} + * '\u0061' * Locale-specific short name of the {@linkplain * java.text.DateFormatSymbols#getShortWeekdays day of the week}, * e.g. {@code "Sun"}, {@code "Mon"} * - *
{@code 'C'} - * '\u0043' + *
{@code 'C'} + * '\u0043' * Four-digit year divided by {@code 100}, formatted as two digits * with leading zero as necessary, i.e. {@code 00 - 99} * - *
{@code 'Y'} - * '\u0059' Year, formatted to at least + *
{@code 'Y'} + * '\u0059' Year, formatted to at least * four digits with leading zeros as necessary, e.g. {@code 0092} equals * {@code 92} CE for the Gregorian calendar. * - *
{@code 'y'} - * '\u0079' + *
{@code 'y'} + * '\u0079' * Last two digits of the year, formatted with leading zeros as * necessary, i.e. {@code 00 - 99}. * - *
{@code 'j'} - * '\u006a' + *
{@code 'j'} + * '\u006a' * Day of year, formatted as three digits with leading zeros as * necessary, e.g. {@code 001 - 366} for the Gregorian calendar. * {@code 001} corresponds to the first day of the year. * - *
{@code 'm'} - * '\u006d' + *
{@code 'm'} + * '\u006d' * Month, formatted as two digits with leading zeros as necessary, * i.e. {@code 01 - 13}, where "{@code 01}" is the first month of the * year and ("{@code 13}" is a special value required to support lunar * calendars). * - *
{@code 'd'} - * '\u0064' + *
{@code 'd'} + * '\u0064' * Day of month, formatted as two digits with leading zeros as * necessary, i.e. {@code 01 - 31}, where "{@code 01}" is the first day * of the month. * - *
{@code 'e'} - * '\u0065' + *
{@code 'e'} + * '\u0065' * Day of month, formatted as two digits, i.e. {@code 1 - 31} where * "{@code 1}" is the first day of the month. * @@ -1699,31 +1699,31 @@ * * * - *
{@code 'R'} - * '\u0052' + *
{@code 'R'} + * '\u0052' * Time formatted for the 24-hour clock as {@code "%tH:%tM"} * - *
{@code 'T'} - * '\u0054' + *
{@code 'T'} + * '\u0054' * Time formatted for the 24-hour clock as {@code "%tH:%tM:%tS"}. * - *
{@code 'r'} - * '\u0072' + *
{@code 'r'} + * '\u0072' * Time formatted for the 12-hour clock as {@code "%tI:%tM:%tS * %Tp"}. The location of the morning or afternoon marker * ({@code '%Tp'}) may be locale-dependent. * - *
{@code 'D'} - * '\u0044' + *
{@code 'D'} + * '\u0044' * Date formatted as {@code "%tm/%td/%ty"}. * - *
{@code 'F'} - * '\u0046' + *
{@code 'F'} + * '\u0046' * ISO 8601 * complete date formatted as {@code "%tY-%tm-%td"}. * - *
{@code 'c'} - * '\u0063' + *
{@code 'c'} + * '\u0063' * Date and time formatted as {@code "%ta %tb %td %tT %tZ %tY"}, * e.g. {@code "Sun Jul 20 16:17:00 EDT 1969"}. * @@ -1750,7 +1750,7 @@ * * * - *
{@code '%'} + *
{@code '%'} * The result is a literal {@code '%'} ('\u0025') * *

The width is the minimum number of characters to @@ -1775,7 +1775,7 @@ * * * - *
{@code 'n'} + *
{@code 'n'} * the platform-specific line separator as returned by {@link * System#lineSeparator()}. * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/Locale.java --- a/jdk/src/java.base/share/classes/java/util/Locale.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/Locale.java Wed Apr 26 16:05:55 2017 -0700 @@ -1588,7 +1588,7 @@ *

Grandfathered tags with canonical replacements are as follows: * * - * + * * * * @@ -1617,7 +1617,7 @@ * converted as follows: * *
grandfathered tag modern replacement
art-lojban jbo
i-ami ami
- * + * * * * @@ -2774,60 +2774,60 @@ * * * - * - * - * * * - * - * - * + * * * - * - * - * * * - * - * - * + * * * - * - * - * + * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/Queue.java --- a/jdk/src/java.base/share/classes/java/util/Queue.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/Queue.java Wed Apr 26 16:05:55 2017 -0700 @@ -51,8 +51,8 @@ * * * - * - * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/concurrent/BlockingDeque.java --- a/jdk/src/java.base/share/classes/java/util/concurrent/BlockingDeque.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/concurrent/BlockingDeque.java Wed Apr 26 16:05:55 2017 -0700 @@ -56,14 +56,14 @@ *
grandfathered tag converts to
cel-gaulish xtg-x-cel-gaulish
en-GB-oed en-GB-x-oed
Language Priority List: {@code "de-*-DE"}
+ * * {@link FilteringMode#AUTOSELECT_FILTERING AUTOSELECT_FILTERING} * + * * Performs basic filtering and returns {@code "de-DE"} and * {@code "de-DE-1996"}. * + * * Performs extended filtering and returns {@code "de-DE"}, * {@code "de-Deva-DE"}, {@code "de-DE-1996"}, {@code "de-Latn-DE"}, and * {@code "de-Latn-DE-1996"}. *
+ * * {@link FilteringMode#EXTENDED_FILTERING EXTENDED_FILTERING} * + * * Performs extended filtering and returns {@code "de-DE"}, * {@code "de-Deva-DE"}, {@code "de-DE-1996"}, {@code "de-Latn-DE"}, and * {@code "de-Latn-DE-1996"}. * Same as above.Same as above.
+ * * {@link FilteringMode#IGNORE_EXTENDED_RANGES IGNORE_EXTENDED_RANGES} * + * * Performs basic filtering and returns {@code "de-DE"} and * {@code "de-DE-1996"}. * + * * Performs basic filtering and returns {@code null} because * nothing matches. *
+ * * {@link FilteringMode#MAP_EXTENDED_RANGES MAP_EXTENDED_RANGES} * Same as above. + * Same as above. * Performs basic filtering and returns {@code "de-DE"} and * {@code "de-DE-1996"} because {@code "de-*-DE"} is mapped to * {@code "de-DE"}. *
+ * * {@link FilteringMode#REJECT_EXTENDED_RANGES REJECT_EXTENDED_RANGES} * Same as above. + * Same as above. * Throws {@link IllegalArgumentException} because {@code "de-*-DE"} is * not a valid basic language range. *
Summary of Queue methods
Throws exceptionReturns special valueThrows exceptionReturns special value
Insert
* * - * + * * * * - * - * - * - * + * + * + * + * * * * @@ -87,14 +87,14 @@ * * * - * + * * * * - * - * - * - * + * + * + * + * * * * @@ -131,11 +131,11 @@ *
Summary of BlockingDeque methods
First Element (Head) First Element (Head)
Throws exceptionSpecial valueBlocksTimes outThrows exceptionSpecial valueBlocksTimes out
Insertnot applicable
Last Element (Tail) Last Element (Tail)
Throws exceptionSpecial valueBlocksTimes outThrows exceptionSpecial valueBlocksTimes out
Insert
* * - * - * + * + * * * - * + * * * * @@ -154,7 +154,7 @@ * * * - * + * * * * @@ -173,7 +173,7 @@ * * * - * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/concurrent/BlockingQueue.java --- a/jdk/src/java.base/share/classes/java/util/concurrent/BlockingQueue.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/concurrent/BlockingQueue.java Wed Apr 26 16:05:55 2017 -0700 @@ -57,10 +57,10 @@ * * * - * - * - * - * + * + * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/concurrent/ForkJoinPool.java --- a/jdk/src/java.base/share/classes/java/util/concurrent/ForkJoinPool.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/concurrent/ForkJoinPool.java Wed Apr 26 16:05:55 2017 -0700 @@ -113,8 +113,8 @@ * * * - * - * + * + * * * * diff -r 3b829f6434d8 -r b3f9f5bf40b2 jdk/src/java.base/share/classes/java/util/regex/Pattern.java --- a/jdk/src/java.base/share/classes/java/util/regex/Pattern.java Wed Apr 26 14:03:02 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/util/regex/Pattern.java Wed Apr 26 16:05:55 2017 -0700 @@ -82,305 +82,305 @@ *
Comparison of BlockingQueue and BlockingDeque methods
{@code BlockingQueue} Method Equivalent {@code BlockingDeque} Method {@code BlockingQueue} Method Equivalent {@code BlockingDeque} Method
Insert Insert
{@link #add(Object) add(e)}{@link #offerLast(Object, long, TimeUnit) offerLast(e, time, unit)}
Remove Remove
{@link #remove() remove()}{@link #pollFirst(long, TimeUnit) pollFirst(time, unit)}
Examine Examine
{@link #element() element()}
Summary of BlockingQueue methods
Throws exceptionSpecial valueBlocksTimes outThrows exceptionSpecial valueBlocksTimes out
Insert
Summary of task execution methods
Call from non-fork/join clients Call from within fork/join computations Call from non-fork/join clients Call from within fork/join computations
Arrange async execution
* - * - * - * + * + * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * - * + * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * - * + * + * * * * - * - * + * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * + * * - * + * * - * + * * * * - * + * * - * - * + * * - * - * + * * * - * + * * - * + * * - * + * * - * + * * * * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * * *
ConstructMatches
ConstructMatches
 
Characters
Characters
x
xThe character x
{@code \\}
{@code \\}The backslash character
{@code \0}n
{@code \0}nThe character with octal value {@code 0}n * (0 {@code <=} n {@code <=} 7)
{@code \0}nn
{@code \0}nnThe character with octal value {@code 0}nn * (0 {@code <=} n {@code <=} 7)
{@code \0}mnn
{@code \0}mnnThe character with octal value {@code 0}mnn * (0 {@code <=} m {@code <=} 3, * 0 {@code <=} n {@code <=} 7)
{@code \x}hh
{@code \x}hhThe character with hexadecimal value {@code 0x}hh
\uhhhh
\uhhhhThe character with hexadecimal value {@code 0x}hhhh
\x{h...h}
\x{h...h}The character with hexadecimal value {@code 0x}h...h * ({@link java.lang.Character#MIN_CODE_POINT Character.MIN_CODE_POINT} *  <= {@code 0x}h...h <=  * {@link java.lang.Character#MAX_CODE_POINT Character.MAX_CODE_POINT})
\N{name}
\N{name}The character with Unicode character name 'name'
{@code \t}
{@code \t}The tab character ('\u0009')
{@code \n}
{@code \n}The newline (line feed) character ('\u000A')
{@code \r}
{@code \r}The carriage-return character ('\u000D')
{@code \f}
{@code \f}The form-feed character ('\u000C')
{@code \a}
{@code \a}The alert (bell) character ('\u0007')
{@code \e}
{@code \e}The escape character ('\u001B')
{@code \c}x
{@code \c}xThe control character corresponding to x
 
Character classes
Character classes
{@code [abc]}
{@code [abc]}{@code a}, {@code b}, or {@code c} (simple class)
{@code [^abc]}
{@code [^abc]}Any character except {@code a}, {@code b}, or {@code c} (negation)
{@code [a-zA-Z]}
{@code [a-zA-Z]}{@code a} through {@code z} * or {@code A} through {@code Z}, inclusive (range)
{@code [a-d[m-p]]}
{@code [a-d[m-p]]}{@code a} through {@code d}, * or {@code m} through {@code p}: {@code [a-dm-p]} (union)
{@code [a-z&&[def]]}
{@code [a-z&&[def]]}{@code d}, {@code e}, or {@code f} (intersection)
{@code [a-z&&[^bc]]}
{@code [a-z&&[^bc]]}{@code a} through {@code z}, * except for {@code b} and {@code c}: {@code [ad-z]} (subtraction)
{@code [a-z&&[^m-p]]}
{@code [a-z&&[^m-p]]}{@code a} through {@code z}, * and not {@code m} through {@code p}: {@code [a-lq-z]}(subtraction)
 
Predefined character classes
Predefined character classes
{@code .}
{@code .}Any character (may or may not match line terminators)
{@code \d}
{@code \d}A digit: {@code [0-9]}
{@code \D}
{@code \D}A non-digit: {@code [^0-9]}
{@code \h}
{@code \h}A horizontal whitespace character: * [ \t\xA0\u1680\u180e\u2000-\u200a\u202f\u205f\u3000]
{@code \H}
{@code \H}A non-horizontal whitespace character: {@code [^\h]}
{@code \s}
{@code \s}A whitespace character: {@code [ \t\n\x0B\f\r]}
{@code \S}
{@code \S}A non-whitespace character: {@code [^\s]}
{@code \v}
{@code \v}A vertical whitespace character: [\n\x0B\f\r\x85\u2028\u2029] *
{@code \V}
{@code \V}A non-vertical whitespace character: {@code [^\v]}
{@code \w}
{@code \w}A word character: {@code [a-zA-Z_0-9]}
{@code \W}
{@code \W}A non-word character: {@code [^\w]}
 
POSIX character classes (US-ASCII only)
POSIX character classes (US-ASCII only)
{@code \p{Lower}}
{@code \p{Lower}}A lower-case alphabetic character: {@code [a-z]}
{@code \p{Upper}}
{@code \p{Upper}}An upper-case alphabetic character:{@code [A-Z]}
{@code \p{ASCII}}
{@code \p{ASCII}}All ASCII:{@code [\x00-\x7F]}
{@code \p{Alpha}}
{@code \p{Alpha}}An alphabetic character:{@code [\p{Lower}\p{Upper}]}
{@code \p{Digit}}
{@code \p{Digit}}A decimal digit: {@code [0-9]}
{@code \p{Alnum}}
{@code \p{Alnum}}An alphanumeric character:{@code [\p{Alpha}\p{Digit}]}
{@code \p{Punct}}
{@code \p{Punct}}Punctuation: One of {@code !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~}
{@code \p{Graph}}
{@code \p{Graph}}A visible character: {@code [\p{Alnum}\p{Punct}]}
{@code \p{Print}}
{@code \p{Print}}A printable character: {@code [\p{Graph}\x20]}
{@code \p{Blank}}
{@code \p{Blank}}A space or a tab: {@code [ \t]}
{@code \p{Cntrl}}
{@code \p{Cntrl}}A control character: {@code [\x00-\x1F\x7F]}
{@code \p{XDigit}}
{@code \p{XDigit}}A hexadecimal digit: {@code [0-9a-fA-F]}
{@code \p{Space}}
{@code \p{Space}}A whitespace character: {@code [ \t\n\x0B\f\r]}
 
java.lang.Character classes (simple java character type)
java.lang.Character classes (simple java character type)
{@code \p{javaLowerCase}}
{@code \p{javaLowerCase}}Equivalent to java.lang.Character.isLowerCase()
{@code \p{javaUpperCase}}
{@code \p{javaUpperCase}}Equivalent to java.lang.Character.isUpperCase()
{@code \p{javaWhitespace}}
{@code \p{javaWhitespace}}Equivalent to java.lang.Character.isWhitespace()
{@code \p{javaMirrored}}
{@code \p{javaMirrored}}Equivalent to java.lang.Character.isMirrored()
 
Classes for Unicode scripts, blocks, categories and binary properties
{@code \p{IsLatin}}
Classes for Unicode scripts, blocks, categories and binary properties
{@code \p{IsLatin}}A Latin script character (script)
{@code \p{InGreek}}
{@code \p{InGreek}}A character in the Greek block (block)
{@code \p{Lu}}
{@code \p{Lu}}An uppercase letter (category)
{@code \p{IsAlphabetic}}
{@code \p{IsAlphabetic}}An alphabetic character (binary property)
{@code \p{Sc}}
{@code \p{Sc}}A currency symbol
{@code \P{InGreek}}
{@code \P{InGreek}}Any character except one in the Greek block (negation)
{@code [\p{L}&&[^\p{Lu}]]}
{@code [\p{L}&&[^\p{Lu}]]}Any letter except an uppercase letter (subtraction)
 
Boundary matchers
Boundary matchers
{@code ^}
{@code ^}The beginning of a line
{@code $}
{@code $}The end of a line
{@code \b}
{@code \b}A word boundary
{@code \b{g}}
{@code \b{g}}A Unicode extended grapheme cluster boundary
{@code \B}
{@code \B}A non-word boundary
{@code \A}
{@code \A}The beginning of the input
{@code \G}
{@code \G}The end of the previous match
{@code \Z}
{@code \Z}The end of the input but for the final * terminator, if any
{@code \z}
{@code \z}The end of the input
 
Linebreak matcher
{@code \R}
Linebreak matcher
{@code \R}Any Unicode linebreak sequence, is equivalent to * \u000D\u000A|[\u000A\u000B\u000C\u000D\u0085\u2028\u2029] *
 
Unicode Extended Grapheme matcher
{@code \X}
Unicode Extended Grapheme matcher
{@code \X}Any Unicode extended grapheme cluster
 
Greedy quantifiers
Greedy quantifiers
X{@code ?}
X{@code ?}X, once or not at all
X{@code *}
X{@code *}X, zero or more times
X{@code +}
X{@code +}X, one or more times
X{n}
X{n}X, exactly n times
X{n{@code ,}}
X{n{@code ,}}X, at least n times
X{n{@code ,}m}
X{n{@code ,}m}X, at least n but not more than m times
 
Reluctant quantifiers
Reluctant quantifiers
X{@code ??}
X{@code ??}X, once or not at all
X{@code *?}
X{@code *?}X, zero or more times
X{@code +?}
X{@code +?}X, one or more times
X{n}?
X{n}?X, exactly n times
X{n,}?
X{n,}?X, at least n times
X{n{@code ,}m}?
X{n{@code ,}m}?X, at least n but not more than m times
 
Possessive quantifiers
Possessive quantifiers
X{@code ?+}
X{@code ?+}X, once or not at all
X{@code *+}
X{@code *+}X, zero or more times
X{@code ++}
X{@code ++}X, one or more times
X{n}+
X{n}+X, exactly n times
X{n,}+
X{n,}+X, at least n times
X{n{@code ,}m}+
X{n{@code ,}m}+X, at least n but not more than m times
 
Logical operators
Logical operators
XY
XYX followed by Y
X{@code |}Y
X{@code |}YEither X or Y
{@code (}X{@code )}
{@code (}X{@code )}X, as a capturing group
 
Back references
Back references
{@code \}nWhatever the nth + *
{@code \}nWhatever the nth * capturing group matched
{@code \}k<name>Whatever the + *
{@code \}k<name>Whatever the * named-capturing group "name" matched
 
Quotation
Quotation
{@code \}
{@code \}Nothing, but quotes the following character
{@code \Q}
{@code \Q}Nothing, but quotes all characters until {@code \E}
{@code \E}
{@code \E}Nothing, but ends quoting started by {@code \Q}
 
Special constructs (named-capturing and non-capturing)
Special constructs (named-capturing and non-capturing)
(?<name>X{@code )}
(?<name>X{@code )}X, as a named-capturing group
{@code (?:}X{@code )}
{@code (?:}X{@code )}X, as a non-capturing group
(?idmsuxU-idmsuxU) 
(?idmsuxU-idmsuxU) Nothing, but turns match flags i * d m s * u x U * on - off
(?idmsux-idmsux:X{@code )}  
(?idmsux-idmsux:X{@code )}  X, as a non-capturing group with the * given flags i d * m s u * x on - off
{@code (?=}X{@code )}
{@code (?=}X{@code )}X, via zero-width positive lookahead
{@code (?!}X{@code )}
{@code (?!}X{@code )}X, via zero-width negative lookahead
{@code (?<=}X{@code )}
{@code (?<=}X{@code )}X, via zero-width positive lookbehind
{@code (?X{@code )}
{@code (?X{@code )}X, via zero-width negative lookbehind
{@code (?>}X{@code )}
{@code (?>}X{@code )}X, as an independent, non-capturing group
@@ -643,9 +643,9 @@ * * - * - * - * + * + * + * * * * @@ -1209,26 +1209,26 @@ * *
ClassesMatches
ClassesMatches
{@code \p{Lower}}A lowercase character:{@code \p{IsLowercase}}
- * - * - * - * - * + * + * + * + * + * * - * - * + * + * * - * - * + * + * * - * - * + * + * * - * - * + * + * * - * - * + * + * * *
Regex    Limit    Result    
:2
Regex    Limit    Result    
:2{@code { "boo", "and:foo" }}
:5
:5{@code { "boo", "and", "foo" }}
:-2
:-2{@code { "boo", "and", "foo" }}
o5
o5{@code { "b", "", ":and:f", "", "" }}
o-2
o-2{@code { "b", "", ":and:f", "", "" }}
o0
o0{@code { "b", "", ":and:f" }}
* @@ -1296,11 +1296,11 @@ * *

- * - * - * + * + * + * * - * + * * *
Regex    Result
:
Regex    Result
:{@code { "boo", "and", "foo" }}
o
o{@code { "b", "", ":and:f" }}
*