<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Class java.lang.System
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.lang.html">This Package</a>  <a href="java.lang.StringBuffer.html#_top_">Previous</a>  <a href="java.lang.Thread.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.lang.System
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----java.lang.System
</pre>
<hr>
<dl>
  <dt> public final class <b>System</b>
  <dt> extends <a href="java.lang.Object.html#_top_">Object</a>
</dl>
The <code>System</code> class contains several useful class fields 
 and methods. It cannot be instantiated. 
 <p>
 Among the facilities provided by the <code>System</code> class 
 are standard input, standard output, and error output streams; 
 access to externally defined "properties"; a means of 
 loading files and libraries; and a utility method for quickly 
 copying a portion of an array.
<p>
<hr>
<a name="index"></a>
<h2>
  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
</h2>
<dl>
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#err"><b>err</b></a>
  <dd>  The "standard" error output stream.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#in"><b>in</b></a>
  <dd>  The "standard" input stream.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#out"><b>out</b></a>
  <dd>  The "standard" output stream.
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#arraycopy(java.lang.Object, int, java.lang.Object, int, int)"><b>arraycopy</b></a>(Object, int, Object, int, int)
  <dd> 
 Copies an array from the specified source array, beginning at the
 specified position, to the specified position of the destination array.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#currentTimeMillis()"><b>currentTimeMillis</b></a>()
  <dd>  Returns the current time in milliseconds.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#exit(int)"><b>exit</b></a>(int)
  <dd>  Terminates the currently running Java Virtual Machine.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#gc()"><b>gc</b></a>()
  <dd>  Runs the garbage collector.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getenv(java.lang.String)"><b>getenv</b></a>(String)
  <dd>  Gets an environment variable.
<b>Deprecated.</b>
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getProperties()"><b>getProperties</b></a>()
  <dd>  Determines the current system properties.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getProperty(java.lang.String)"><b>getProperty</b></a>(String)
  <dd>  Gets the system property indicated by the specified key.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getProperty(java.lang.String, java.lang.String)"><b>getProperty</b></a>(String, String)
  <dd>  Gets the system property indicated by the specified key.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getSecurityManager()"><b>getSecurityManager</b></a>()
  <dd>  Gets the system security interface.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#identityHashCode(java.lang.Object)"><b>identityHashCode</b></a>(Object)
  <dd>  Returns the same hashcode for the given object as
 would be returned by the default method hashCode(),
 whether or not the given object's class overrides
 hashCode().
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#load(java.lang.String)"><b>load</b></a>(String)
  <dd>  Loads the specified filename as a dynamic library.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#loadLibrary(java.lang.String)"><b>loadLibrary</b></a>(String)
  <dd>  Loads the system library specified by the <code>libname</code> 
 argument.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#runFinalization()"><b>runFinalization</b></a>()
  <dd>  Runs the finalization methods of any objects pending finalization.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#runFinalizersOnExit(boolean)"><b>runFinalizersOnExit</b></a>(boolean)
  <dd>  Enable or disable finalization on exit; doing so specifies that the
 finalizers of all objects that have finalizers that have not yet been
 automatically invoked are to be run before the Java runtime exits.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setErr(java.io.PrintStream)"><b>setErr</b></a>(PrintStream)
  <dd>  Reassigns the "standard" error output stream.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setIn(java.io.InputStream)"><b>setIn</b></a>(InputStream)
  <dd>  Reassigns the "standard" input stream.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setOut(java.io.PrintStream)"><b>setOut</b></a>(PrintStream)
  <dd>  Reassigns the "standard" output stream.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setProperties(java.util.Properties)"><b>setProperties</b></a>(Properties)
  <dd>  Sets the system properties to the <code>Properties</code> 
 argument.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setSecurityManager(java.lang.SecurityManager)"><b>setSecurityManager</b></a>(SecurityManager)
  <dd>  Sets the System security.
</dl>
<a name="variables"></a>
<h2>
  <img src="images/variables.gif" width=153 height=38 alt="Variables">
</h2>
<a name="in"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>in</b>
<pre>
 public static final <a href="java.io.InputStream.html#_top_">InputStream</a> in
</pre>
<dl>
  <dd> 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.<p>
</dl>
<a name="out"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>out</b>
<pre>
 public static final <a href="java.io.PrintStream.html#_top_">PrintStream</a> out
</pre>
<dl>
  <dd> 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. 
 <p>
 For simple stand-alone Java applications, a typical way to write 
 a line of output data is: 
 <ul><code>System.out.println(data)</code></ul>
 <p>
 See the <code>println</code> methods in class <code>PrintStream</code>.<p>
  <dd><dl> 
    <dt> <b>See Also:</b>
    <dd> <a href="java.io.PrintStream.html#println()">println</a>, <a href="java.io.PrintStream.html#println(boolean)">println</a>, <a href="java.io.PrintStream.html#println(char)">println</a>, <a href="java.io.PrintStream.html#println(char[])">println</a>, <a href="java.io.PrintStream.html#println(double)">println</a>, <a href="java.io.PrintStream.html#println(float)">println</a>, <a href="java.io.PrintStream.html#println(int)">println</a>, <a href="java.io.PrintStream.html#println(long)">println</a>, <a href="java.io.PrintStream.html#println(java.lang.Object)">println</a>, <a href="java.io.PrintStream.html#println(java.lang.String)">println</a>
  </dl></dd>
</dl>
<a name="err"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>err</b>
<pre>
 public static final <a href="java.io.PrintStream.html#_top_">PrintStream</a> err
</pre>
<dl>
  <dd> The "standard" error output stream. This stream is already 
 open and ready to accept output data. 
 <p>
 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 <code>out</code>, has been redirected to a file or other 
 destination that is typically not continuously monitored.<p>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="setIn(java.io.InputStream)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setIn"><b>setIn</b></a>
<pre>
 public static void setIn(<a href="java.io.InputStream.html#_top_">InputStream</a> in)
</pre>
<dl>
  <dd> Reassigns the "standard" input stream.
<p>
</dl>
<a name="setOut(java.io.PrintStream)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setOut"><b>setOut</b></a>
<pre>
 public static void setOut(<a href="java.io.PrintStream.html#_top_">PrintStream</a> out)
</pre>
<dl>
  <dd> Reassigns the "standard" output stream.
<p>
</dl>
<a name="setErr(java.io.PrintStream)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setErr"><b>setErr</b></a>
<pre>
 public static void setErr(<a href="java.io.PrintStream.html#_top_">PrintStream</a> err)
</pre>
<dl>
  <dd> Reassigns the "standard" error output stream.
<p>
</dl>
<a name="setSecurityManager(java.lang.SecurityManager)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setSecurityManager"><b>setSecurityManager</b></a>
<pre>
 public static void setSecurityManager(<a href="java.lang.SecurityManager.html#_top_">SecurityManager</a> s)
</pre>
<dl>
  <dd> Sets the System security.
 If a security manager has already been established for the 
 currently running Java application, a <code>SecurityException</code> 
 is thrown. Otherwise, the argument is established as the current 
 security manager. If the argument is <code>null</code> and no 
 security manager has been established, then no action is taken and 
 the method simply returns.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> s - the security manager.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the security manager has already
               been set.
  </dl></dd>
</dl>
<a name="getSecurityManager()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getSecurityManager"><b>getSecurityManager</b></a>
<pre>
 public static <a href="java.lang.SecurityManager.html#_top_">SecurityManager</a> getSecurityManager()
</pre>
<dl>
  <dd> Gets the system security interface.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> if a security manager has already been established for the
          current application, then that security manager is returned;
          otherwise, <code>null</code> is returned.
  </dl></dd>
</dl>
<a name="currentTimeMillis()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="currentTimeMillis"><b>currentTimeMillis</b></a>
<pre>
 public static native long currentTimeMillis()
</pre>
<dl>
  <dd> Returns the current time in milliseconds.
 <p>
 See the description of the class <code>Date</code> for a discussion 
 of slight discrepancies that may arise between "computer 
 time" and coordinated universal time (UTC).
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the difference, measured in milliseconds, between the current
          time and midnight, January 1, 1970 UTC.
    <dt> <b>See Also:</b>
    <dd> <a href="java.util.Date.html#_top_">Date</a>
  </dl></dd>
</dl>
<a name="arraycopy(java.lang.Object, int, java.lang.Object, int, int)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="arraycopy"><b>arraycopy</b></a>
<pre>
 public static native void arraycopy(<a href="java.lang.Object.html#_top_">Object</a> src,
                                     int src_position,
                                     <a href="java.lang.Object.html#_top_">Object</a> dst,
                                     int dst_position,
                                     int length)
</pre>
<dl>
  <dd> Copies an array from the specified source array, beginning at the
 specified position, to the specified position of the destination array.
 A subsequence of array components are copied from the source 
 array referenced by <code>src</code> to the destination array 
 referenced by <code>dst</code>. The number of components copied is 
 equal to the <code>length</code> argument. The components at 
 positions <code>srcOffset</code> through 
 <code>srcOffset+length-1</code> in the source array are copied into 
 positions <code>dstOffset</code> through 
 <code>dstOffset+length-1</code>, respectively, of the destination 
 array. 
 <p>
 If the <code>src</code> and <code>dst</code> arguments refer to the 
 same array object, then the copying is performed as if the 
 components at positions <code>srcOffset</code> through 
 <code>srcOffset+length-1</code> were first copied to a temporary 
 array with <code>length</code> components and then the contents of 
 the temporary array were copied into positions 
 <code>dstOffset</code> through <code>dstOffset+length-1</code> of the 
 argument array. 
 <p>
 If any of the following is true, an 
 <code>ArrayStoreException</code> is thrown and the destination is 
 not modified: 
 <ul>
 <li>The <code>src</code> argument refers to an object that is not an 
     array. 
 <li>The <code>dst</code> argument refers to an object that is not an 
     array. 
 <li>The <code>src</code> argument and <code>dst</code> argument refer to 
     arrays whose component types are different primitive types. 
 <li>The <code>src</code> argument refers to an array with a primitive 
     component type and the <code>dst</code> argument refers to an array 
     with a reference component type. 
 <li>The <code>src</code> argument refers to an array with a reference 
     component type and the <code>dst</code> argument refers to an array 
     with a primitive component type. 
 </ul>
 <p>
 Otherwise, if any of the following is true, an 
 <code>ArrayIndexOutOfBoundsException</code> is 
 thrown and the destination is not modified: 
 <ul>
 <li>The <code>srcOffset</code> argument is negative. 
 <li>The <code>dstOffset</code> argument is negative. 
 <li>The <code>length</code> argument is negative. 
 <li><code>srcOffset+length</code> is greater than 
     <code>src.length</code>, the length of the source array. 
 <li><code>dstOffset+length</code> is greater than 
     <code>dst.length</code>, the length of the destination array. 
 </ul>
 <p>
 Otherwise, if any actual component of the source array from 
 position <code>srcOffset</code> through 
 <code>srcOffset+length-1</code> cannot be converted to the component 
 type of the destination array by assignment conversion, an 
 <code>ArrayStoreException</code> is thrown. In this case, let 
 <b><i>k</i></b> be the smallest nonnegative integer less than 
 length such that <code>src[srcOffset+</code><i>k</i><code>]</code> 
 cannot be converted to the component type of the destination 
 array; when the exception is thrown, source array components from 
 positions <code>srcOffset</code> through
 <code>srcOffset+</code><i>k</i><code>-1</code> 
 will already have been copied to destination array positions 
 <code>dstOffset</code> through
 <code>dstOffset+</code><i>k</I><code>-1</code> and no other 
 positions of the destination array will have been modified.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> src: - the source array.
    <dd> srcpos - start position in the source array.
    <dd> dest - the destination array.
    <dd> destpos - start position in the destination data.
    <dd> length - the number of array elements to be copied.
    <dt> <b>Throws:</b> <a href="java.lang.ArrayIndexOutOfBoundsException.html#_top_">ArrayIndexOutOfBoundsException</a>
    <dd> if copying would cause
               access of data outside array bounds.
    <dt> <b>Throws:</b> <a href="java.lang.ArrayStoreException.html#_top_">ArrayStoreException</a>
    <dd> if an element in the <code>src</code>
               array could not be stored into the <code>dest</code> array
               because of a type mismatch.
  </dl></dd>
</dl>
<a name="identityHashCode(java.lang.Object)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="identityHashCode"><b>identityHashCode</b></a>
<pre>
 public static native int identityHashCode(<a href="java.lang.Object.html#_top_">Object</a> x)
</pre>
<dl>
  <dd> Returns the same hashcode for the given object as
 would be returned by the default method hashCode(),
 whether or not the given object's class overrides
 hashCode().
 The hashcode for the null reference is zero.
<p>
</dl>
<a name="getProperties()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProperties"><b>getProperties</b></a>
<pre>
 public static <a href="java.util.Properties.html#_top_">Properties</a> getProperties()
</pre>
<dl>
  <dd> Determines the current system properties. 
 <p>
 If there is a security manager, its 
 <code>checkPropertiesAccess</code> method is called with no 
 arguments. This may result in a security exception. 
 <p>
 The current set of system properties is returned as a 
 <code>Properties</code> object. If there is no current set of 
 system properties, a set of system properties is first created and 
 initialized. 
 <p>
 This set of system properties always includes values for the 
 following keys: 
 <table>
 <tr><th>Key</th>
     <th>Description of Associated Value</th></tr>
 <tr><td><code>java.version</code></td>
     <td>Java version number</td></tr>
 <tr><td><code>java.vendor</code></td>
     <td>Java vendor-specific string</td></tr>
 <tr><td><code>java.vendor.url</code></td>
     <td>Java vendor URL</td></tr>
 <tr><td><code>java.home</code></td>
     <td>Java installation directory</td></tr>
 <tr><td><code>java.class.version</code></td>
     <td>Java class format version number</td></tr>
 <tr><td><code>java.class.path</code></td>
     <td>Java class path</td></tr>
 <tr><td><code>os.name</code></td>
     <td>Operating system name</td></tr>
 <tr><td><code>os.arch</code></td>
     <td>Operating system architecture</td></tr>
 <tr><td><code>os.version</code></td>
     <td>Operating system version</td></tr>
 <tr><td><code>file.separator</code></td>
     <td>File separator ("/" on UNIX)</td></tr>
 <tr><td><code>path.separator</code></td>
     <td>Path separator (":" on UNIX)</td></tr>
 <tr><td><code>line.separator</code></td>
     <td>Line separator ("\n" on UNIX)</td></tr>
 <tr><td><code>user.name</code></td>
     <td>User's account name</td></tr>
 <tr><td><code>user.home</code></td>
     <td>User's home directory</td></tr>
 <tr><td><code>user.dir</code></td>
     <td>User's current working directory</td></tr>
 </table>
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot access the
               system properties.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>, <a href="java.lang.SecurityManager.html#checkPropertiesAccess()">checkPropertiesAccess</a>, <a href="java.util.Properties.html#_top_">Properties</a>
  </dl></dd>
</dl>
<a name="setProperties(java.util.Properties)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setProperties"><b>setProperties</b></a>
<pre>
 public static void setProperties(<a href="java.util.Properties.html#_top_">Properties</a> props)
</pre>
<dl>
  <dd> Sets the system properties to the <code>Properties</code> 
 argument. 
 <p>
 First, if there is a security manager, its 
 <code>checkPropertiesAccess</code> method is called with no 
 arguments. This may result in a security exception. 
 <p>
 The argument becomes the current set of system properties for use 
 by the <code>getProperty</code> method. If the argument is 
 <code>null</code>, then the current set of system properties is 
 forgotten.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> props - the new system properties.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot set the
               system properties.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>, <a href="java.lang.SecurityManager.html#checkPropertiesAccess()">checkPropertiesAccess</a>
  </dl></dd>
</dl>
<a name="getProperty(java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProperty"><b>getProperty</b></a>
<pre>
 public static <a href="java.lang.String.html#_top_">String</a> getProperty(<a href="java.lang.String.html#_top_">String</a> key)
</pre>
<dl>
  <dd> Gets the system property indicated by the specified key. 
 <p>
 First, if there is a security manager, its 
 <code>checkPropertyAccess</code> method is called with the key as 
 its argument. This may result in a system exception. 
 <p>
 If there is no current set of system properties, a set of system 
 properties is first created and initialized in the same manner as 
 for the <code>getProperties</code> method.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> key - the name of the system property.
    <dt> <b>Returns:</b>
    <dd> the string value of the system property,
             or <code>null</code> if there is no property with that key.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot access the
               system properties or the specified property.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>, <a href="java.lang.SecurityManager.html#checkPropertyAccess(java.lang.String)">checkPropertyAccess</a>, <a href="#getProperties()">getProperties</a>
  </dl></dd>
</dl>
<a name="getProperty(java.lang.String, java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProperty"><b>getProperty</b></a>
<pre>
 public static <a href="java.lang.String.html#_top_">String</a> getProperty(<a href="java.lang.String.html#_top_">String</a> key,
                                  <a href="java.lang.String.html#_top_">String</a> def)
</pre>
<dl>
  <dd> Gets the system property indicated by the specified key. 
 <p>
 First, if there is a security manager, its 
 <code>checkPropertyAccess</code> method is called with the 
 <code>key</code> as its argument. 
 <p>
 If there is no current set of system properties, a set of system 
 properties is first created and initialized in the same manner as 
 for the <code>getProperties</code> method.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> key - the name of the system property.
    <dd> def - a default value.
    <dt> <b>Returns:</b>
    <dd> the string value of the system property,
             or the default value if there is no property with that key.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot access the
               system properties or the specified property.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.SecurityManager.html#checkPropertyAccess(java.lang.String)">checkPropertyAccess</a>, <a href="#getProperties()">getProperties</a>
  </dl></dd>
</dl>
<a name="getenv(java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getenv"><b>getenv</b></a>
<pre>
 public static <a href="java.lang.String.html#_top_">String</a> getenv(<a href="java.lang.String.html#_top_">String</a> name)
</pre>
<dl>
<dd><b> Note: getenv() is deprecated.</b>
<p>
  <dd> Gets an environment variable. An environment variable is a
 system dependent external variable that has a string value.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> the - name of the environment variable.
    <dt> <b>Returns:</b>
    <dd> the value of the variable, or null if the variable is
		not defined.
  </dl></dd>
</dl>
<a name="exit(int)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="exit"><b>exit</b></a>
<pre>
 public static void exit(int status)
</pre>
<dl>
  <dd> Terminates the currently running Java Virtual Machine. The 
 argument serves as a status code; by convention, a nonzero status 
 code indicates abnormal termination. 
 <p>
 This method calls the <code>exit</code> method in class 
 <code>Runtime</code>. This method never returns normally.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> status - exit status.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot exit with
               the specified status.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#exit(int)">exit</a>
  </dl></dd>
</dl>
<a name="gc()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="gc"><b>gc</b></a>
<pre>
 public static void gc()
</pre>
<dl>
  <dd> Runs the garbage collector.
 <p>
 Calling the <code>gc</code> 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 unused 
 objects.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#gc()">gc</a>
  </dl></dd>
</dl>
<a name="runFinalization()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="runFinalization"><b>runFinalization</b></a>
<pre>
 public static void runFinalization()
</pre>
<dl>
  <dd> Runs the finalization methods of any objects pending finalization.
 <p>
 Calling this method suggests that the Java Virtual Machine expend 
 effort toward running the <code>finalize</code> methods of objects 
 that have been found to be discarded but whose <code>finalize</code> 
 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.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#runFinalization()">runFinalization</a>
  </dl></dd>
</dl>
<a name="runFinalizersOnExit(boolean)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="runFinalizersOnExit"><b>runFinalizersOnExit</b></a>
<pre>
 public static void runFinalizersOnExit(boolean value)
</pre>
<dl>
  <dd> Enable or disable finalization on exit; doing so specifies that the
 finalizers of all objects that have finalizers that have not yet been
 automatically invoked are to be run before the Java runtime exits.
 By default, finalization on exit is disabled.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#exit(int)">exit</a>, <a href="java.lang.Runtime.html#gc()">gc</a>
  </dl></dd>
</dl>
<a name="load(java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="load"><b>load</b></a>
<pre>
 public static void load(<a href="java.lang.String.html#_top_">String</a> filename)
</pre>
<dl>
  <dd> Loads the specified filename as a dynamic library. The filename 
 argument must be a complete pathname. 
 <p>
 This method calls the <code>load</code> method in class 
 <code>Runtime. </code>
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> filename - the file to load.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot load the
               specified dynamic library.
    <dt> <b>Throws:</b> <a href="java.lang.UnsatisfiedLinkError.html#_top_">UnsatisfiedLinkError</a>
    <dd> if the file does not exist.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#load(java.lang.String)">load</a>
  </dl></dd>
</dl>
<a name="loadLibrary(java.lang.String)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="loadLibrary"><b>loadLibrary</b></a>
<pre>
 public static void loadLibrary(<a href="java.lang.String.html#_top_">String</a> libname)
</pre>
<dl>
  <dd> Loads the system library specified by the <code>libname</code> 
 argument. The manner in which a library name is mapped to the 
 actual system library is system dependent.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> libname - the name of the library.
    <dt> <b>Throws:</b> <a href="java.lang.SecurityException.html#_top_">SecurityException</a>
    <dd> if the current thread cannot load the
               specified dynamic library.
    <dt> <b>Throws:</b> <a href="java.lang.UnsatisfiedLinkError.html#_top_">UnsatisfiedLinkError</a>
    <dd> if the library does not exist.
    <dt> <b>See Also:</b>
    <dd> <a href="java.lang.Runtime.html#loadLibrary(java.lang.String)">loadLibrary</a>
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.lang.html">This Package</a>  <a href="java.lang.StringBuffer.html#_top_">Previous</a>  <a href="java.lang.Thread.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
