|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.io
|
Method Summary | |
---|---|
void |
flush()
Flushes the console and forces any buffered output to be written immediately . |
Console |
format(String fmt,
Object... args)
Writes a formatted string to this console's output stream using the specified format string and arguments. |
Console |
printf(String format,
Object... args)
A convenience method to write a formatted string to this console's output stream using the specified format string and arguments. |
Reader |
reader()
Retrieves the unique Reader object associated
with this console. |
String |
readLine()
Reads a single line of text from the console. |
String |
readLine(String fmt,
Object... args)
Provides a formatted prompt, then reads a single line of text from the console. |
char[] |
readPassword()
Reads a password or passphrase from the console with echoing disabled |
char[] |
readPassword(String fmt,
Object... args)
Provides a formatted prompt, then reads a password or passphrase from the console with echoing disabled. |
PrintWriter |
writer()
Retrieves the unique PrintWriter object
associated with this console. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public PrintWriter writer()
PrintWriter
object
associated with this console.
public Reader reader()
Reader
object associated
with this console.
This method is intended to be used by sophisticated applications, for
example, a Scanner
object which utilizes the rich
parsing/scanning functionality provided by the Scanner:
Console con = System.console(); if (con != null) { Scanner sc = new Scanner(con.reader()); ... }
For simple applications requiring only line-oriented reading, use
readLine(java.lang.String, java.lang.Object...)
.
The bulk read operations read(char[])
,
read(char[], int, int)
and
read(java.nio.CharBuffer)
on the returned object will not read in characters beyond the line
bound for each invocation, even if the destination buffer has space for
more characters. A line bound is considered to be any one of a line feed
('\n'), a carriage return ('\r'), a carriage return
followed immediately by a linefeed, or an end of stream.
public Console format(String fmt, Object... args)
fmt
- A format string as described in Format string syntaxargs
- Arguments referenced by the format specifiers in the format
string. If there are more arguments than format specifiers, the
extra arguments are ignored. The number of arguments is
variable and may be zero. The maximum number of arguments is
limited by the maximum dimension of a Java array as defined by
the Java
Virtual Machine Specification. The behaviour on a
null argument depends on the conversion.
IllegalFormatException
- If a format string contains an illegal syntax, a format
specifier that is incompatible with the given arguments,
insufficient arguments given the format string, or other
illegal conditions. For specification of all possible
formatting errors, see the Details section
of the formatter class specification.public Console printf(String format, Object... args)
An invocation of this method of the form con.printf(format, args) behaves in exactly the same way as the invocation of
con.format(format, args).
format
- A format string as described in Format string syntax.args
- Arguments referenced by the format specifiers in the format
string. If there are more arguments than format specifiers, the
extra arguments are ignored. The number of arguments is
variable and may be zero. The maximum number of arguments is
limited by the maximum dimension of a Java array as defined by
the Java
Virtual Machine Specification. The behaviour on a
null argument depends on the conversion.
IllegalFormatException
- If a format string contains an illegal syntax, a format
specifier that is incompatible with the given arguments,
insufficient arguments given the format string, or other
illegal conditions. For specification of all possible
formatting errors, see the Details section of the
formatter class specification.public String readLine(String fmt, Object... args)
fmt
- A format string as described in Format string syntax.args
- Arguments referenced by the format specifiers in the format
string. If there are more arguments than format specifiers, the
extra arguments are ignored. The maximum number of arguments is
limited by the maximum dimension of a Java array as defined by
the Java
Virtual Machine Specification.
IllegalFormatException
- If a format string contains an illegal syntax, a format
specifier that is incompatible with the given arguments,
insufficient arguments given the format string, or other
illegal conditions. For specification of all possible
formatting errors, see the Details section
of the formatter class specification.
IOError
- If an I/O error occurs.public String readLine()
IOError
- If an I/O error occurs.public char[] readPassword(String fmt, Object... args)
fmt
- A format string as described in Format string syntax
for the prompt text.args
- Arguments referenced by the format specifiers in the format
string. If there are more arguments than format specifiers, the
extra arguments are ignored. The maximum number of arguments is
limited by the maximum dimension of a Java array as defined by
the Java
Virtual Machine Specification.
IllegalFormatException
- If a format string contains an illegal syntax, a format
specifier that is incompatible with the given arguments,
insufficient arguments given the format string, or other
illegal conditions. For specification of all possible
formatting errors, see the Details
section of the formatter class specification.
IOError
- If an I/O error occurs.public char[] readPassword()
IOError
- If an I/O error occurs.public void flush()