-
- All Superinterfaces:
- DynAnyOperations
- All Known Subinterfaces:
- DynUnion
- All Known Implementing Classes:
- _DynUnionStub
public interface DynUnionOperations extends DynAnyOperations
DynUnion objects support the manipulation of IDL unions. A union can have only two valid current positions:- zero, which denotes the discriminator
- one, which denotes the active member
-
-
Method Summary
Methods Modifier and Type Method and Description TCKind
discriminator_kind()
Returns the TCKind value of the discriminators TypeCode.DynAny
get_discriminator()
Returns the current discriminator value.boolean
has_no_active_member()
Returns true if the union has no active member, that is, the unions value consists solely of its discriminator because the discriminator has a value that is not listed as an explicit case label.TCKind
member_kind()
Returns the TCKind value of the currently active members TypeCode.String
member_name()
Returns the name of the currently active member.DynAny
member()
Returns the currently active member.void
set_discriminator(DynAny d)
Sets the discriminator of the DynUnion to the specified value.void
set_to_default_member()
Sets the discriminator to a value that is consistent with the value of the default case of a union.void
set_to_no_active_member()
Sets the discriminator to a value that does not correspond to any of the unions case labels.-
Methods inherited from interface org.omg.DynamicAny.DynAnyOperations
assign, component_count, copy, current_component, destroy, equal, from_any, get_any, get_boolean, get_char, get_double, get_dyn_any, get_float, get_long, get_longlong, get_octet, get_reference, get_short, get_string, get_typecode, get_ulong, get_ulonglong, get_ushort, get_val, get_wchar, get_wstring, insert_any, insert_boolean, insert_char, insert_double, insert_dyn_any, insert_float, insert_long, insert_longlong, insert_octet, insert_reference, insert_short, insert_string, insert_typecode, insert_ulong, insert_ulonglong, insert_ushort, insert_val, insert_wchar, insert_wstring, next, rewind, seek, to_any, type
-
-
-
-
Method Detail
-
get_discriminator
DynAny get_discriminator()
Returns the current discriminator value.
-
set_discriminator
void set_discriminator(DynAny d) throws TypeMismatch
Sets the discriminator of the DynUnion to the specified value. Setting the discriminator to a value that is consistent with the currently active union member does not affect the currently active member. Setting the discriminator to a value that is inconsistent with the currently active member deactivates the member and activates the member that is consistent with the new discriminator value (if there is a member for that value) by initializing the member to its default value. Setting the discriminator of a union sets the current position to 0 if the discriminator value indicates a non-existent union member (has_no_active_member returns true in this case). Otherwise, if the discriminator value indicates a named union member, the current position is set to 1 (has_no_active_member returns false and component_count returns 2 in this case).- Throws:
TypeMismatch
- if the TypeCode of the parameter is not equivalent to the TypeCode of the union's discriminator
-
set_to_default_member
void set_to_default_member() throws TypeMismatch
Sets the discriminator to a value that is consistent with the value of the default case of a union. It sets the current position to zero and causes component_count to return 2.- Throws:
TypeMismatch
- if the union does not have an explicit default case
-
set_to_no_active_member
void set_to_no_active_member() throws TypeMismatch
Sets the discriminator to a value that does not correspond to any of the unions case labels. It sets the current position to zero and causes component_count to return 1.- Throws:
TypeMismatch
- if the union has an explicit default case or if it uses the entire range of discriminator values for explicit case labels
-
has_no_active_member
boolean has_no_active_member()
Returns true if the union has no active member, that is, the unions value consists solely of its discriminator because the discriminator has a value that is not listed as an explicit case label. Calling this operation on a union that has a default case returns false. Calling this operation on a union that uses the entire range of discriminator values for explicit case labels returns false.
-
discriminator_kind
TCKind discriminator_kind()
Returns the TCKind value of the discriminators TypeCode.
-
member_kind
TCKind member_kind() throws InvalidValue
Returns the TCKind value of the currently active members TypeCode.- Throws:
InvalidValue
- if the union does not have a currently active member
-
member
DynAny member() throws InvalidValue
Returns the currently active member. Note that the returned reference remains valid only for as long as the currently active member does not change. Using the returned reference beyond the life time of the currently active member raises OBJECT_NOT_EXIST.- Throws:
InvalidValue
- if the union has no active member
-
member_name
String member_name() throws InvalidValue
Returns the name of the currently active member. If the unions TypeCode does not contain a member name for the currently active member, the operation returns an empty string.- Throws:
InvalidValue
- if the union has no active member
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-org/omg/dynamicany/dynunionoperations.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.