1063 * using the specified format string and arguments.
1064 *
1065 * <p> An invocation of this method of the form
1066 * {@code out.printf(format, args)} behaves
1067 * in exactly the same way as the invocation
1068 *
1069 * <pre>{@code
1070 * out.format(format, args)
1071 * }</pre>
1072 *
1073 * @param format
1074 * A format string as described in <a
1075 * href="../util/Formatter.html#syntax">Format string syntax</a>
1076 *
1077 * @param args
1078 * Arguments referenced by the format specifiers in the format
1079 * string. If there are more arguments than format specifiers, the
1080 * extra arguments are ignored. The number of arguments is
1081 * variable and may be zero. The maximum number of arguments is
1082 * limited by the maximum dimension of a Java array as defined by
1083 * <cite>The Java™ Virtual Machine Specification</cite>.
1084 * The behaviour on a
1085 * {@code null} argument depends on the <a
1086 * href="../util/Formatter.html#syntax">conversion</a>.
1087 *
1088 * @throws java.util.IllegalFormatException
1089 * If a format string contains an illegal syntax, a format
1090 * specifier that is incompatible with the given arguments,
1091 * insufficient arguments given the format string, or other
1092 * illegal conditions. For specification of all possible
1093 * formatting errors, see the <a
1094 * href="../util/Formatter.html#detail">Details</a> section of the
1095 * formatter class specification.
1096 *
1097 * @throws NullPointerException
1098 * If the {@code format} is {@code null}
1099 *
1100 * @return This output stream
1101 *
1102 * @since 1.5
1103 */
1115 *
1116 * <pre>{@code
1117 * out.format(l, format, args)
1118 * }</pre>
1119 *
1120 * @param l
1121 * The {@linkplain java.util.Locale locale} to apply during
1122 * formatting. If {@code l} is {@code null} then no localization
1123 * is applied.
1124 *
1125 * @param format
1126 * A format string as described in <a
1127 * href="../util/Formatter.html#syntax">Format string syntax</a>
1128 *
1129 * @param args
1130 * Arguments referenced by the format specifiers in the format
1131 * string. If there are more arguments than format specifiers, the
1132 * extra arguments are ignored. The number of arguments is
1133 * variable and may be zero. The maximum number of arguments is
1134 * limited by the maximum dimension of a Java array as defined by
1135 * <cite>The Java™ Virtual Machine Specification</cite>.
1136 * The behaviour on a
1137 * {@code null} argument depends on the <a
1138 * href="../util/Formatter.html#syntax">conversion</a>.
1139 *
1140 * @throws java.util.IllegalFormatException
1141 * If a format string contains an illegal syntax, a format
1142 * specifier that is incompatible with the given arguments,
1143 * insufficient arguments given the format string, or other
1144 * illegal conditions. For specification of all possible
1145 * formatting errors, see the <a
1146 * href="../util/Formatter.html#detail">Details</a> section of the
1147 * formatter class specification.
1148 *
1149 * @throws NullPointerException
1150 * If the {@code format} is {@code null}
1151 *
1152 * @return This output stream
1153 *
1154 * @since 1.5
1155 */
1160 /**
1161 * Writes a formatted string to this output stream using the specified
1162 * format string and arguments.
1163 *
1164 * <p> The locale always used is the one returned by {@link
1165 * java.util.Locale#getDefault(Locale.Category)} with
1166 * {@link java.util.Locale.Category#FORMAT FORMAT} category specified,
1167 * regardless of any previous invocations of other formatting methods on
1168 * this object.
1169 *
1170 * @param format
1171 * A format string as described in <a
1172 * href="../util/Formatter.html#syntax">Format string syntax</a>
1173 *
1174 * @param args
1175 * Arguments referenced by the format specifiers in the format
1176 * string. If there are more arguments than format specifiers, the
1177 * extra arguments are ignored. The number of arguments is
1178 * variable and may be zero. The maximum number of arguments is
1179 * limited by the maximum dimension of a Java array as defined by
1180 * <cite>The Java™ Virtual Machine Specification</cite>.
1181 * The behaviour on a
1182 * {@code null} argument depends on the <a
1183 * href="../util/Formatter.html#syntax">conversion</a>.
1184 *
1185 * @throws java.util.IllegalFormatException
1186 * If a format string contains an illegal syntax, a format
1187 * specifier that is incompatible with the given arguments,
1188 * insufficient arguments given the format string, or other
1189 * illegal conditions. For specification of all possible
1190 * formatting errors, see the <a
1191 * href="../util/Formatter.html#detail">Details</a> section of the
1192 * formatter class specification.
1193 *
1194 * @throws NullPointerException
1195 * If the {@code format} is {@code null}
1196 *
1197 * @return This output stream
1198 *
1199 * @since 1.5
1200 */
1219
1220 /**
1221 * Writes a formatted string to this output stream using the specified
1222 * format string and arguments.
1223 *
1224 * @param l
1225 * The {@linkplain java.util.Locale locale} to apply during
1226 * formatting. If {@code l} is {@code null} then no localization
1227 * is applied.
1228 *
1229 * @param format
1230 * A format string as described in <a
1231 * href="../util/Formatter.html#syntax">Format string syntax</a>
1232 *
1233 * @param args
1234 * Arguments referenced by the format specifiers in the format
1235 * string. If there are more arguments than format specifiers, the
1236 * extra arguments are ignored. The number of arguments is
1237 * variable and may be zero. The maximum number of arguments is
1238 * limited by the maximum dimension of a Java array as defined by
1239 * <cite>The Java™ Virtual Machine Specification</cite>.
1240 * The behaviour on a
1241 * {@code null} argument depends on the <a
1242 * href="../util/Formatter.html#syntax">conversion</a>.
1243 *
1244 * @throws java.util.IllegalFormatException
1245 * If a format string contains an illegal syntax, a format
1246 * specifier that is incompatible with the given arguments,
1247 * insufficient arguments given the format string, or other
1248 * illegal conditions. For specification of all possible
1249 * formatting errors, see the <a
1250 * href="../util/Formatter.html#detail">Details</a> section of the
1251 * formatter class specification.
1252 *
1253 * @throws NullPointerException
1254 * If the {@code format} is {@code null}
1255 *
1256 * @return This output stream
1257 *
1258 * @since 1.5
1259 */
|
1063 * using the specified format string and arguments.
1064 *
1065 * <p> An invocation of this method of the form
1066 * {@code out.printf(format, args)} behaves
1067 * in exactly the same way as the invocation
1068 *
1069 * <pre>{@code
1070 * out.format(format, args)
1071 * }</pre>
1072 *
1073 * @param format
1074 * A format string as described in <a
1075 * href="../util/Formatter.html#syntax">Format string syntax</a>
1076 *
1077 * @param args
1078 * Arguments referenced by the format specifiers in the format
1079 * string. If there are more arguments than format specifiers, the
1080 * extra arguments are ignored. The number of arguments is
1081 * variable and may be zero. The maximum number of arguments is
1082 * limited by the maximum dimension of a Java array as defined by
1083 * <cite>The Java Virtual Machine Specification</cite>.
1084 * The behaviour on a
1085 * {@code null} argument depends on the <a
1086 * href="../util/Formatter.html#syntax">conversion</a>.
1087 *
1088 * @throws java.util.IllegalFormatException
1089 * If a format string contains an illegal syntax, a format
1090 * specifier that is incompatible with the given arguments,
1091 * insufficient arguments given the format string, or other
1092 * illegal conditions. For specification of all possible
1093 * formatting errors, see the <a
1094 * href="../util/Formatter.html#detail">Details</a> section of the
1095 * formatter class specification.
1096 *
1097 * @throws NullPointerException
1098 * If the {@code format} is {@code null}
1099 *
1100 * @return This output stream
1101 *
1102 * @since 1.5
1103 */
1115 *
1116 * <pre>{@code
1117 * out.format(l, format, args)
1118 * }</pre>
1119 *
1120 * @param l
1121 * The {@linkplain java.util.Locale locale} to apply during
1122 * formatting. If {@code l} is {@code null} then no localization
1123 * is applied.
1124 *
1125 * @param format
1126 * A format string as described in <a
1127 * href="../util/Formatter.html#syntax">Format string syntax</a>
1128 *
1129 * @param args
1130 * Arguments referenced by the format specifiers in the format
1131 * string. If there are more arguments than format specifiers, the
1132 * extra arguments are ignored. The number of arguments is
1133 * variable and may be zero. The maximum number of arguments is
1134 * limited by the maximum dimension of a Java array as defined by
1135 * <cite>The Java Virtual Machine Specification</cite>.
1136 * The behaviour on a
1137 * {@code null} argument depends on the <a
1138 * href="../util/Formatter.html#syntax">conversion</a>.
1139 *
1140 * @throws java.util.IllegalFormatException
1141 * If a format string contains an illegal syntax, a format
1142 * specifier that is incompatible with the given arguments,
1143 * insufficient arguments given the format string, or other
1144 * illegal conditions. For specification of all possible
1145 * formatting errors, see the <a
1146 * href="../util/Formatter.html#detail">Details</a> section of the
1147 * formatter class specification.
1148 *
1149 * @throws NullPointerException
1150 * If the {@code format} is {@code null}
1151 *
1152 * @return This output stream
1153 *
1154 * @since 1.5
1155 */
1160 /**
1161 * Writes a formatted string to this output stream using the specified
1162 * format string and arguments.
1163 *
1164 * <p> The locale always used is the one returned by {@link
1165 * java.util.Locale#getDefault(Locale.Category)} with
1166 * {@link java.util.Locale.Category#FORMAT FORMAT} category specified,
1167 * regardless of any previous invocations of other formatting methods on
1168 * this object.
1169 *
1170 * @param format
1171 * A format string as described in <a
1172 * href="../util/Formatter.html#syntax">Format string syntax</a>
1173 *
1174 * @param args
1175 * Arguments referenced by the format specifiers in the format
1176 * string. If there are more arguments than format specifiers, the
1177 * extra arguments are ignored. The number of arguments is
1178 * variable and may be zero. The maximum number of arguments is
1179 * limited by the maximum dimension of a Java array as defined by
1180 * <cite>The Java Virtual Machine Specification</cite>.
1181 * The behaviour on a
1182 * {@code null} argument depends on the <a
1183 * href="../util/Formatter.html#syntax">conversion</a>.
1184 *
1185 * @throws java.util.IllegalFormatException
1186 * If a format string contains an illegal syntax, a format
1187 * specifier that is incompatible with the given arguments,
1188 * insufficient arguments given the format string, or other
1189 * illegal conditions. For specification of all possible
1190 * formatting errors, see the <a
1191 * href="../util/Formatter.html#detail">Details</a> section of the
1192 * formatter class specification.
1193 *
1194 * @throws NullPointerException
1195 * If the {@code format} is {@code null}
1196 *
1197 * @return This output stream
1198 *
1199 * @since 1.5
1200 */
1219
1220 /**
1221 * Writes a formatted string to this output stream using the specified
1222 * format string and arguments.
1223 *
1224 * @param l
1225 * The {@linkplain java.util.Locale locale} to apply during
1226 * formatting. If {@code l} is {@code null} then no localization
1227 * is applied.
1228 *
1229 * @param format
1230 * A format string as described in <a
1231 * href="../util/Formatter.html#syntax">Format string syntax</a>
1232 *
1233 * @param args
1234 * Arguments referenced by the format specifiers in the format
1235 * string. If there are more arguments than format specifiers, the
1236 * extra arguments are ignored. The number of arguments is
1237 * variable and may be zero. The maximum number of arguments is
1238 * limited by the maximum dimension of a Java array as defined by
1239 * <cite>The Java Virtual Machine Specification</cite>.
1240 * The behaviour on a
1241 * {@code null} argument depends on the <a
1242 * href="../util/Formatter.html#syntax">conversion</a>.
1243 *
1244 * @throws java.util.IllegalFormatException
1245 * If a format string contains an illegal syntax, a format
1246 * specifier that is incompatible with the given arguments,
1247 * insufficient arguments given the format string, or other
1248 * illegal conditions. For specification of all possible
1249 * formatting errors, see the <a
1250 * href="../util/Formatter.html#detail">Details</a> section of the
1251 * formatter class specification.
1252 *
1253 * @throws NullPointerException
1254 * If the {@code format} is {@code null}
1255 *
1256 * @return This output stream
1257 *
1258 * @since 1.5
1259 */
|