Among the facilities provided by the System class are standard input, standard output, and error output streams; access to externally defined properties and environment variables; a means of loading files and libraries; and a utility method for quickly copying a portion of an array. It extends class Object.
Fields:
- public static final InputStream in: The “standard” input stream. This stream is already open and ready to supply input data. Typically this stream corresponds to keyboard input or another input source specified by the host environment or user.
- public static final PrintStream out: The “standard” output stream. This stream is already open and ready to accept output data. Typically this stream corresponds to display output or another output destination specified by the host environment or user.
-
public static final PrintStream err: The “standard” error output stream. This stream is already open and ready to accept output data.
Typically this stream corresponds to display output or another output destination specified by the host environment or user. By convention, this output stream is used to display error messages or other information that should come to the immediate attention of a user even if the principal output stream, the value of the variable out, has been redirected to a file or other destination that is typically not continuously monitored.
Methods:
-
static void arraycopy(Object source, int sourceStart, Object Target, int targetStart, int size): Copies an array. The array to be copied is passed in source, and the index at which point the copy will begin within source is passed in sourceStart. The array that will receive the copy is passed in target, and the index which point the copy will begin within the target is passed in targetStart. Size is the number of elements that are copied.
Syntax: public static void arraycopy(Object source, int sourceStart, Object Target, int targetStart, int size) Returns: NA. Exception: IndexOutOfBoundsException - if copying would cause access of data outside array bounds. ArrayStoreException - if an element in the source array could not be stored into the target array because of a type mismatch. NullPointerException - if either source or target is null.
// Java code illustrating arraycopy() method
import
java.lang.*;
import
java.util.Arrays;
class
SystemDemo
{
public
static
void
main(String args[])
{
int
[] a = {
1
,
2
,
3
,
4
,
5
};
int
[] b = {
6
,
7
,
8
,
9
,
10
};
System.arraycopy(a,
0
, b,
2
,
2
);
// array b after arraycopy operation
System.out.println(Arrays.toString(b));
}
}
chevron_rightfilter_noneOutput:
[6, 7, 1, 2, 10]
-
static String clearProperty(String key): Removes the system property indicated by the specified key.
Syntax: public static String clearProperty(String key) Returns: the previous string value of the system property, or null if there was no property with that key. Exception: SecurityException - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property. NullPointerException - if key is null. IllegalArgumentException - if key is empty.
-
static String getProperty(String key): Gets the system property indicated by the specified key.
Syntax: public static String getProperty(String key) Returns: the string value of the system property, or null if there is no property with that key. Exception: SecurityException - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property. NullPointerException - if key is null. IllegalArgumentException - if key is empty.
-
static String getProperty(String key, String def): Gets the system property indicated by the specified key.
Syntax: public static String getProperty(String key, String def) Returns: the string value of the system property, or the default value if there is no property with that key. Exception: SecurityException - if a security manager exists and its checkPropertyAccess method doesn't allow access to the specified system property. NullPointerException - if key is null. IllegalArgumentException - if key is empty.
-
static String setProperty(String key, String value): Sets the system property indicated by the specified key.
Syntax: public static String setProperty(String key, String value) Returns: the previous value of the system property, or null if it did not have one. Exception: SecurityException - if a security manager exists and its checkPermission method doesn't allow setting of the specified property. NullPointerException - if key or value is null. IllegalArgumentException - if key is empty.
// Java code illustrating clearProperty(), getProperty()
// and setProperty() methods
import
java.lang.*;
import
static
java.lang.System.clearProperty;
import
static
java.lang.System.setProperty;
import
java.util.Arrays;
class
SystemDemo
{
public
static
void
main(String args[])
{
// checking specific property
System.out.println(System.getProperty(
"user.home"
));
// claering this property
clearProperty(
"user.home"
);
System.out.println(System.getProperty(
"user.home"
));
// setting specific property
setProperty(
"user.country"
,
"US"
);
// checking property
System.out.println(System.getProperty(
"user.country"
));
// checking property other than system property
// illustrating getProperty(String key, String def)
System.out.println(System.getProperty(
"user.password"
,
"none of your business"
));
}
}
chevron_rightfilter_noneOutput:
/Users/abhishekverma null US none of your business
-
static Console console(): Returns the unique Console object associated with the current Java virtual machine, if any.
Syntax: public static Console console() Returns: The system console, if any, otherwise null. Exception: NA
// Java code illustrating console() method
import
java.io.Console;
import
java.lang.*;
import
java.util.Currency;
import
java.util.Locale;
class
SystemDemo
{
public
static
void
main(String args[])
throws
NullPointerException
{
Console c = System.console();
if
(c !=
null
)
{
Currency currency = Currency.getInstance(Locale.ITALY);
c.printf(currency.getSymbol());
c.flush();
}
else
System.out.println(
"No console attached"
);
}
}
chevron_rightfilter_noneOutput:
No console attached
-
static long currentTimeMillis(): Returns the current time in milliseconds. Note that while the unit of time of the return value is a millisecond, the granularity of the value depends on the underlying operating system and may be larger. For example, many operating systems measure time in units of tens of milliseconds.
Syntax: public static long currentTimeMillis() Returns: the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC. Exception: NA.
-
static long nanoTime(): Returns the current value of the running Java Virtual Machine’s high-resolution time source, in nanoseconds.
Syntax: public static long nanoTime() Returns: the current value of the running Java Virtual Machine's high-resolution time source, in nanoseconds Exception: NA
// Java code illustrating currentTimeMillis() method
import
java.lang.*;
class
SystemDemo
{
public
static
void
main(String args[])
throws
NullPointerException
{
System.out.println(
"difference between the "
+
"current time and midnight,"
+
" January 1, 1970 UTC is: "
+
System.currentTimeMillis());
System.out.println(
"cuurent time in "
+
"nano sec: "
+
System.nanoTime());
}
}
chevron_rightfilter_noneOutput:
difference between the current time and midnight, January 1, 1970 UTC is: 1499520649545 cuurent time in nano sec: 29976939759226
-
static void exit(int status): Terminates the currently running Java Virtual Machine. The argument serves as a status code; by convention, a nonzero status code indicates abnormal termination.
This method calls the exit method in class Runtime. This method never returns normally.
The call System.exit(n) is effectively equivalent to the call:
Runtime.getRuntime().exit(n)Syntax: public static void exit(int status) Returns: NA Exception: SecurityException - if a security manager exists and its checkExit method doesn't allow exit with the specified status.
// Java code illustrating exit() method
import
java.lang.*;
class
SystemDemo
{
public
static
void
main(String args[])
throws
NullPointerException
{
System.gc();
System.out.println(
"Garbage collector executed "
);
System.out.println(System.getProperty(
"os.name"
));
System.exit(
1
);
// this line will not execute as JVM terminated
System.out.println(
"JVM terminated"
);
}
}
chevron_rightfilter_noneOutput:
Garbage collector executed Mac OS X
-
static void gc(): Runs the garbage collector. Calling the gc method suggests that the Java Virtual Machine expend effort toward recycling unused objects in order to make the memory they currently occupy available for quick reuse. When control returns from the method call, the Java Virtual Machine has made a best effort to reclaim space from all discarded objects.
Syntax: public static void gc() Returns: NA Exception: NA
// Java code illustrating gc() method
import
java.lang.*;
class
SystemDemo
{
public
static
void
main(String args[])
{
Runtime gfg = Runtime.getRuntime();
long
memory1, memory2;
Integer integer[] =
new
Integer[
1000
];
// checking the total memeory
System.out.println(
"Total memory is: "
+ gfg.totalMemory());
// checking free memory
memory1 = gfg.freeMemory();
System.out.println(
"Initial free memory: "
+ memory1);
// calling the garbage collector on demand
System.gc();
memory1 = gfg.freeMemory();
System.out.println(
"Free memory after garbage "
+
"collection: "
+ memory1);
// allocating integers
for
(
int
i =
0
; i <
1000
; i++)
integer[i] =
new
Integer(i);
memory2 = gfg.freeMemory();
System.out.println(
"Free memory after allocation: "
+ memory2);
System.out.println(
"Memeory used by allocation: "
+
(memory1 - memory2));
// discard integers
for
(
int
i =
0
; i <
1000
; i++)
integer[i] =
null
;
System.gc();
memory2 = gfg.freeMemory();
System.out.println(
"Free memeory after "
+
"collecting discarded Integers: "
+ memory2);
}
}
chevron_rightfilter_noneOutput:
Total memory is: 128974848 Initial free memory: 126929976 Free memory after garbage collection: 128632160 Free memory after allocation: 127950520 Memeory used by allocation: 681640 Free memeory after collecting discarded Integers: 128643472
-
static Map getenv(): Returns an unmodifiable string map view of the current system environment. The environment is a system-dependent mapping from names to values which is passed from parent to child processes.
If the system does not support environment variables, an empty map is returned.Syntax: public static Map getenv() Returns: the environment as a map of variable names to values. Exception: SecurityException - if a security manager exists and its checkPermission method doesn't allow access to the process environment
-
static String getenv(String name): Gets the value of the specified environment variable. An environment variable is a system-dependent external named value.
System properties and environment variables are both conceptually mappings between names and values. Both mechanisms can be used to pass user-defined information to a Java process. Environment variables have a more global effect, because they are visible to all descendants of the process which defines them, not just the immediate Java subprocess. They can have subtly different semantics, such as case insensitivity, on different operating systems. For these reasons, environment variables are more likely to have unintended side effects. It is best to use system properties where possible. Environment variables should be used when a global effect is desired, or when an external system interface requires an environment variable (such as PATH).Syntax: public static String getenv(String name) Returns: the string value of the variable, or null if the variable is not defined in the system environment. Exception: NullPointerException - if name is null SecurityException - if a security manager exists and its checkPermission method doesn't allow access to the environment variable name.
// Java code illustrating getenv() method
import
java.lang.*;
import
java.util.Map;
import
java.util.Set;
class
SystemDemo
{
public
static
void
main(String args[])
{
Map<String, String> gfg = System.getenv();
Set<String> keySet = gfg.keySet();
for
(String key : keySet)
{
System.out.println(
"key= "
+ key);
}
// checking specific environment variable
System.out.println(System.getenv(
"PATH"
));
}
}
chevron_rightfilter_noneOutput:
key= JAVA_MAIN_CLASS_5396 key= PATH key= J2D_PIXMAPS key= SHELL key= USER key= TMPDIR key= SSH_AUTH_SOCK key= XPC_FLAGS key= LD_LIBRARY_PATH key= __CF_USER_TEXT_ENCODING key= Apple_PubSub_Socket_Render key= LOGNAME key= LC_CTYPE key= XPC_SERVICE_NAME key= PWD key= JAVA_MAIN_CLASS_2336 key= SHLVL key= HOME key= _ /usr/bin:/bin:/usr/sbin:/sbin
-
static Properties getProperties(): Determines the current system properties.
Syntax: public static Properties getProperties() Returns: the system properties. Exception: SecurityException - if a security manager exists and its checkPropertiesAccess method doesn't allow access to the system properties.
// Java code illustrating getProperties() method
import
java.lang.*;
import
java.util.Properties;
import
java.util.Set;
class
SystemDemo
{
public
static
void
main(String args[])
{
Properties gfg = System.getProperties();
Set<Object> keySet = gfg.keySet();
for
(Object key : keySet)
{
System.out.println(
"key= "
+ key);
}
}
}
chevron_rightfilter_noneOutput:
key= java.runtime.name key= sun.boot.library.path key= java.vm.version key= user.country.format key= gopherProxySet key= java.vm.vendor key= java.vendor.url key= path.separator key= java.vm.name key= file.encoding.pkg key= user.country key= sun.java.launcher key= sun.os.patch.level key= java.vm.specification.name key= user.dir key= java.runtime.version key= java.awt.graphicsenv key= java.endorsed.dirs key= os.arch key= java.io.tmpdir key= line.separator key= java.vm.specification.vendor key= os.name key= sun.jnu.encoding key= java.library.path key= java.specification.name key= java.class.version key= sun.management.compiler key= os.version key= http.nonProxyHosts key= user.home key= user.timezone key= java.awt.printerjob key= file.encoding key= java.specification.version key= java.class.path key= user.name key= java.vm.specification.version key= sun.java.command key= java.home key= sun.arch.data.model key= user.language key= java.specification.vendor key= awt.toolkit key= java.vm.info key= java.version key= java.ext.dirs key= sun.boot.class.path key= java.vendor key= file.separator key= java.vendor.url.bug key= sun.io.unicode.encoding key= sun.cpu.endian key= socksNonProxyHosts key= ftp.nonProxyHosts key= sun.cpu.isalist
-
static SecurityManager getSecurityManager(): Gets the system security interface.
Syntax: static SecurityManager getSecurityManager() Returns: if a security manager has already been established for the current application, then that security manager is returned; otherwise, null is returned. Exception: NA
-
static void setSecurityManager(SecurityManager s): Sets the System security.
Syntax: public static void setSecurityManager(SecurityManager s) Returns: NA. Exception: SecurityException - if the security manager has already been set and its checkPermission method doesn't allow it to be replaced.
// Java code illustrating setSecurityManager()
// and getSecurityManager() method
import
java.lang.*;
class
SystemDemo
{
public
static
void
main(String args[])
{
SecurityManager gfg =
new
SecurityManager();
// setting the security manager
System.setSecurityManager(gfg);
gfg = System.getSecurityManager();
if
(gfg !=
null
)
System.out.println(
"Security manager is configured"
);
}
}
chevron_rightfilter_noneOutput:
Security manager is configured
-
static void setErr(PrintStream err): Reassigns the “standard” error output stream.
Syntax: public static void setErr(PrintStream err) Returns: NA Exception: SecurityException - if a security manager exists and its checkPermission method doesn't allow reassigning of the standard error output stream.
-
static void setIn(InputStream in): Reassigns the “standard” input stream.
Syntax: public static void setIn(InputStream in) Returns: NA. Exception: SecurityException - if a security manager exists and its checkPermission method doesn't allow reassigning of the standard input stream.
-
static void setOut(PrintStream out): Reassigns the “standard” output stream.
Syntax: public void setOut(PrintStream out) Returns: NA Exception: SecurityException - if a security manager exists and its checkPermission method doesn't allow reassigning of the standard output stream.
// Java code illustrating setOut(), setIn() and setErr() method
import
java.lang.*;
import
java.util.Properties;
import
java.io.*;
class
SystemDemo
{
public
static
void
main(String args[])
throws
IOException
{
FileInputStream IN =
new
FileInputStream(
"input.txt"
);
FileOutputStream OUT =
new
FileOutputStream(
"system.txt"
);
// set input stream
System.setIn(IN);
char
c = (
char
) System.in.read();
System.out.print(c);
// set output stream
System.setOut(
new
PrintStream(OUT));
System.out.write(
"Hi Abhishek\n"
.getBytes());
// set error stream
System.setErr(
new
PrintStream(OUT));
System.err.write(
"Exception message\n"
.getBytes());
}
}
chevron_rightfilter_noneOutput: Output of above java code depends on content in “input.txt” file.
Create your own “input.txt” then run the code and check the output. -
static void load(String filename): Loads a code file with the specified filename from the local file system as a dynamic library. The filename argument must be a complete path name.
Syntax: public static void load(String filename) Returns: NA Exception: SecurityException - if a security manager exists and its checkLink method doesn't allow loading of the specified dynamic library UnsatisfiedLinkError - if the file does not exist. NullPointerException - if filename is null
-
static void loadLibrary(String libname): Loads the system library specified by the libname argument. The manner in which a library name is mapped to the actual system library is system dependent.
Syntax: public static void loadLibrary(String libname) Returns: NA Exception: SecurityException - if a security manager exists and its checkLink method doesn't allow loading of the specified dynamic library UnsatisfiedLinkError - if the library does not exist. NullPointerException - if libname is null
-
static String mapLibraryName(String libname): Maps a library name into a platform-specific string representing a native library.
Syntax: public static String mapLibraryName(String libname) Returns: a platform-dependent native library name. Exception: NullPointerException - if libname is null
-
static void runFinalization(): Runs the finalization methods of any objects pending finalization. Calling this method suggests that the Java Virtual Machine expend effort toward running the finalize methods of objects that have been found to be discarded but whose finalize methods have not yet been run. When control returns from the method call, the Java Virtual Machine has made a best effort to complete all outstanding finalizations.
Syntax: public static void runFinalization() Returns: NA Exception: NA.
// Java code illustrating runFinalization(), load()
// loadLibrary() and mapLibraryName() method
import
java.lang.*;
class
SystemDemo
{
public
static
void
main(String args[])
throws
NullPointerException
{
// map library name
String libName = System.mapLibraryName(
"os.name"
);
System.out.println(
"os.name library= "
+ libName);
//load external libraries
System.load(
"lixXYZ.so"
);
System.loadLibrary(
"libos.name.dylib"
);
//run finalization
System.runFinalization();
}
}
chevron_rightfilter_noneOutput:
os.name library= libos.name.dylib
-
static int identityHashCode(Object x): Returns the same hash code for the given object as would be returned by the default method hashCode(), whether or not the given object’s class overrides hashCode(). The hash code for the null reference is zero.
Syntax: public static int identityHashCode(Object x) Returns: the hashCode. Exception: NA.
-
static Channel inheritedChannel(): Returns the channel inherited from the entity that created this Java virtual machine.
Syntax: public static Channel inheritedChannel(). Returns: inherited channel, if any, otherwise null. Exception: IOException - If an I/O error occurs SecurityException - If a security manager is present and it does not permit access to the channel.
-
static String lineSeparator(): Returns the system-dependent line separator string. It always returns the same value – the initial value of the system property line.separator.
Syntax: public static String lineSeparator() Returns: On UNIX systems, it returns "\n"; on Microsoft Windows systems it returns "\r\n". Exception: NA
// Java code illustrating lineSeparator(), inherentChannel()
// and identityHashCode() method
import
java.io.IOException;
import
java.lang.*;
import
java.nio.channels.Channel;
class
SystemDemo
{
public
static
void
main(String args[])
throws
NullPointerException,
IOException
{
Integer x =
400
;
System.out.println(System.identityHashCode(x));
Channel ch = System.inheritedChannel();
System.out.println(ch);
System.out.println(System.lineSeparator());
}
}
chevron_rightfilter_noneOutput:
1735600054 null "\r\n"
This article is contributed by Abhishek Verma. If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above.
Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready.