< prev index next >

src/java.base/share/classes/java/io/PrintWriter.java

Print this page
rev 60127 : 8249205: Remove unnecessary trademark symbols


 846      * enabled, calls to this method will flush the output buffer.
 847      *
 848      * <p> An invocation of this method of the form
 849      * {@code out.printf(format, args)}
 850      * behaves in exactly the same way as the invocation
 851      *
 852      * <pre>{@code
 853      *     out.format(format, args)
 854      * }</pre>
 855      *
 856      * @param  format
 857      *         A format string as described in <a
 858      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 859      *
 860      * @param  args
 861      *         Arguments referenced by the format specifiers in the format
 862      *         string.  If there are more arguments than format specifiers, the
 863      *         extra arguments are ignored.  The number of arguments is
 864      *         variable and may be zero.  The maximum number of arguments is
 865      *         limited by the maximum dimension of a Java array as defined by
 866      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
 867      *         The behaviour on a
 868      *         {@code null} argument depends on the <a
 869      *         href="../util/Formatter.html#syntax">conversion</a>.
 870      *
 871      * @throws  java.util.IllegalFormatException
 872      *          If a format string contains an illegal syntax, a format
 873      *          specifier that is incompatible with the given arguments,
 874      *          insufficient arguments given the format string, or other
 875      *          illegal conditions.  For specification of all possible
 876      *          formatting errors, see the <a
 877      *          href="../util/Formatter.html#detail">Details</a> section of the
 878      *          formatter class specification.
 879      *
 880      * @throws  NullPointerException
 881      *          If the {@code format} is {@code null}
 882      *
 883      * @return  This writer
 884      *
 885      * @since  1.5
 886      */


 899      *
 900      * <pre>{@code
 901      *     out.format(l, format, args)
 902      * }</pre>
 903      *
 904      * @param  l
 905      *         The {@linkplain java.util.Locale locale} to apply during
 906      *         formatting.  If {@code l} is {@code null} then no localization
 907      *         is applied.
 908      *
 909      * @param  format
 910      *         A format string as described in <a
 911      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 912      *
 913      * @param  args
 914      *         Arguments referenced by the format specifiers in the format
 915      *         string.  If there are more arguments than format specifiers, the
 916      *         extra arguments are ignored.  The number of arguments is
 917      *         variable and may be zero.  The maximum number of arguments is
 918      *         limited by the maximum dimension of a Java array as defined by
 919      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
 920      *         The behaviour on a
 921      *         {@code null} argument depends on the <a
 922      *         href="../util/Formatter.html#syntax">conversion</a>.
 923      *
 924      * @throws  java.util.IllegalFormatException
 925      *          If a format string contains an illegal syntax, a format
 926      *          specifier that is incompatible with the given arguments,
 927      *          insufficient arguments given the format string, or other
 928      *          illegal conditions.  For specification of all possible
 929      *          formatting errors, see the <a
 930      *          href="../util/Formatter.html#detail">Details</a> section of the
 931      *          formatter class specification.
 932      *
 933      * @throws  NullPointerException
 934      *          If the {@code format} is {@code null}
 935      *
 936      * @return  This writer
 937      *
 938      * @since  1.5
 939      */


 943 
 944     /**
 945      * Writes a formatted string to this writer using the specified format
 946      * string and arguments.  If automatic flushing is enabled, calls to this
 947      * method will flush the output buffer.
 948      *
 949      * <p> The locale always used is the one returned by {@link
 950      * java.util.Locale#getDefault() Locale.getDefault()}, regardless of any
 951      * previous invocations of other formatting methods on this object.
 952      *
 953      * @param  format
 954      *         A format string as described in <a
 955      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 956      *
 957      * @param  args
 958      *         Arguments referenced by the format specifiers in the format
 959      *         string.  If there are more arguments than format specifiers, the
 960      *         extra arguments are ignored.  The number of arguments is
 961      *         variable and may be zero.  The maximum number of arguments is
 962      *         limited by the maximum dimension of a Java array as defined by
 963      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
 964      *         The behaviour on a
 965      *         {@code null} argument depends on the <a
 966      *         href="../util/Formatter.html#syntax">conversion</a>.
 967      *
 968      * @throws  java.util.IllegalFormatException
 969      *          If a format string contains an illegal syntax, a format
 970      *          specifier that is incompatible with the given arguments,
 971      *          insufficient arguments given the format string, or other
 972      *          illegal conditions.  For specification of all possible
 973      *          formatting errors, see the <a
 974      *          href="../util/Formatter.html#detail">Details</a> section of the
 975      *          Formatter class specification.
 976      *
 977      * @throws  NullPointerException
 978      *          If the {@code format} is {@code null}
 979      *
 980      * @return  This writer
 981      *
 982      * @since  1.5
 983      */


1003     /**
1004      * Writes a formatted string to this writer using the specified format
1005      * string and arguments.  If automatic flushing is enabled, calls to this
1006      * method will flush the output buffer.
1007      *
1008      * @param  l
1009      *         The {@linkplain java.util.Locale locale} to apply during
1010      *         formatting.  If {@code l} is {@code null} then no localization
1011      *         is applied.
1012      *
1013      * @param  format
1014      *         A format string as described in <a
1015      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
1016      *
1017      * @param  args
1018      *         Arguments referenced by the format specifiers in the format
1019      *         string.  If there are more arguments than format specifiers, the
1020      *         extra arguments are ignored.  The number of arguments is
1021      *         variable and may be zero.  The maximum number of arguments is
1022      *         limited by the maximum dimension of a Java array as defined by
1023      *         <cite>The Java&trade; Virtual Machine Specification</cite>.
1024      *         The behaviour on a
1025      *         {@code null} argument depends on the <a
1026      *         href="../util/Formatter.html#syntax">conversion</a>.
1027      *
1028      * @throws  java.util.IllegalFormatException
1029      *          If a format string contains an illegal syntax, a format
1030      *          specifier that is incompatible with the given arguments,
1031      *          insufficient arguments given the format string, or other
1032      *          illegal conditions.  For specification of all possible
1033      *          formatting errors, see the <a
1034      *          href="../util/Formatter.html#detail">Details</a> section of the
1035      *          formatter class specification.
1036      *
1037      * @throws  NullPointerException
1038      *          If the {@code format} is {@code null}
1039      *
1040      * @return  This writer
1041      *
1042      * @since  1.5
1043      */




 846      * enabled, calls to this method will flush the output buffer.
 847      *
 848      * <p> An invocation of this method of the form
 849      * {@code out.printf(format, args)}
 850      * behaves in exactly the same way as the invocation
 851      *
 852      * <pre>{@code
 853      *     out.format(format, args)
 854      * }</pre>
 855      *
 856      * @param  format
 857      *         A format string as described in <a
 858      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 859      *
 860      * @param  args
 861      *         Arguments referenced by the format specifiers in the format
 862      *         string.  If there are more arguments than format specifiers, the
 863      *         extra arguments are ignored.  The number of arguments is
 864      *         variable and may be zero.  The maximum number of arguments is
 865      *         limited by the maximum dimension of a Java array as defined by
 866      *         <cite>The Java Virtual Machine Specification</cite>.
 867      *         The behaviour on a
 868      *         {@code null} argument depends on the <a
 869      *         href="../util/Formatter.html#syntax">conversion</a>.
 870      *
 871      * @throws  java.util.IllegalFormatException
 872      *          If a format string contains an illegal syntax, a format
 873      *          specifier that is incompatible with the given arguments,
 874      *          insufficient arguments given the format string, or other
 875      *          illegal conditions.  For specification of all possible
 876      *          formatting errors, see the <a
 877      *          href="../util/Formatter.html#detail">Details</a> section of the
 878      *          formatter class specification.
 879      *
 880      * @throws  NullPointerException
 881      *          If the {@code format} is {@code null}
 882      *
 883      * @return  This writer
 884      *
 885      * @since  1.5
 886      */


 899      *
 900      * <pre>{@code
 901      *     out.format(l, format, args)
 902      * }</pre>
 903      *
 904      * @param  l
 905      *         The {@linkplain java.util.Locale locale} to apply during
 906      *         formatting.  If {@code l} is {@code null} then no localization
 907      *         is applied.
 908      *
 909      * @param  format
 910      *         A format string as described in <a
 911      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 912      *
 913      * @param  args
 914      *         Arguments referenced by the format specifiers in the format
 915      *         string.  If there are more arguments than format specifiers, the
 916      *         extra arguments are ignored.  The number of arguments is
 917      *         variable and may be zero.  The maximum number of arguments is
 918      *         limited by the maximum dimension of a Java array as defined by
 919      *         <cite>The Java Virtual Machine Specification</cite>.
 920      *         The behaviour on a
 921      *         {@code null} argument depends on the <a
 922      *         href="../util/Formatter.html#syntax">conversion</a>.
 923      *
 924      * @throws  java.util.IllegalFormatException
 925      *          If a format string contains an illegal syntax, a format
 926      *          specifier that is incompatible with the given arguments,
 927      *          insufficient arguments given the format string, or other
 928      *          illegal conditions.  For specification of all possible
 929      *          formatting errors, see the <a
 930      *          href="../util/Formatter.html#detail">Details</a> section of the
 931      *          formatter class specification.
 932      *
 933      * @throws  NullPointerException
 934      *          If the {@code format} is {@code null}
 935      *
 936      * @return  This writer
 937      *
 938      * @since  1.5
 939      */


 943 
 944     /**
 945      * Writes a formatted string to this writer using the specified format
 946      * string and arguments.  If automatic flushing is enabled, calls to this
 947      * method will flush the output buffer.
 948      *
 949      * <p> The locale always used is the one returned by {@link
 950      * java.util.Locale#getDefault() Locale.getDefault()}, regardless of any
 951      * previous invocations of other formatting methods on this object.
 952      *
 953      * @param  format
 954      *         A format string as described in <a
 955      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
 956      *
 957      * @param  args
 958      *         Arguments referenced by the format specifiers in the format
 959      *         string.  If there are more arguments than format specifiers, the
 960      *         extra arguments are ignored.  The number of arguments is
 961      *         variable and may be zero.  The maximum number of arguments is
 962      *         limited by the maximum dimension of a Java array as defined by
 963      *         <cite>The Java Virtual Machine Specification</cite>.
 964      *         The behaviour on a
 965      *         {@code null} argument depends on the <a
 966      *         href="../util/Formatter.html#syntax">conversion</a>.
 967      *
 968      * @throws  java.util.IllegalFormatException
 969      *          If a format string contains an illegal syntax, a format
 970      *          specifier that is incompatible with the given arguments,
 971      *          insufficient arguments given the format string, or other
 972      *          illegal conditions.  For specification of all possible
 973      *          formatting errors, see the <a
 974      *          href="../util/Formatter.html#detail">Details</a> section of the
 975      *          Formatter class specification.
 976      *
 977      * @throws  NullPointerException
 978      *          If the {@code format} is {@code null}
 979      *
 980      * @return  This writer
 981      *
 982      * @since  1.5
 983      */


1003     /**
1004      * Writes a formatted string to this writer using the specified format
1005      * string and arguments.  If automatic flushing is enabled, calls to this
1006      * method will flush the output buffer.
1007      *
1008      * @param  l
1009      *         The {@linkplain java.util.Locale locale} to apply during
1010      *         formatting.  If {@code l} is {@code null} then no localization
1011      *         is applied.
1012      *
1013      * @param  format
1014      *         A format string as described in <a
1015      *         href="../util/Formatter.html#syntax">Format string syntax</a>.
1016      *
1017      * @param  args
1018      *         Arguments referenced by the format specifiers in the format
1019      *         string.  If there are more arguments than format specifiers, the
1020      *         extra arguments are ignored.  The number of arguments is
1021      *         variable and may be zero.  The maximum number of arguments is
1022      *         limited by the maximum dimension of a Java array as defined by
1023      *         <cite>The Java Virtual Machine Specification</cite>.
1024      *         The behaviour on a
1025      *         {@code null} argument depends on the <a
1026      *         href="../util/Formatter.html#syntax">conversion</a>.
1027      *
1028      * @throws  java.util.IllegalFormatException
1029      *          If a format string contains an illegal syntax, a format
1030      *          specifier that is incompatible with the given arguments,
1031      *          insufficient arguments given the format string, or other
1032      *          illegal conditions.  For specification of all possible
1033      *          formatting errors, see the <a
1034      *          href="../util/Formatter.html#detail">Details</a> section of the
1035      *          formatter class specification.
1036      *
1037      * @throws  NullPointerException
1038      *          If the {@code format} is {@code null}
1039      *
1040      * @return  This writer
1041      *
1042      * @since  1.5
1043      */


< prev index next >