/*
 * Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package org.omg.CORBA;

Defines the methods used to write primitive data types to output streams
for marshalling custom value types.  This interface is used by user
written custom marshalling code for custom value types.
See Also:
DataInputStream
CustomMarshal/** Defines the methods used to write primitive data types to output streams
* for marshalling custom value types.  This interface is used by user
* written custom marshalling code for custom value types.
* @see org.omg.CORBA.DataInputStream
* @see org.omg.CORBA.CustomMarshal
*/
public interface DataOutputStream extends org.omg.CORBA.portable.ValueBase
{
    
Writes the Any value to the output stream.
Params:
value – The value to be written./**
    * Writes the Any value to the output stream.
    * @param value The value to be written.
    */
    void write_any (org.omg.CORBA.Any value);

    
Writes the boolean value to the output stream.
Params:
value – The value to be written./**
    * Writes the boolean value to the output stream.
    * @param value The value to be written.
    */
    void write_boolean (boolean value);

    
Writes the IDL character value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL character value to the output stream.
    * @param value The value to be written.
    */
    void write_char (char value);

    
Writes the IDL wide character value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL wide character value to the output stream.
    * @param value The value to be written.
    */
    void write_wchar (char value);

    
Writes the IDL octet value (represented as a Java byte) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL octet value (represented as a Java byte) to the output stream.
    * @param value The value to be written.
    */
    void write_octet (byte value);

    
Writes the IDL short value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL short value to the output stream.
    * @param value The value to be written.
    */
    void write_short (short value);

    
Writes the IDL unsigned short value (represented as a Java short
value) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL unsigned short value (represented as a Java short
    * value) to the output stream.
    * @param value The value to be written.
    */
    void write_ushort (short value);

    
Writes the IDL long value (represented as a Java int) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL long value (represented as a Java int) to the output stream.
    * @param value The value to be written.
    */
    void write_long (int value);

    
Writes the IDL unsigned long value (represented as a Java int) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL unsigned long value (represented as a Java int) to the output stream.
    * @param value The value to be written.
    */
    void write_ulong (int value);

    
Writes the IDL long long value (represented as a Java long) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL long long value (represented as a Java long) to the output stream.
    * @param value The value to be written.
    */
    void write_longlong (long value);

    
Writes the IDL unsigned long long value (represented as a Java long)
to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL unsigned long long value (represented as a Java long)
    * to the output stream.
    * @param value The value to be written.
    */
    void write_ulonglong (long value);

    
Writes the IDL float value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL float value to the output stream.
    * @param value The value to be written.
    */
    void write_float (float value);

    
Writes the IDL double value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL double value to the output stream.
    * @param value The value to be written.
    */
    void write_double (double value);

    // write_longdouble not supported by IDL/Java mapping

    
Writes the IDL string value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL string value to the output stream.
    * @param value The value to be written.
    */
    void write_string (String value);

    
Writes the IDL wide string value (represented as a Java String) to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL wide string value (represented as a Java String) to the output stream.
    * @param value The value to be written.
    */
    void write_wstring (String value);

    
Writes the IDL CORBA::Object value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL CORBA::Object value to the output stream.
    * @param value The value to be written.
    */
    void write_Object (org.omg.CORBA.Object value);

    
Writes the IDL Abstract interface type to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL Abstract interface type to the output stream.
    * @param value The value to be written.
    */
    void write_Abstract (java.lang.Object value);

    
Writes the IDL value type value to the output stream.
Params:
value – The value to be written./**
    * Writes the IDL value type value to the output stream.
    * @param value The value to be written.
    */
    void write_Value (java.io.Serializable value);

    
Writes the typecode to the output stream.
Params:
value – The value to be written./**
    * Writes the typecode to the output stream.
    * @param value The value to be written.
    */
    void write_TypeCode (org.omg.CORBA.TypeCode value);

    
Writes the array of IDL Anys from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL Anys from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_any_array (org.omg.CORBA.Any[] seq, int offset, int length);

    
Writes the array of IDL booleans from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL booleans from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_boolean_array (boolean[] seq, int offset, int length);

    
Writes the array of IDL characters from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL characters from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_char_array (char[] seq, int offset, int length);

    
Writes the array of IDL wide characters from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL wide characters from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_wchar_array (char[] seq, int offset, int length);

    
Writes the array of IDL octets from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL octets from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_octet_array (byte[] seq, int offset, int length);

    
Writes the array of IDL shorts from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL shorts from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_short_array (short[] seq, int offset, int length);

    
Writes the array of IDL unsigned shorts (represented as Java shorts)
from offset for length elements to the output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL unsigned shorts (represented as Java shorts)
    * from offset for length elements to the output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_ushort_array (short[] seq, int offset, int length);

    
Writes the array of IDL longs from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL longs from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_long_array (int[] seq, int offset, int length);

    
Writes the array of IDL unsigned longs (represented as Java ints)
from offset for length elements to the output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL unsigned longs (represented as Java ints)
    * from offset for length elements to the output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_ulong_array (int[] seq, int offset, int length);

    
Writes the array of IDL unsigned long longs (represented as Java longs)
from offset for length elements to the output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL unsigned long longs (represented as Java longs)
    * from offset for length elements to the output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_ulonglong_array (long[] seq, int offset, int length);

    
Writes the array of IDL long longs from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL long longs from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_longlong_array (long[] seq, int offset, int length);

    
Writes the array of IDL floats from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL floats from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_float_array (float[] seq, int offset, int length);

    
Writes the array of IDL doubles from offset for length elements to the
output stream.
Params:
seq – The array to be written.
offset – The index into seq of the first element to write to the
output stream.
length – The number of elements to write to the output stream./**
    * Writes the array of IDL doubles from offset for length elements to the
    * output stream.
    * @param seq The array to be written.
    * @param offset The index into seq of the first element to write to the
    * output stream.
    * @param length The number of elements to write to the output stream.
    */
    void write_double_array (double[] seq, int offset, int length);
} // interface DataOutputStream