< prev index next >

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

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


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&trade; 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&trade; 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&trade; 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&trade; 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      */


< prev index next >