package org.omg.DynamicAny;


/**
* org/omg/DynamicAny/DynValueOperations.java .
* Generated by the IDL-to-Java compiler (portable), version "3.2"
* from /var/lib/jenkins/jobs/openjdk/jobs/openjdk9/workspace/jdk9/corba/src/java.corba/share/classes/org/omg/DynamicAny/DynamicAny.idl
* Sunday, February 14, 2021 4:59:56 PM UTC
*/


DynValue objects support the manipulation of IDL non-boxed value types.
The DynValue interface can represent both null and non-null value types.
For a DynValue representing a non-null value type, the DynValue's components comprise
the public and private members of the value type, including those inherited from concrete base value types,
in the order of definition. A DynValue representing a null value type has no components
and a current position of -1.
Warning: Indiscriminantly changing the contents of private value type members can cause the value type
implementation to break by violating internal constraints. Access to private members is provided to support
such activities as ORB bridging and debugging and should not be used to arbitrarily violate
the encapsulation of the value type. 
/**
    * DynValue objects support the manipulation of IDL non-boxed value types.
    * The DynValue interface can represent both null and non-null value types.
    * For a DynValue representing a non-null value type, the DynValue's components comprise
    * the public and private members of the value type, including those inherited from concrete base value types,
    * in the order of definition. A DynValue representing a null value type has no components
    * and a current position of -1.
    * <P>Warning: Indiscriminantly changing the contents of private value type members can cause the value type
    * implementation to break by violating internal constraints. Access to private members is provided to support
    * such activities as ORB bridging and debugging and should not be used to arbitrarily violate
    * the encapsulation of the value type. 
    */
public interface DynValueOperations  extends org.omg.DynamicAny.DynValueCommonOperations
{

  
Returns the name of the member at the current position.
This operation may return an empty string since the TypeCode of the value being
manipulated may not contain the names of members.
Throws:
TypeMismatch – if the DynValue represents a null value type.
InvalidValue – if the current position does not indicate a member/**
          * Returns the name of the member at the current position.
          * This operation may return an empty string since the TypeCode of the value being
          * manipulated may not contain the names of members.
          *
          * @exception TypeMismatch if the DynValue represents a null value type.
          * @exception InvalidValue if the current position does not indicate a member
          */
  String current_member_name () throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;

  
Returns the TCKind associated with the member at the current position.
Throws:
TypeMismatch – if the DynValue represents a null value type.
InvalidValue – if the current position does not indicate a member/**
          * Returns the TCKind associated with the member at the current position.
          *
          * @exception TypeMismatch if the DynValue represents a null value type.
          * @exception InvalidValue if the current position does not indicate a member
          */
  org.omg.CORBA.TCKind current_member_kind () throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;

  
Returns a sequence of NameValuePairs describing the name and the value of each member
in the value type.
The sequence contains members in the same order as the declaration order of members
as indicated by the DynValue's TypeCode. The current position is not affected.
The member names in the returned sequence will be empty strings if the DynValue's TypeCode
does not contain member names.
Throws:
InvalidValue – if this object represents a null value type/**
          * Returns a sequence of NameValuePairs describing the name and the value of each member
          * in the value type.
          * The sequence contains members in the same order as the declaration order of members
          * as indicated by the DynValue's TypeCode. The current position is not affected.
          * The member names in the returned sequence will be empty strings if the DynValue's TypeCode
          * does not contain member names.
          *
          * @exception InvalidValue if this object represents a null value type
          */
  org.omg.DynamicAny.NameValuePair[] get_members () throws org.omg.DynamicAny.DynAnyPackage.InvalidValue;

  
Initializes the value type's members from a sequence of NameValuePairs.
The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
if an empty sequence is passed, the current position is set to -1.
A null value type can be initialized to a non-null value type using this method.
Members must appear in the NameValuePairs in the order in which they appear in the IDL specification
of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
The operation makes no attempt to assign member values based on member names.
Throws:
TypeMismatch – if the member names supplied in the passed sequence do not match the
           corresponding member name in the DynValue's TypeCode and they are not empty strings
InvalidValue – if the passed sequence has a number of elements that disagrees
           with the number of members as indicated by the DynValue's TypeCode/**
          * Initializes the value type's members from a sequence of NameValuePairs.
          * The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
          * if an empty sequence is passed, the current position is set to -1.
          * A null value type can be initialized to a non-null value type using this method.
          * <P>Members must appear in the NameValuePairs in the order in which they appear in the IDL specification
          * of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
          * The operation makes no attempt to assign member values based on member names.
          *
          * @exception TypeMismatch if the member names supplied in the passed sequence do not match the
          *            corresponding member name in the DynValue's TypeCode and they are not empty strings
          * @exception InvalidValue if the passed sequence has a number of elements that disagrees
          *            with the number of members as indicated by the DynValue's TypeCode
          */
  void set_members (org.omg.DynamicAny.NameValuePair[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;

  
Returns a sequence of NameDynAnyPairs describing the name and the value of each member
in the value type.
The sequence contains members in the same order as the declaration order of members
as indicated by the DynValue's TypeCode. The current position is not affected.
The member names in the returned sequence will be empty strings if the DynValue's TypeCode
does not contain member names.
Throws:
InvalidValue – if this object represents a null value type/**
          * Returns a sequence of NameDynAnyPairs describing the name and the value of each member
          * in the value type.
          * The sequence contains members in the same order as the declaration order of members
          * as indicated by the DynValue's TypeCode. The current position is not affected.
          * The member names in the returned sequence will be empty strings if the DynValue's TypeCode
          * does not contain member names.
          *
          * @exception InvalidValue if this object represents a null value type
          */
  org.omg.DynamicAny.NameDynAnyPair[] get_members_as_dyn_any () throws org.omg.DynamicAny.DynAnyPackage.InvalidValue;

  
Initializes the value type's members from a sequence of NameDynAnyPairs.
The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
if an empty sequence is passed, the current position is set to -1.
A null value type can be initialized to a non-null value type using this method.
Members must appear in the NameDynAnyPairs in the order in which they appear in the IDL specification
of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
The operation makes no attempt to assign member values based on member names.
Throws:
TypeMismatch – if the member names supplied in the passed sequence do not match the
           corresponding member name in the DynValue's TypeCode and they are not empty strings
InvalidValue – if the passed sequence has a number of elements that disagrees
           with the number of members as indicated by the DynValue's TypeCode/**
          * Initializes the value type's members from a sequence of NameDynAnyPairs.
          * The operation sets the current position to zero if the passed sequences has non-zero length. Otherwise,
          * if an empty sequence is passed, the current position is set to -1.
          * A null value type can be initialized to a non-null value type using this method.
          * <P>Members must appear in the NameDynAnyPairs in the order in which they appear in the IDL specification
          * of the value type as indicated by the DynValue's TypeCode or they must be empty strings.
          * The operation makes no attempt to assign member values based on member names.
          *
          * @exception TypeMismatch if the member names supplied in the passed sequence do not match the
          *            corresponding member name in the DynValue's TypeCode and they are not empty strings
          * @exception InvalidValue if the passed sequence has a number of elements that disagrees
          *            with the number of members as indicated by the DynValue's TypeCode
          */
  void set_members_as_dyn_any (org.omg.DynamicAny.NameDynAnyPair[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch, org.omg.DynamicAny.DynAnyPackage.InvalidValue;
} // interface DynValueOperations