DynSequenceOperations


1   package org.omg.DynamicAny;
2   
3   
4   /**
5   * org/omg/DynamicAny/DynSequenceOperations.java .
6   * Generated by the IDL-to-Java compiler (portable), version "3.2"
7   * from ../../../../src/share/classes/org/omg/DynamicAny/DynamicAny.idl
8   * Saturday, February 9, 2008 9:40:12 AM GMT
9   */
10  
11  
12  /**
13      * DynSequence objects support the manipulation of IDL sequences.
14      */
15  public interface DynSequenceOperations  extends org.omg.DynamicAny.DynAnyOperations  
16  {
17  
18    /**
19          * Returns the current length of the sequence.
20          */
21    int get_length ();
22  
23    /**
24          * Sets the length of the sequence.
25          * Increasing the length of a sequence adds new elements at the tail without affecting the values
26          * of already existing elements. Newly added elements are default-initialized.
27          * Increasing the length of a sequence sets the current position to the first newly-added element
28          * if the previous current position was -1. Otherwise, if the previous current position was not -1,
29          * the current position is not affected.
30          * Decreasing the length of a sequence removes elements from the tail without affecting the value
31          * of those elements that remain. The new current position after decreasing the length of a sequence
32          * is determined as follows:
33          * <UL>
34          * <LI>If the length of the sequence is set to zero, the current position is set to -1.
35          * <LI>If the current position is -1 before decreasing the length, it remains at -1.
36          * <LI>If the current position indicates a valid element and that element is not removed when the length
37          *     is decreased, the current position remains unaffected.
38          * <LI>If the current position indicates a valid element and that element is removed,
39          *     the current position is set to -1.
40          * </UL>
41          *
42          * @exception InvalidValue if this is a bounded sequence and len is larger than the bound
43          */
44    void set_length (int len) throws org.omg.DynamicAny.DynAnyPackage.InvalidValue  ;
45  
46    /**
47          * Returns the elements of the sequence.
48          */
49    org.omg.CORBA.Any  [] get_elements ();
50  
51    /**
52          * Sets the elements of a sequence.
53          * The length of the DynSequence is set to the length of value. The current position is set to zero
54          * if value has non-zero length and to -1 if value is a zero-length sequence.
55          *
56          * @exception TypeMismatch if value contains one or more elements whose TypeCode is not equivalent
57          *            to the element TypeCode of the DynSequence
58          * @exception InvalidValue if the length of value exceeds the bound of a bounded sequence
59          */
60    void set_elements (org.omg.CORBA.Any  [] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch  , org.omg.DynamicAny.DynAnyPackage.InvalidValue  ;
61  
62    /**
63          * Returns the DynAnys representing the elements of the sequence.
64          */
65    org.omg.DynamicAny.DynAny  [] get_elements_as_dyn_any ();
66  
67    /**
68          * Sets the elements of a sequence using DynAnys.
69          * The length of the DynSequence is set to the length of value. The current position is set to zero
70          * if value has non-zero length and to -1 if value is a zero-length sequence.
71          *
72          * @exception TypeMismatch if value contains one or more elements whose TypeCode is not equivalent
73          *            to the element TypeCode of the DynSequence
74          * @exception InvalidValue if the length of value exceeds the bound of a bounded sequence
75          */
76    void set_elements_as_dyn_any (org.omg.DynamicAny.DynAny  [] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch  , org.omg.DynamicAny.DynAnyPackage.InvalidValue  ;
77  } // interface DynSequenceOperations
78
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags