System.in, System.out, System.error
Java has 3 streams called System.in, System.out, and System.err which are commonly used to provide input to, and output from Java applications. Most commonly used is probably System.out
for writing output to the console from console programs (command line applications).
System.in, System.out and System.err are initialised by the Java runtime when a Java VM starts up, so you don't have to instantiate any streams yourself (although you can exchange them at runtime). I will explain each of these streams in deeper detail later in this tutorial.
System.in
System.in
is an InputStream which is typically connected to keyboard input of console programs. In other words, if you start a Java application from the command line, and you type something on the keyboard while the CLI console (or terminal) has focus, the keyboard input can typically be read via System.in from inside that Java application. However, it is only keyboard input directed to that Java application (the console / terminal that started the application) which can be read via System.in. Keyboard input for other applications cannot be read via System.in .
System.in is not used as often since data is commonly passed to a command line Java application via command line arguments, files, or possibly via network connections if the application is designed for that. In applications with GUI the input to the application is given via the GUI. This is a separate input mechanism from System.in.
System.out
System.out
is a PrintStream to which you can write characters. System.out normally outputs the data you write to it to the CLI console / terminal. System.out is often used from console-only programs like command line tools as a way to display the result of their execution to the user. This is also often used to print debug statements of from a program (though it may arguably not be the best way to get debug info out of a program).
System.err
System.err
is a PrintStream
. System.err
works like System.out
except it is normally only used to output error texts. Some programs (like Eclipse) will show the output to System.err
in red text, to make it more obvious that it is error text.
Simple System.out + System.err Example:
Here is a simple example that uses System.out
and System.err
:
Exchanging System Streams
Even if the 3 System
streams are static members of the java.lang.System
class, and are pre-instantiated at JVM startup, you can change what streams to use for each of them. Just set a new InputStream
for System.in
or a new OutputStream
for System.out
or System.err
, and all further data will be read / written to the new stream.
To set a new System
stream, use one of the methods System.setIn()
, System.setOut()
or System.setErr()
. Here is a simple example:
Now all data written to System.out
should be redirected into the file "c:\\data\\system.out.txt". Keep in mind though, that you should make sure to flush System.out
and close the file before the JVM shuts down, to be sure that all data written to System.out
is actually flushed to the file.
Last updated