nxtOSEK/lejos_nxj/docs/apidocs/java/io/DataOutputStream.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <!--NewPage-->
   3 <HTML>
   4 <HEAD>
   5 <!-- Generated by javadoc (build 1.5.0_09) on Tue Jan 08 20:46:02 GMT 2008 -->
   6 <TITLE>
   7 DataOutputStream (leJOS NXT API documentation)
   8 </TITLE>
   9
  10 <META NAME="keywords" CONTENT="java.io.DataOutputStream class">
  11
  12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
  13
  14 <SCRIPT type="text/javascript">
  15 function windowTitle()
  16 {
  17     parent.document.title="DataOutputStream (leJOS NXT API documentation)";
  18 }
  19 </SCRIPT>
  20 <NOSCRIPT>
  21 </NOSCRIPT>
  22
  23 </HEAD>
  24
  25 <BODY BGCOLOR="white" onload="windowTitle();">
  26
  27
  28 <!-- ========= START OF TOP NAVBAR ======= -->
  29 <A NAME="navbar_top"><!-- --></A>
  30 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
  31 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  32 <TR>
  33 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  34 <A NAME="navbar_top_firstrow"><!-- --></A>
  35 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  36   <TR ALIGN="center" VALIGN="top">
  37   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  39   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  42   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  44   </TR>
  45 </TABLE>
  46 </TD>
  47 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  48 </EM>
  49 </TD>
  50 </TR>
  51
  52 <TR>
  53 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  54 &nbsp;<A HREF="../../java/io/DataInputStream.html" title="class in java.io"><B>PREV CLASS</B></A>&nbsp;
  55 &nbsp;<A HREF="../../java/io/File.html" title="class in java.io"><B>NEXT CLASS</B></A></FONT></TD>
  56 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  57   <A HREF="../../index.html?java/io/DataOutputStream.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  58 &nbsp;<A HREF="DataOutputStream.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
  59 &nbsp;<SCRIPT type="text/javascript">
  60   <!--
  61   if(window==top) {
  62     document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
  63   }
  64   //-->
  65 </SCRIPT>
  66 <NOSCRIPT>
  67   <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
  68 </NOSCRIPT>
  69
  70
  71 </FONT></TD>
  72 </TR>
  73 <TR>
  74 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  75   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
  76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  77 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
  78 </TR>
  79 </TABLE>
  80 <A NAME="skip-navbar_top"></A>
  81 <!-- ========= END OF TOP NAVBAR ========= -->
  82
  83 <HR>
  84 <!-- ======== START OF CLASS DATA ======== -->
  85 <H2>
  86 <FONT SIZE="-1">
  87 java.io</FONT>
  88 <BR>
  89 Class DataOutputStream</H2>
  90 <PRE>
  91 <A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>
  92   <IMG SRC="../../resources/inherit.gif" ALT="extended by "><A HREF="../../java/io/OutputStream.html" title="class in java.io">java.io.OutputStream</A>
  93       <IMG SRC="../../resources/inherit.gif" ALT="extended by "><B>java.io.DataOutputStream</B>
  94 </PRE>
  95 <HR>
  96 <DL>
  97 <DT><PRE>public class <B>DataOutputStream</B><DT>extends <A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></DL>
  98 </PRE>
  99
 100 <P>
 101 Transmits java data types as bytes over an OutputStream.
 102 <P>
 103
 104 <P>
 105 <HR>
 106
 107 <P>
 108 <!-- =========== FIELD SUMMARY =========== -->
 109
 110 <A NAME="field_summary"><!-- --></A>
 111 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 112 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 113 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 114 <B>Field Summary</B></FONT></TH>
 115 </TR>
 116 <TR BGCOLOR="white" CLASS="TableRowColor">
 117 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 118 <CODE>protected &nbsp;<A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></FONT></TD>
 119 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#out">out</A></B></CODE>
 120
 121 <BR>
 122 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 123 </TR>
 124 <TR BGCOLOR="white" CLASS="TableRowColor">
 125 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 126 <CODE>protected &nbsp;int</CODE></FONT></TD>
 127 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#written">written</A></B></CODE>
 128
 129 <BR>
 130 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 131 </TR>
 132 </TABLE>
 133 &nbsp;
 134 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
 135
 136 <A NAME="constructor_summary"><!-- --></A>
 137 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 138 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 139 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 140 <B>Constructor Summary</B></FONT></TH>
 141 </TR>
 142 <TR BGCOLOR="white" CLASS="TableRowColor">
 143 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#DataOutputStream(java.io.OutputStream)">DataOutputStream</A></B>(<A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A>&nbsp;out)</CODE>
 144
 145 <BR>
 146 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 147 </TR>
 148 </TABLE>
 149 &nbsp;
 150 <!-- ========== METHOD SUMMARY =========== -->
 151
 152 <A NAME="method_summary"><!-- --></A>
 153 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 154 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 155 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
 156 <B>Method Summary</B></FONT></TH>
 157 </TR>
 158 <TR BGCOLOR="white" CLASS="TableRowColor">
 159 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 160 <CODE>&nbsp;void</CODE></FONT></TD>
 161 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#close()">close</A></B>()</CODE>
 162
 163 <BR>
 164 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Closes this data output stream.</TD>
 165 </TR>
 166 <TR BGCOLOR="white" CLASS="TableRowColor">
 167 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 168 <CODE>&nbsp;void</CODE></FONT></TD>
 169 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#flush()">flush</A></B>()</CODE>
 170
 171 <BR>
 172 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Flushes this data output stream.</TD>
 173 </TR>
 174 <TR BGCOLOR="white" CLASS="TableRowColor">
 175 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 176 <CODE>&nbsp;int</CODE></FONT></TD>
 177 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#size()">size</A></B>()</CODE>
 178
 179 <BR>
 180 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the current value of the counter <code>written</code>,
 181  the number of bytes written to this data output stream so far.</TD>
 182 </TR>
 183 <TR BGCOLOR="white" CLASS="TableRowColor">
 184 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 185 <CODE>&nbsp;void</CODE></FONT></TD>
 186 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#write(byte[], int, int)">write</A></B>(byte[]&nbsp;b,
 187       int&nbsp;off,
 188       int&nbsp;len)</CODE>
 189
 190 <BR>
 191 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes <code>len</code> bytes from the specified byte array
 192  starting at offset <code>off</code> to the underlying output stream.</TD>
 193 </TR>
 194 <TR BGCOLOR="white" CLASS="TableRowColor">
 195 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 196 <CODE>&nbsp;void</CODE></FONT></TD>
 197 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#write(int)">write</A></B>(int&nbsp;b)</CODE>
 198
 199 <BR>
 200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes the specified byte (the low eight bits of the argument
 201  <code>b</code>) to the underlying output stream.</TD>
 202 </TR>
 203 <TR BGCOLOR="white" CLASS="TableRowColor">
 204 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 205 <CODE>&nbsp;void</CODE></FONT></TD>
 206 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeBoolean(boolean)">writeBoolean</A></B>(boolean&nbsp;v)</CODE>
 207
 208 <BR>
 209 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes a <code>boolean</code> to the underlying output stream as
 210  a 1-byte value.</TD>
 211 </TR>
 212 <TR BGCOLOR="white" CLASS="TableRowColor">
 213 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 214 <CODE>&nbsp;void</CODE></FONT></TD>
 215 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeByte(int)">writeByte</A></B>(int&nbsp;v)</CODE>
 216
 217 <BR>
 218 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes out a <code>byte</code> to the underlying output stream as
 219  a 1-byte value.</TD>
 220 </TR>
 221 <TR BGCOLOR="white" CLASS="TableRowColor">
 222 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 223 <CODE>&nbsp;void</CODE></FONT></TD>
 224 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeChar(int)">writeChar</A></B>(int&nbsp;v)</CODE>
 225
 226 <BR>
 227 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes a <code>char</code> to the underlying output stream as a
 228  2-byte value, high byte first.</TD>
 229 </TR>
 230 <TR BGCOLOR="white" CLASS="TableRowColor">
 231 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 232 <CODE>&nbsp;void</CODE></FONT></TD>
 233 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeChars(java.lang.String)">writeChars</A></B>(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A>&nbsp;value)</CODE>
 234
 235 <BR>
 236 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
 237 </TR>
 238 <TR BGCOLOR="white" CLASS="TableRowColor">
 239 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 240 <CODE>&nbsp;void</CODE></FONT></TD>
 241 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeFloat(float)">writeFloat</A></B>(float&nbsp;v)</CODE>
 242
 243 <BR>
 244 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Converts the float argument to an <code>int</code> using the
 245  <code>floatToIntBits</code> method in class <code>Float</code>,
 246  and then writes that <code>int</code> value to the underlying
 247  output stream as a 4-byte quantity, high byte first.</TD>
 248 </TR>
 249 <TR BGCOLOR="white" CLASS="TableRowColor">
 250 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 251 <CODE>&nbsp;void</CODE></FONT></TD>
 252 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeInt(int)">writeInt</A></B>(int&nbsp;v)</CODE>
 253
 254 <BR>
 255 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes an <code>int</code> to the underlying output stream as four
 256  bytes, high byte first.</TD>
 257 </TR>
 258 <TR BGCOLOR="white" CLASS="TableRowColor">
 259 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 260 <CODE>&nbsp;void</CODE></FONT></TD>
 261 <TD><CODE><B><A HREF="../../java/io/DataOutputStream.html#writeShort(int)">writeShort</A></B>(int&nbsp;v)</CODE>
 262
 263 <BR>
 264 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Writes a <code>short</code> to the underlying output stream as two
 265  bytes, high byte first.</TD>
 266 </TR>
 267 </TABLE>
 268 &nbsp;<A NAME="methods_inherited_from_class_java.io.OutputStream"><!-- --></A>
 269 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 270 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 271 <TH ALIGN="left"><B>Methods inherited from class java.io.<A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></B></TH>
 272 </TR>
 273 <TR BGCOLOR="white" CLASS="TableRowColor">
 274 <TD><CODE><A HREF="../../java/io/OutputStream.html#write(byte[])">write</A></CODE></TD>
 275 </TR>
 276 </TABLE>
 277 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
 278 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 279 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
 280 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></B></TH>
 281 </TR>
 282 <TR BGCOLOR="white" CLASS="TableRowColor">
 283 <TD><CODE><A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A></CODE></TD>
 284 </TR>
 285 </TABLE>
 286 &nbsp;
 287 <P>
 288
 289 <!-- ============ FIELD DETAIL =========== -->
 290
 291 <A NAME="field_detail"><!-- --></A>
 292 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 293 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 294 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 295 <B>Field Detail</B></FONT></TH>
 296 </TR>
 297 </TABLE>
 298
 299 <A NAME="written"><!-- --></A><H3>
 300 written</H3>
 301 <PRE>
 302 protected int <B>written</B></PRE>
 303 <DL>
 304 <DL>
 305 </DL>
 306 </DL>
 307 <HR>
 308
 309 <A NAME="out"><!-- --></A><H3>
 310 out</H3>
 311 <PRE>
 312 protected <A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A> <B>out</B></PRE>
 313 <DL>
 314 <DL>
 315 </DL>
 316 </DL>
 317
 318 <!-- ========= CONSTRUCTOR DETAIL ======== -->
 319
 320 <A NAME="constructor_detail"><!-- --></A>
 321 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 322 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 323 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 324 <B>Constructor Detail</B></FONT></TH>
 325 </TR>
 326 </TABLE>
 327
 328 <A NAME="DataOutputStream(java.io.OutputStream)"><!-- --></A><H3>
 329 DataOutputStream</H3>
 330 <PRE>
 331 public <B>DataOutputStream</B>(<A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A>&nbsp;out)</PRE>
 332 <DL>
 333 </DL>
 334
 335 <!-- ============ METHOD DETAIL ========== -->
 336
 337 <A NAME="method_detail"><!-- --></A>
 338 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
 339 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
 340 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
 341 <B>Method Detail</B></FONT></TH>
 342 </TR>
 343 </TABLE>
 344
 345 <A NAME="write(int)"><!-- --></A><H3>
 346 write</H3>
 347 <PRE>
 348 public void <B>write</B>(int&nbsp;b)
 349            throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 350 <DL>
 351 <DD>Writes the specified byte (the low eight bits of the argument
 352  <code>b</code>) to the underlying output stream. If no exception
 353  is thrown, the counter <code>written</code> is incremented by
 354  <code>1</code>.
 355  <p>
 356  Implements the <code>write</code> method of <code>OutputStream</code>.
 357 <P>
 358 <DD><DL>
 359 <DT><B>Specified by:</B><DD><CODE><A HREF="../../java/io/OutputStream.html#write(int)">write</A></CODE> in class <CODE><A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></DL>
 360 </DD>
 361 <DD><DL>
 362 <DT><B>Parameters:</B><DD><CODE>b</CODE> - the <code>byte</code> to be written.
 363 <DT><B>Throws:</B>
 364 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 365 </DD>
 366 </DL>
 367 <HR>
 368
 369 <A NAME="write(byte[], int, int)"><!-- --></A><H3>
 370 write</H3>
 371 <PRE>
 372 public void <B>write</B>(byte[]&nbsp;b,
 373                   int&nbsp;off,
 374                   int&nbsp;len)
 375            throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 376 <DL>
 377 <DD>Writes <code>len</code> bytes from the specified byte array
 378  starting at offset <code>off</code> to the underlying output stream.
 379  If no exception is thrown, the counter <code>written</code> is
 380  incremented by <code>len</code>.
 381 <P>
 382 <DD><DL>
 383 <DT><B>Overrides:</B><DD><CODE><A HREF="../../java/io/OutputStream.html#write(byte[], int, int)">write</A></CODE> in class <CODE><A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></DL>
 384 </DD>
 385 <DD><DL>
 386 <DT><B>Parameters:</B><DD><CODE>b</CODE> - the data.<DD><CODE>off</CODE> - the start offset in the data.<DD><CODE>len</CODE> - the number of bytes to write.
 387 <DT><B>Throws:</B>
 388 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 389 </DD>
 390 </DL>
 391 <HR>
 392
 393 <A NAME="flush()"><!-- --></A><H3>
 394 flush</H3>
 395 <PRE>
 396 public void <B>flush</B>()
 397            throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 398 <DL>
 399 <DD>Flushes this data output stream. This forces any buffered output
 400  bytes to be written out to the stream.
 401  <p>
 402  The <code>flush</code> method of <code>DataOuputStream</code>
 403  calls the <code>flush</code> method of its underlying output stream.
 404 <P>
 405 <DD><DL>
 406 <DT><B>Overrides:</B><DD><CODE><A HREF="../../java/io/OutputStream.html#flush()">flush</A></CODE> in class <CODE><A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></DL>
 407 </DD>
 408 <DD><DL>
 409
 410 <DT><B>Throws:</B>
 411 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE>,
 412 <A HREF="../../java/io/OutputStream.html#flush()"><CODE>OutputStream.flush()</CODE></A></DL>
 413 </DD>
 414 </DL>
 415 <HR>
 416
 417 <A NAME="close()"><!-- --></A><H3>
 418 close</H3>
 419 <PRE>
 420 public void <B>close</B>()
 421            throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 422 <DL>
 423 <DD>Closes this data output stream. This forces any buffered output
 424  bytes to be written out to the stream.
 425  <p>
 426  The <code>close</code> method of <code>DataOuputStream</code>
 427  calls the <code>close</code> method of its underlying output stream.
 428 <P>
 429 <DD><DL>
 430 <DT><B>Overrides:</B><DD><CODE><A HREF="../../java/io/OutputStream.html#close()">close</A></CODE> in class <CODE><A HREF="../../java/io/OutputStream.html" title="class in java.io">OutputStream</A></CODE></DL>
 431 </DD>
 432 <DD><DL>
 433
 434 <DT><B>Throws:</B>
 435 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE>,
 436 <A HREF="../../java/io/OutputStream.html#flush()"><CODE>OutputStream.flush()</CODE></A></DL>
 437 </DD>
 438 </DL>
 439 <HR>
 440
 441 <A NAME="writeBoolean(boolean)"><!-- --></A><H3>
 442 writeBoolean</H3>
 443 <PRE>
 444 public final void <B>writeBoolean</B>(boolean&nbsp;v)
 445                         throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 446 <DL>
 447 <DD>Writes a <code>boolean</code> to the underlying output stream as
 448  a 1-byte value. The value <code>true</code> is written out as the
 449  value <code>(byte)1</code>; the value <code>false</code> is
 450  written out as the value <code>(byte)0</code>. If no exception is
 451  thrown, the counter <code>written</code> is incremented by
 452  <code>1</code>.
 453 <P>
 454 <DD><DL>
 455 <DT><B>Parameters:</B><DD><CODE>v</CODE> - a <code>boolean</code> value to be written.
 456 <DT><B>Throws:</B>
 457 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 458 </DD>
 459 </DL>
 460 <HR>
 461
 462 <A NAME="writeByte(int)"><!-- --></A><H3>
 463 writeByte</H3>
 464 <PRE>
 465 public final void <B>writeByte</B>(int&nbsp;v)
 466                      throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 467 <DL>
 468 <DD>Writes out a <code>byte</code> to the underlying output stream as
 469  a 1-byte value. If no exception is thrown, the counter
 470  <code>written</code> is incremented by <code>1</code>.
 471 <P>
 472 <DD><DL>
 473 <DT><B>Parameters:</B><DD><CODE>v</CODE> - a <code>byte</code> value to be written.
 474 <DT><B>Throws:</B>
 475 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 476 </DD>
 477 </DL>
 478 <HR>
 479
 480 <A NAME="writeShort(int)"><!-- --></A><H3>
 481 writeShort</H3>
 482 <PRE>
 483 public final void <B>writeShort</B>(int&nbsp;v)
 484                       throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 485 <DL>
 486 <DD>Writes a <code>short</code> to the underlying output stream as two
 487  bytes, high byte first. If no exception is thrown, the counter
 488  <code>written</code> is incremented by <code>2</code>.
 489 <P>
 490 <DD><DL>
 491 <DT><B>Parameters:</B><DD><CODE>v</CODE> - a <code>short</code> to be written.
 492 <DT><B>Throws:</B>
 493 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 494 </DD>
 495 </DL>
 496 <HR>
 497
 498 <A NAME="writeChar(int)"><!-- --></A><H3>
 499 writeChar</H3>
 500 <PRE>
 501 public final void <B>writeChar</B>(int&nbsp;v)
 502                      throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 503 <DL>
 504 <DD>Writes a <code>char</code> to the underlying output stream as a
 505  2-byte value, high byte first. If no exception is thrown, the
 506  counter <code>written</code> is incremented by <code>2</code>.
 507 <P>
 508 <DD><DL>
 509 <DT><B>Parameters:</B><DD><CODE>v</CODE> - a <code>char</code> value to be written.
 510 <DT><B>Throws:</B>
 511 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 512 </DD>
 513 </DL>
 514 <HR>
 515
 516 <A NAME="writeInt(int)"><!-- --></A><H3>
 517 writeInt</H3>
 518 <PRE>
 519 public final void <B>writeInt</B>(int&nbsp;v)
 520                     throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 521 <DL>
 522 <DD>Writes an <code>int</code> to the underlying output stream as four
 523  bytes, high byte first. If no exception is thrown, the counter
 524  <code>written</code> is incremented by <code>4</code>.
 525 <P>
 526 <DD><DL>
 527 <DT><B>Parameters:</B><DD><CODE>v</CODE> - an <code>int</code> to be written.
 528 <DT><B>Throws:</B>
 529 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE></DL>
 530 </DD>
 531 </DL>
 532 <HR>
 533
 534 <A NAME="writeFloat(float)"><!-- --></A><H3>
 535 writeFloat</H3>
 536 <PRE>
 537 public final void <B>writeFloat</B>(float&nbsp;v)
 538                       throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 539 <DL>
 540 <DD>Converts the float argument to an <code>int</code> using the
 541  <code>floatToIntBits</code> method in class <code>Float</code>,
 542  and then writes that <code>int</code> value to the underlying
 543  output stream as a 4-byte quantity, high byte first. If no
 544  exception is thrown, the counter <code>written</code> is
 545  incremented by <code>4</code>.
 546 <P>
 547 <DD><DL>
 548 <DT><B>Parameters:</B><DD><CODE>v</CODE> - a <code>float</code> value to be written.
 549 <DT><B>Throws:</B>
 550 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE> - if an I/O error occurs.<DT><B>See Also:</B><DD><CODE>FilterOutputStream.out</CODE>,
 551 <A HREF="../../java/lang/Float.html#floatToIntBits(float)"><CODE>Float.floatToIntBits(float)</CODE></A></DL>
 552 </DD>
 553 </DL>
 554 <HR>
 555
 556 <A NAME="size()"><!-- --></A><H3>
 557 size</H3>
 558 <PRE>
 559 public final int <B>size</B>()</PRE>
 560 <DL>
 561 <DD>Returns the current value of the counter <code>written</code>,
 562  the number of bytes written to this data output stream so far.
 563  If the counter overflows, it will be wrapped to Integer.MAX_VALUE.
 564 <P>
 565 <DD><DL>
 566
 567 <DT><B>Returns:</B><DD>the value of the <code>written</code> field.<DT><B>See Also:</B><DD><A HREF="../../java/io/DataOutputStream.html#written"><CODE>written</CODE></A></DL>
 568 </DD>
 569 </DL>
 570 <HR>
 571
 572 <A NAME="writeChars(java.lang.String)"><!-- --></A><H3>
 573 writeChars</H3>
 574 <PRE>
 575 public final void <B>writeChars</B>(<A HREF="../../java/lang/String.html" title="class in java.lang">String</A>&nbsp;value)
 576                       throws <A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></PRE>
 577 <DL>
 578 <DD><DL>
 579
 580 <DT><B>Throws:</B>
 581 <DD><CODE><A HREF="../../java/io/IOException.html" title="class in java.io">IOException</A></CODE></DL>
 582 </DD>
 583 </DL>
 584 <!-- ========= END OF CLASS DATA ========= -->
 585 <HR>
 586
 587
 588 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 589 <A NAME="navbar_bottom"><!-- --></A>
 590 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
 591 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
 592 <TR>
 593 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
 594 <A NAME="navbar_bottom_firstrow"><!-- --></A>
 595 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
 596   <TR ALIGN="center" VALIGN="top">
 597   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
 598   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 599   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 600   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 601   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 602   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 603   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 604   </TR>
 605 </TABLE>
 606 </TD>
 607 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 608 </EM>
 609 </TD>
 610 </TR>
 611
 612 <TR>
 613 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 614 &nbsp;<A HREF="../../java/io/DataInputStream.html" title="class in java.io"><B>PREV CLASS</B></A>&nbsp;
 615 &nbsp;<A HREF="../../java/io/File.html" title="class in java.io"><B>NEXT CLASS</B></A></FONT></TD>
 616 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 617   <A HREF="../../index.html?java/io/DataOutputStream.html" target="_top"><B>FRAMES</B></A>  &nbsp;
 618 &nbsp;<A HREF="DataOutputStream.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
 619 &nbsp;<SCRIPT type="text/javascript">
 620   <!--
 621   if(window==top) {
 622     document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
 623   }
 624   //-->
 625 </SCRIPT>
 626 <NOSCRIPT>
 627   <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
 628 </NOSCRIPT>
 629
 630
 631 </FONT></TD>
 632 </TR>
 633 <TR>
 634 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 635   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 636 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 637 DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 638 </TR>
 639 </TABLE>
 640 <A NAME="skip-navbar_bottom"></A>
 641 <!-- ======== END OF BOTTOM NAVBAR ======= -->
 642
 643 <HR>
 644
 645 </BODY>
 646 </HTML>