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 */
|
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 */
|