2039 lines
132 KiB
HTML
2039 lines
132 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<!-- NewPage -->
|
|
<html lang="en">
|
|
<head>
|
|
<!-- Generated by javadoc (version 1.7.0_51) on Wed Apr 06 13:11:04 EDT 2016 -->
|
|
<title>InStream (Parallel Java 2 Library Documentation)</title>
|
|
<meta name="date" content="2016-04-06">
|
|
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
|
|
</head>
|
|
<body>
|
|
<script type="text/javascript"><!--
|
|
if (location.href.indexOf('is-external=true') == -1) {
|
|
parent.document.title="InStream (Parallel Java 2 Library Documentation)";
|
|
}
|
|
//-->
|
|
</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
<!-- ========= START OF TOP NAVBAR ======= -->
|
|
<div class="topNav"><a name="navbar_top">
|
|
<!-- -->
|
|
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="../../../overview-summary.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="class-use/InStream.html">Use</a></li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-files/index-1.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList">
|
|
<li><a href="../../../edu/rit/io/IllegalDataException.html" title="class in edu.rit.io"><span class="strong">Prev Class</span></a></li>
|
|
<li><a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io"><span class="strong">Next Class</span></a></li>
|
|
</ul>
|
|
<ul class="navList">
|
|
<li><a href="../../../index.html?edu/rit/io/InStream.html" target="_top">Frames</a></li>
|
|
<li><a href="InStream.html" target="_top">No Frames</a></li>
|
|
</ul>
|
|
<ul class="navList" id="allclasses_navbar_top">
|
|
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_top");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_summary">Constr</a> | </li>
|
|
<li><a href="#method_summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_detail">Constr</a> | </li>
|
|
<li><a href="#method_detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a name="skip-navbar_top">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ========= END OF TOP NAVBAR ========= -->
|
|
<!-- ======== START OF CLASS DATA ======== -->
|
|
<div class="header">
|
|
<div class="subTitle">edu.rit.io</div>
|
|
<h2 title="Class InStream" class="title">Class InStream</h2>
|
|
</div>
|
|
<div class="contentContainer">
|
|
<ul class="inheritance">
|
|
<li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
|
|
<li>
|
|
<ul class="inheritance">
|
|
<li>edu.rit.io.InStream</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<div class="description">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<hr>
|
|
<br>
|
|
<pre>public class <span class="strong">InStream</span>
|
|
extends <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
|
|
<div class="block">Class InStream provides an object that reads primitive data types, strings,
|
|
objects, and arrays in binary form from an underlying input stream. It reads
|
|
a byte stream that was written using class <a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io">OutStream</a> as
|
|
described in more detail in the individual methods.
|
|
<P>
|
|
The methods for reading integer types and strings read a variable number of
|
|
bytes, as described in more detail in the individual methods of class
|
|
<a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io">OutStream</a>. This can save space in the byte stream if small
|
|
integer values are written more frequently than large integer values.
|
|
<P>
|
|
Several methods for reading objects are provided:
|
|
<UL>
|
|
<P><LI>
|
|
<a href="../../../edu/rit/io/InStream.html#readFields(T)"><code>readFields()</code></a> reads just the fields of a
|
|
<a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a> object. Use this method when the reader knows the
|
|
class of the object ahead of time and has already created an instance of that
|
|
class.
|
|
<P><LI>
|
|
<a href="../../../edu/rit/io/InStream.html#readObject()"><code>readObject()</code></a> reads both the class name and the fields
|
|
of a <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a> or <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a> object. Use this method when the reader does not know the class
|
|
of the object ahead of time.
|
|
<P><LI>
|
|
<a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a> reads the class name and the fields
|
|
of a <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a> or <a href="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a> object, and also keeps a reference to the object. If the same
|
|
object is read by <a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a> again, just a
|
|
reference to the previous object is returned. Use this method when the reader
|
|
needs to end up with multiple references to the same object.
|
|
</UL>
|
|
<P>
|
|
Classes <a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io">OutStream</a> and InStream provide a <I>lightweight</I>
|
|
object serialization capability—one that generates fewer bytes than
|
|
Java Object Serialization in package java.io. However, the programmer is
|
|
responsible for writing all the serialization and deserialization code in
|
|
each class that implements interface <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a>.
|
|
<P>
|
|
To support interoperability with classes designed to work with Java Object
|
|
Serialization, <a href="../../../edu/rit/io/InStream.html#readObject()"><code>readObject()</code></a> and <a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a> will work both on <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a> objects and on
|
|
<a href="http://docs.oracle.com/javase/7/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a> objects. In the latter case, a
|
|
byte array is read, and the byte array is converted to an object using Java
|
|
Object Serialization.
|
|
<P>
|
|
Methods for reading arrays of primitive types, strings, and objects are
|
|
provided. Methods for reading multidimensional arrays are not provided; you
|
|
can read a multidimensional array by reading a series of single-dimensional
|
|
arrays.
|
|
<P>
|
|
Class InStream includes buffering. Blocks of bytes are read from the
|
|
underlying input stream and stored in an internal buffer. Items are then read
|
|
from the internal buffer.
|
|
<P>
|
|
<I>Note:</I> Class InStream is not multiple thread safe.</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="summary">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="constructor_summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Summary</h3>
|
|
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
|
|
<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colOne" scope="col">Constructor and Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colOne"><code><strong><a href="../../../edu/rit/io/InStream.html#InStream(java.io.InputStream)">InStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> in)</code>
|
|
<div class="block">Construct a new in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colOne"><code><strong><a href="../../../edu/rit/io/InStream.html#InStream(java.io.InputStream, int)">InStream</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> in,
|
|
int size)</code>
|
|
<div class="block">Construct a new in stream with the given internal buffer size.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</li>
|
|
</ul>
|
|
<!-- ========== METHOD SUMMARY =========== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="method_summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Summary</h3>
|
|
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
|
|
<caption><span>Methods</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colFirst" scope="col">Modifier and Type</th>
|
|
<th class="colLast" scope="col">Method and Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#clearCache()">clearCache</a></strong>()</code>
|
|
<div class="block">Clear the cache of objects that have been read using <a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a>.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#close()">close</a></strong>()</code>
|
|
<div class="block">Close this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>protected void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#finalize()">finalize</a></strong>()</code>
|
|
<div class="block">Finalize this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>boolean</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readBoolean()">readBoolean</a></strong>()</code>
|
|
<div class="block">Read a Boolean value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>boolean[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readBooleanArray()">readBooleanArray</a></strong>()</code>
|
|
<div class="block">Read a Boolean array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readBooleanArray(boolean[])">readBooleanArray</a></strong>(boolean[] v)</code>
|
|
<div class="block">Read the given Boolean array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readBooleanArray(boolean[], int, int)">readBooleanArray</a></strong>(boolean[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given Boolean array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>byte</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readByte()">readByte</a></strong>()</code>
|
|
<div class="block">Read a byte value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>byte[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readByteArray()">readByteArray</a></strong>()</code>
|
|
<div class="block">Read a byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readByteArray(byte[])">readByteArray</a></strong>(byte[] v)</code>
|
|
<div class="block">Read the given byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readByteArray(byte[], int, int)">readByteArray</a></strong>(byte[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>char</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readChar()">readChar</a></strong>()</code>
|
|
<div class="block">Read a character value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>char[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readCharArray()">readCharArray</a></strong>()</code>
|
|
<div class="block">Read a character array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readCharArray(char[])">readCharArray</a></strong>(char[] v)</code>
|
|
<div class="block">Read the given character array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readCharArray(char[], int, int)">readCharArray</a></strong>(char[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given character array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>double</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readDouble()">readDouble</a></strong>()</code>
|
|
<div class="block">Read a double value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>double[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readDoubleArray()">readDoubleArray</a></strong>()</code>
|
|
<div class="block">Read a double array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readDoubleArray(double[])">readDoubleArray</a></strong>(double[] v)</code>
|
|
<div class="block">Read the given double array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readDoubleArray(double[], int, int)">readDoubleArray</a></strong>(double[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given double array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><T extends <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a>> <br>T</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readFields(T)">readFields</a></strong>(T v)</code>
|
|
<div class="block">Read the given object's fields from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>float</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readFloat()">readFloat</a></strong>()</code>
|
|
<div class="block">Read a float value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>float[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readFloatArray()">readFloatArray</a></strong>()</code>
|
|
<div class="block">Read a float array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readFloatArray(float[])">readFloatArray</a></strong>(float[] v)</code>
|
|
<div class="block">Read the given float array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readFloatArray(float[], int, int)">readFloatArray</a></strong>(float[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given float array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readInt()">readInt</a></strong>()</code>
|
|
<div class="block">Read an integer value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readIntArray()">readIntArray</a></strong>()</code>
|
|
<div class="block">Read an integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readIntArray(int[])">readIntArray</a></strong>(int[] v)</code>
|
|
<div class="block">Read the given integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readIntArray(int[], int, int)">readIntArray</a></strong>(int[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>long</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readLong()">readLong</a></strong>()</code>
|
|
<div class="block">Read a long value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>long[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readLongArray()">readLongArray</a></strong>()</code>
|
|
<div class="block">Read a long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readLongArray(long[])">readLongArray</a></strong>(long[] v)</code>
|
|
<div class="block">Read the given long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readLongArray(long[], int, int)">readLongArray</a></strong>(long[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readObject()">readObject</a></strong>()</code>
|
|
<div class="block">Read an object from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readObjectArray()">readObjectArray</a></strong>()</code>
|
|
<div class="block">Read an array of objects from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readObjectArray(java.lang.Object[])">readObjectArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v)</code>
|
|
<div class="block">Read the given object array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readObjectArray(java.lang.Object[], int, int)">readObjectArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given object array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readReference()">readReference</a></strong>()</code>
|
|
<div class="block">Read a reference to an object from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readReferenceArray()">readReferenceArray</a></strong>()</code>
|
|
<div class="block">Read an array of object references from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readReferenceArray(java.lang.Object[])">readReferenceArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v)</code>
|
|
<div class="block">Read the given object reference array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readReferenceArray(java.lang.Object[], int, int)">readReferenceArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given object reference array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>short</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readShort()">readShort</a></strong>()</code>
|
|
<div class="block">Read a short value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>short[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readShortArray()">readShortArray</a></strong>()</code>
|
|
<div class="block">Read a short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readShortArray(short[])">readShortArray</a></strong>(short[] v)</code>
|
|
<div class="block">Read the given short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readShortArray(short[], int, int)">readShortArray</a></strong>(short[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readString()">readString</a></strong>()</code>
|
|
<div class="block">Read a string value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readStringArray()">readStringArray</a></strong>()</code>
|
|
<div class="block">Read a string array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readStringArray(java.lang.String[])">readStringArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] v)</code>
|
|
<div class="block">Read the given string array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readStringArray(java.lang.String[], int, int)">readStringArray</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given string array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>byte</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedByte()">readUnsignedByte</a></strong>()</code>
|
|
<div class="block">Read an unsigned byte value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>byte[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedByteArray()">readUnsignedByteArray</a></strong>()</code>
|
|
<div class="block">Read an unsigned byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedByteArray(byte[])">readUnsignedByteArray</a></strong>(byte[] v)</code>
|
|
<div class="block">Read the given unsigned byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedByteArray(byte[], int, int)">readUnsignedByteArray</a></strong>(byte[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given unsigned byte array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedInt()">readUnsignedInt</a></strong>()</code>
|
|
<div class="block">Read an unsigned integer value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>int[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedIntArray()">readUnsignedIntArray</a></strong>()</code>
|
|
<div class="block">Read an unsigned integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedIntArray(int[])">readUnsignedIntArray</a></strong>(int[] v)</code>
|
|
<div class="block">Read the given unsigned integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedIntArray(int[], int, int)">readUnsignedIntArray</a></strong>(int[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given unsigned integer array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>long</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedLong()">readUnsignedLong</a></strong>()</code>
|
|
<div class="block">Read an unsigned long value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>long[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedLongArray()">readUnsignedLongArray</a></strong>()</code>
|
|
<div class="block">Read an unsigned long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedLongArray(long[])">readUnsignedLongArray</a></strong>(long[] v)</code>
|
|
<div class="block">Read the given unsigned long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedLongArray(long[], int, int)">readUnsignedLongArray</a></strong>(long[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given unsigned long array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>short</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedShort()">readUnsignedShort</a></strong>()</code>
|
|
<div class="block">Read an unsigned short value from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>short[]</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedShortArray()">readUnsignedShortArray</a></strong>()</code>
|
|
<div class="block">Read an unsigned short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedShortArray(short[])">readUnsignedShortArray</a></strong>(short[] v)</code>
|
|
<div class="block">Read the given unsigned short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<td class="colLast"><code><strong><a href="../../../edu/rit/io/InStream.html#readUnsignedShortArray(short[], int, int)">readUnsignedShortArray</a></strong>(short[] v,
|
|
int off,
|
|
int len)</code>
|
|
<div class="block">Read a portion of the given unsigned short array from this in stream.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
|
|
<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="details">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="constructor_detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Detail</h3>
|
|
<a name="InStream(java.io.InputStream)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>InStream</h4>
|
|
<pre>public InStream(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> in)</pre>
|
|
<div class="block">Construct a new in stream. The internal buffer size is the default (8192
|
|
bytes).</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>in</code> - Underlying input stream.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>in</TT> is null.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="InStream(java.io.InputStream, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>InStream</h4>
|
|
<pre>public InStream(<a href="http://docs.oracle.com/javase/7/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</a> in,
|
|
int size)</pre>
|
|
<div class="block">Construct a new in stream with the given internal buffer size.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>in</code> - Underlying input stream.</dd><dd><code>size</code> - Internal buffer size ≥ 1 (bytes).</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>in</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - (unchecked exception) Thrown if <TT>size</TT> < 1.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<!-- ============ METHOD DETAIL ========== -->
|
|
<ul class="blockList">
|
|
<li class="blockList"><a name="method_detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Detail</h3>
|
|
<a name="readBoolean()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readBoolean</h4>
|
|
<pre>public boolean readBoolean()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a Boolean value from this in stream. One byte is read, either 0
|
|
(false) or 1 (true).
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeBoolean(boolean)"><code>OutStream.writeBoolean(boolean)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Boolean value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readByte()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readByte</h4>
|
|
<pre>public byte readByte()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a byte value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeByte(byte)"><code>OutStream.writeByte(byte)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Byte value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedByte()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedByte</h4>
|
|
<pre>public byte readUnsignedByte()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned byte value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByte(byte)"><code>OutStream.writeUnsignedByte(byte)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned byte value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readShort()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readShort</h4>
|
|
<pre>public short readShort()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a short value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeShort(short)"><code>OutStream.writeShort(short)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Short value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedShort()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedShort</h4>
|
|
<pre>public short readUnsignedShort()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned short value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShort(short)"><code>OutStream.writeUnsignedShort(short)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned short value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readChar()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readChar</h4>
|
|
<pre>public char readChar()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a character value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeChar(char)"><code>OutStream.writeChar(char)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Character value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readInt()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readInt</h4>
|
|
<pre>public int readInt()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an integer value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeInt(int)"><code>OutStream.writeInt(int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Integer value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedInt()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedInt</h4>
|
|
<pre>public int readUnsignedInt()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned integer value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedInt(int)"><code>OutStream.writeUnsignedInt(int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned integer value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readLong()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readLong</h4>
|
|
<pre>public long readLong()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a long value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeLong(long)"><code>OutStream.writeLong(long)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Long value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedLong()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedLong</h4>
|
|
<pre>public long readUnsignedLong()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned long value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLong(long)"><code>OutStream.writeUnsignedLong(long)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned long value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readFloat()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readFloat</h4>
|
|
<pre>public float readFloat()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a float value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeFloat(float)"><code>OutStream.writeFloat(float)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Float value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readDouble()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readDouble</h4>
|
|
<pre>public double readDouble()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a double value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeDouble(double)"><code>OutStream.writeDouble(double)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Double value.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readString()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readString</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> readString()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a string value from this in stream.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeString(java.lang.String)"><code>OutStream.writeString(String)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>String value, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readFields(edu.rit.io.Streamable)">
|
|
<!-- -->
|
|
</a><a name="readFields(T)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readFields</h4>
|
|
<pre>public <T extends <a href="../../../edu/rit/io/Streamable.html" title="interface in edu.rit.io">Streamable</a>> T readFields(T v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given object's fields from this in stream. The fields are read
|
|
by calling <TT>v.</TT><a href="../../../edu/rit/io/Streamable.html#readIn(edu.rit.io.InStream)"><code>readIn()</code></a>.
|
|
<TT>v</TT> must not be null.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeFields(edu.rit.io.Streamable)"><code>OutStream.writeFields()</code></a>.</div>
|
|
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>T</code> - Data type of the object.</dd><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Object.</dd>
|
|
<dt><span class="strong">Returns:</span></dt><dd>Object that was read, namely <TT>v</TT>.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readObject()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readObject</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> readObject()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an object from this in stream. An index is read using
|
|
<TT>readUnsignedInt()</TT>. If the index is 0, null is returned.
|
|
Otherwise, the index designates the object's class; if this is the first
|
|
occurrence of the class, the class name is read using
|
|
<TT>readString()</TT>; either (a) for a streamable object, a new object
|
|
is constructed using the class's no-argument constructor and the object's
|
|
fields are read by calling <TT>readFields()</TT>, or (b) for a
|
|
serializable object, a byte array is read and the byte array is converted
|
|
to an object using Java Object Serialization; and the object is returned.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObject(java.lang.Object)"><code>OutStream.writeObject()</code></a>.
|
|
<P>
|
|
<I>Note:</I> If the same object is written multiple times using <a href="../../../edu/rit/io/OutStream.html#writeObject(java.lang.Object)"><code>writeObject()</code></a>, the reader will end up with
|
|
multiple <I>different</I> objects (that are copies of each other). If the
|
|
reader needs to end up with multiple references to the <I>same</I>
|
|
object, use <a href="../../../edu/rit/io/OutStream.html#writeReference(java.lang.Object)"><code>writeReference()</code></a>.
|
|
<P>
|
|
<I>Note:</I> The calling thread's context class loader is used to
|
|
retrieve the class, given the class name.
|
|
<P>
|
|
<I>Note:</I> When constructing a new instance of a streamable object,
|
|
access checks are suppressed. This means the object's class and/or the
|
|
class's no-argument constructor need not be public, and a new instance
|
|
will still be constructed. However, this also requires that either (a) a
|
|
security manager is not installed, or (b) the security manager allows
|
|
ReflectPermission("suppressAccessChecks"). See the
|
|
<TT>java.lang.reflect.Constructor.setAccessible()</TT> method for further
|
|
information.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Object, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object could not be
|
|
deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readReference()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readReference</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a> readReference()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a reference to an object from this in stream. An index is read using
|
|
<TT>readUnsignedInt()</TT>. If the index is 0, null is returned.
|
|
Otherwise, the index designates the object reference; if this is the
|
|
first occurrence of the object, the object is read using
|
|
<TT>readObject()</TT>, and the object is saved in a cache so that later
|
|
calls to <TT>readReference()</TT> will return a reference to the saved
|
|
object; and the object reference is returned.
|
|
<P>
|
|
To write the value, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeReference(java.lang.Object)"><code>OutStream.writeReference()</code></a>.
|
|
<P>
|
|
<I>Note:</I> If the same object is written multiple times using <a href="../../../edu/rit/io/OutStream.html#writeReference(java.lang.Object)"><code>writeReference()</code></a>, the reader will end
|
|
up with multiple references to the <I>same</I> object. If the reader
|
|
needs to end up with multiple <I>different</I> objects (that are copies
|
|
of each other), use <a href="../../../edu/rit/io/OutStream.html#writeObject(java.lang.Object)"><code>writeObject()</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Object reference, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object could not be
|
|
deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="clearCache()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>clearCache</h4>
|
|
<pre>public void clearCache()</pre>
|
|
<div class="block">Clear the cache of objects that have been read using <a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a>. Afterwards, this in stream will act as though no
|
|
objects had been previously read using <a href="../../../edu/rit/io/InStream.html#readReference()"><code>readReference()</code></a>.
|
|
<P>
|
|
The reader must call <TT>clearCache()</TT> at the same point as the
|
|
writer called <a href="../../../edu/rit/io/OutStream.html#clearCache()"><code>OutStream.clearCache()</code></a>.</div>
|
|
</li>
|
|
</ul>
|
|
<a name="readBooleanArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readBooleanArray</h4>
|
|
<pre>public boolean[] readBooleanArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a Boolean array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readBoolean()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[])"><code>OutStream.writeBooleanArray(boolean[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[], int, int)"><code>OutStream.writeBooleanArray(boolean[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Boolean array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readBooleanArray(boolean[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readBooleanArray</h4>
|
|
<pre>public void readBooleanArray(boolean[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given Boolean array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readBoolean()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[])"><code>OutStream.writeBooleanArray(boolean[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[], int, int)"><code>OutStream.writeBooleanArray(boolean[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Boolean array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readBooleanArray(boolean[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readBooleanArray</h4>
|
|
<pre>public void readBooleanArray(boolean[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given Boolean array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readBoolean()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[])"><code>OutStream.writeBooleanArray(boolean[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeBooleanArray(boolean[], int, int)"><code>OutStream.writeBooleanArray(boolean[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Boolean array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readByteArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readByteArray</h4>
|
|
<pre>public byte[] readByteArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a byte array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[])"><code>OutStream.writeByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[], int, int)"><code>OutStream.writeByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Byte array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readByteArray(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readByteArray</h4>
|
|
<pre>public void readByteArray(byte[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given byte array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[])"><code>OutStream.writeByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[], int, int)"><code>OutStream.writeByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Byte array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readByteArray(byte[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readByteArray</h4>
|
|
<pre>public void readByteArray(byte[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given byte array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[])"><code>OutStream.writeByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeByteArray(byte[], int, int)"><code>OutStream.writeByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Byte array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedByteArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedByteArray</h4>
|
|
<pre>public byte[] readUnsignedByteArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned byte array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readUnsignedByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[])"><code>OutStream.writeUnsignedByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[], int, int)"><code>OutStream.writeUnsignedByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned byte array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedByteArray(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedByteArray</h4>
|
|
<pre>public void readUnsignedByteArray(byte[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given unsigned byte array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as the
|
|
length of <TT>v</TT>, an exception is thrown. Otherwise, each element of
|
|
<TT>v</TT> is read using <TT>readUnsignedByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[])"><code>OutStream.writeUnsignedByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[], int, int)"><code>OutStream.writeUnsignedByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned byte array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedByteArray(byte[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedByteArray</h4>
|
|
<pre>public void readUnsignedByteArray(byte[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given unsigned byte array from this in stream. The
|
|
length is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readUnsignedByte()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[])"><code>OutStream.writeUnsignedByteArray(byte[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedByteArray(byte[], int, int)"><code>OutStream.writeUnsignedByteArray(byte[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned byte array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readShortArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readShortArray</h4>
|
|
<pre>public short[] readShortArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a short array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[])"><code>OutStream.writeShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[], int, int)"><code>OutStream.writeShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Short array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readShortArray(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readShortArray</h4>
|
|
<pre>public void readShortArray(short[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given short array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[])"><code>OutStream.writeShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[], int, int)"><code>OutStream.writeShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Short array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readShortArray(short[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readShortArray</h4>
|
|
<pre>public void readShortArray(short[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given short array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[])"><code>OutStream.writeShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeShortArray(short[], int, int)"><code>OutStream.writeShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Short array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedShortArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedShortArray</h4>
|
|
<pre>public short[] readUnsignedShortArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned short array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readUnsignedShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[])"><code>OutStream.writeUnsignedShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[], int, int)"><code>OutStream.writeUnsignedShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned short array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedShortArray(short[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedShortArray</h4>
|
|
<pre>public void readUnsignedShortArray(short[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given unsigned short array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as the
|
|
length of <TT>v</TT>, an exception is thrown. Otherwise, each element of
|
|
<TT>v</TT> is read using <TT>readUnsignedShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[])"><code>OutStream.writeUnsignedShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[], int, int)"><code>OutStream.writeUnsignedShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned short array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedShortArray(short[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedShortArray</h4>
|
|
<pre>public void readUnsignedShortArray(short[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given unsigned short array from this in stream. The
|
|
length is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using
|
|
<TT>readUnsignedShort()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[])"><code>OutStream.writeUnsignedShortArray(short[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedShortArray(short[], int, int)"><code>OutStream.writeUnsignedShortArray(short[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned short array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readCharArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readCharArray</h4>
|
|
<pre>public char[] readCharArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a character array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readChar()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[])"><code>OutStream.writeCharArray(char[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[], int, int)"><code>OutStream.writeCharArray(char[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Character array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readCharArray(char[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readCharArray</h4>
|
|
<pre>public void readCharArray(char[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given character array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readChar()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[])"><code>OutStream.writeCharArray(char[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[], int, int)"><code>OutStream.writeCharArray(char[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Character array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readCharArray(char[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readCharArray</h4>
|
|
<pre>public void readCharArray(char[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given character array from this in stream. The
|
|
length is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readChar()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[])"><code>OutStream.writeCharArray(char[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeCharArray(char[], int, int)"><code>OutStream.writeCharArray(char[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Character array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readIntArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readIntArray</h4>
|
|
<pre>public int[] readIntArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an integer array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[])"><code>OutStream.writeIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[], int, int)"><code>OutStream.writeIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Integer array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readIntArray(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readIntArray</h4>
|
|
<pre>public void readIntArray(int[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given integer array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[])"><code>OutStream.writeIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[], int, int)"><code>OutStream.writeIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Integer array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readIntArray(int[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readIntArray</h4>
|
|
<pre>public void readIntArray(int[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given integer array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[])"><code>OutStream.writeIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeIntArray(int[], int, int)"><code>OutStream.writeIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Integer array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedIntArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedIntArray</h4>
|
|
<pre>public int[] readUnsignedIntArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned integer array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readUnsignedInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[])"><code>OutStream.writeUnsignedIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[], int, int)"><code>OutStream.writeUnsignedIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned integer array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedIntArray(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedIntArray</h4>
|
|
<pre>public void readUnsignedIntArray(int[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given unsigned integer array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as the
|
|
length of <TT>v</TT>, an exception is thrown. Otherwise, each element of
|
|
<TT>v</TT> is read using <TT>readUnsignedInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[])"><code>OutStream.writeUnsignedIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[], int, int)"><code>OutStream.writeUnsignedIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned integer array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedIntArray(int[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedIntArray</h4>
|
|
<pre>public void readUnsignedIntArray(int[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given unsigned integer array from this in stream.
|
|
The length is read using <TT>readInt()</TT>. If the length is not the
|
|
same as <TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT>
|
|
elements starting from <TT>v[off]</TT> are read using
|
|
<TT>readUnsignedInt()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[])"><code>OutStream.writeUnsignedIntArray(int[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedIntArray(int[], int, int)"><code>OutStream.writeUnsignedIntArray(int[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned integer array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readLongArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readLongArray</h4>
|
|
<pre>public long[] readLongArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a long array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[])"><code>OutStream.writeLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[], int, int)"><code>OutStream.writeLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Long array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readLongArray(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readLongArray</h4>
|
|
<pre>public void readLongArray(long[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given long array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[])"><code>OutStream.writeLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[], int, int)"><code>OutStream.writeLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Long array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readLongArray(long[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readLongArray</h4>
|
|
<pre>public void readLongArray(long[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given long array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[])"><code>OutStream.writeLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeLongArray(long[], int, int)"><code>OutStream.writeLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Long array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedLongArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedLongArray</h4>
|
|
<pre>public long[] readUnsignedLongArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an unsigned long array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readUnsignedLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[])"><code>OutStream.writeUnsignedLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[], int, int)"><code>OutStream.writeUnsignedLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Unsigned long array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedLongArray(long[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedLongArray</h4>
|
|
<pre>public void readUnsignedLongArray(long[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given unsigned long array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as the
|
|
length of <TT>v</TT>, an exception is thrown. Otherwise, each element of
|
|
<TT>v</TT> is read using <TT>readUnsignedLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[])"><code>OutStream.writeUnsignedLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[], int, int)"><code>OutStream.writeUnsignedLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned long array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readUnsignedLongArray(long[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readUnsignedLongArray</h4>
|
|
<pre>public void readUnsignedLongArray(long[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given unsigned long array from this in stream.
|
|
The length is read using <TT>readInt()</TT>. If the length is not the
|
|
same as <TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT>
|
|
elements starting from <TT>v[off]</TT> are read using
|
|
<TT>readUnsignedLong()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[])"><code>OutStream.writeUnsignedLongArray(long[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeUnsignedLongArray(long[], int, int)"><code>OutStream.writeUnsignedLongArray(long[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Unsigned long array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readFloatArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readFloatArray</h4>
|
|
<pre>public float[] readFloatArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a float array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readFloat()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[])"><code>OutStream.writeFloatArray(float[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[], int, int)"><code>OutStream.writeFloatArray(float[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Float array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readFloatArray(float[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readFloatArray</h4>
|
|
<pre>public void readFloatArray(float[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given float array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readFloat()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[])"><code>OutStream.writeFloatArray(float[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[], int, int)"><code>OutStream.writeFloatArray(float[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Float array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readFloatArray(float[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readFloatArray</h4>
|
|
<pre>public void readFloatArray(float[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given float array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readFloat()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[])"><code>OutStream.writeFloatArray(float[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeFloatArray(float[], int, int)"><code>OutStream.writeFloatArray(float[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Float array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readDoubleArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readDoubleArray</h4>
|
|
<pre>public double[] readDoubleArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a double array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readDouble()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[])"><code>OutStream.writeDoubleArray(double[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[], int, int)"><code>OutStream.writeDoubleArray(double[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Double array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readDoubleArray(double[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readDoubleArray</h4>
|
|
<pre>public void readDoubleArray(double[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given double array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readDouble()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[])"><code>OutStream.writeDoubleArray(double[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[], int, int)"><code>OutStream.writeDoubleArray(double[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Double array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readDoubleArray(double[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readDoubleArray</h4>
|
|
<pre>public void readDoubleArray(double[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given double array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readDouble()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[])"><code>OutStream.writeDoubleArray(double[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeDoubleArray(double[], int, int)"><code>OutStream.writeDoubleArray(double[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Double array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readStringArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readStringArray</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] readStringArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a string array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, a new array of the given length is created, and each element
|
|
of the array is read using <TT>readString()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[])"><code>OutStream.writeStringArray(String[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[], int, int)"><code>OutStream.writeStringArray(String[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>String array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readStringArray(java.lang.String[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readStringArray</h4>
|
|
<pre>public void readStringArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given string array from this in stream. The length is read
|
|
using <TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readString()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[])"><code>OutStream.writeStringArray(String[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[], int, int)"><code>OutStream.writeStringArray(String[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - String array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readStringArray(java.lang.String[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readStringArray</h4>
|
|
<pre>public void readStringArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given string array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readString()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[])"><code>OutStream.writeStringArray(String[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeStringArray(java.lang.String[], int, int)"><code>OutStream.writeStringArray(String[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - String array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - (unchecked exception) Thrown if <TT>v</TT> is null.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/IndexOutOfBoundsException.html?is-external=true" title="class or interface in java.lang">IndexOutOfBoundsException</a></code> - (unchecked exception) Thrown if <TT>off</TT> < 0, <TT>len</TT>
|
|
< 0, or <TT>off+len</TT> > <TT>v.length</TT>.</dd>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readObjectArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readObjectArray</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] readObjectArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an array of objects from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is −1, null is returned.
|
|
Otherwise, the array element class is read, a new array of the given
|
|
length and the given element class is created, and each element of the
|
|
array is read using <TT>readObject()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Object array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object array could not
|
|
be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readObjectArray(java.lang.Object[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readObjectArray</h4>
|
|
<pre>public void readObjectArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given object array from this in stream. The length is read using
|
|
<TT>readInt()</TT>. If the length is not the same as the length of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, the array element class is
|
|
read. If this is not the same as (or a subclass of) the element class of
|
|
<TT>v</TT>, an exception is thrown. Otherwise, each element of <TT>v</TT>
|
|
is read using <TT>readObject()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Object array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object array could not
|
|
be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readObjectArray(java.lang.Object[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readObjectArray</h4>
|
|
<pre>public void readObjectArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given object array from this in stream. The length
|
|
is read using <TT>readInt()</TT>. If the length is not the same as
|
|
<TT>len</TT>, an exception is thrown. Otherwise, the array element class
|
|
is read. If this is not the same as (or a subclass of) the element class
|
|
of <TT>v</TT>, an exception is thrown. Otherwise, <TT>len</TT> elements
|
|
starting from <TT>v[off]</TT> are read using <TT>readObject()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Object array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object array could not
|
|
be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readReferenceArray()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readReferenceArray</h4>
|
|
<pre>public <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] readReferenceArray()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read an array of object references from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is −1, null is
|
|
returned. Otherwise, the array element class is read, a new array of the
|
|
given length and the given element class is created, and each element of
|
|
the array is read using <TT>readReference()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Returns:</span></dt><dd>Object array, or null.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object reference array
|
|
could not be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readReferenceArray(java.lang.Object[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readReferenceArray</h4>
|
|
<pre>public void readReferenceArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read the given object reference array from this in stream. The length is
|
|
read using <TT>readInt()</TT>. If the length is not the same as the
|
|
length of <TT>v</TT>, an exception is thrown. Otherwise, the array
|
|
element class is read. If this is not the same as (or a subclass of) the
|
|
element class of <TT>v</TT>, an exception is thrown. Otherwise, each
|
|
element of <TT>v</TT> is read using <TT>readReference()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Object array.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object reference array
|
|
could not be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="readReferenceArray(java.lang.Object[], int, int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>readReferenceArray</h4>
|
|
<pre>public void readReferenceArray(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[] v,
|
|
int off,
|
|
int len)
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Read a portion of the given object reference array from this in stream.
|
|
The length is read using <TT>readInt()</TT>. If the length is not the
|
|
same as <TT>len</TT>, an exception is thrown. Otherwise, the array
|
|
element class is read. If this is not the same as (or a subclass of) the
|
|
element class of <TT>v</TT>, an exception is thrown. Otherwise,
|
|
<TT>len</TT> elements starting from <TT>v[off]</TT> are read using
|
|
<TT>readReference()</TT>.
|
|
<P>
|
|
To write the array, the writer must call <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[])"><code>OutStream.writeObjectArray(Object[])</code></a> or <a href="../../../edu/rit/io/OutStream.html#writeObjectArray(java.lang.Object[], int, int)"><code>OutStream.writeObjectArray(Object[],int,int)</code></a>.</div>
|
|
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>v</code> - Object array.</dd><dd><code>off</code> - Index of first element to read.</dd><dd><code>len</code> - Number of elements to read.</dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred. Thrown if the object reference array
|
|
could not be deserialized.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="close()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>close</h4>
|
|
<pre>public void close()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
|
|
<div class="block">Close this in stream. The underlying stream is closed.</div>
|
|
<dl><dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></code> - Thrown if an I/O error occurred.</dd></dl>
|
|
</li>
|
|
</ul>
|
|
<a name="finalize()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>finalize</h4>
|
|
<pre>protected void finalize()
|
|
throws <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></pre>
|
|
<div class="block">Finalize this in stream.</div>
|
|
<dl>
|
|
<dt><strong>Overrides:</strong></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a></code> in class <code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
|
|
<dt><span class="strong">Throws:</span></dt>
|
|
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html?is-external=true" title="class or interface in java.lang">Throwable</a></code></dd></dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
<div class="bottomNav"><a name="navbar_bottom">
|
|
<!-- -->
|
|
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="../../../overview-summary.html">Overview</a></li>
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="class-use/InStream.html">Use</a></li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-files/index-1.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList">
|
|
<li><a href="../../../edu/rit/io/IllegalDataException.html" title="class in edu.rit.io"><span class="strong">Prev Class</span></a></li>
|
|
<li><a href="../../../edu/rit/io/OutStream.html" title="class in edu.rit.io"><span class="strong">Next Class</span></a></li>
|
|
</ul>
|
|
<ul class="navList">
|
|
<li><a href="../../../index.html?edu/rit/io/InStream.html" target="_top">Frames</a></li>
|
|
<li><a href="InStream.html" target="_top">No Frames</a></li>
|
|
</ul>
|
|
<ul class="navList" id="allclasses_navbar_bottom">
|
|
<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_bottom");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_summary">Constr</a> | </li>
|
|
<li><a href="#method_summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor_detail">Constr</a> | </li>
|
|
<li><a href="#method_detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a name="skip-navbar_bottom">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ======== END OF BOTTOM NAVBAR ======= -->
|
|
<p class="legalCopy"><small><FONT SIZE="-2">Copyright © 2013–2016 by Alan Kaminsky. All rights reserved. Send comments to ark</FONT><FONT SIZE="1" COLOR="#FFFFFF">­</FONT><FONT SIZE="-2">@</FONT><FONT SIZE="1" COLOR="#FFFFFF">­</FONT><FONT SIZE="-2">cs.rit.edu.</FONT></small></p>
|
|
</body>
|
|
</html>
|