star/container/XMap.idl

3  * Licensed to the Apache Software Foundation (ASF) under one
7  * to you under the Apache License, Version 2.0 (the
13  * Unless required by applicable law or agreed to in writing,
41     <p>Keys in the map are unique, and each key maps to exactly one value.</p>
45 …two values are said to be equal if and only if they have the same type, and both denote the same e…
56         <p>Implementations are free to accept any supertype of <code>KeyType</code> as keys.</p>
62 …   <p>Implementations are free to accept any supertype of the <code>ValueType</code> as values.</p>
77             is the key whose presence in the map is to be tested.
84             if the given key is not supported to be put into the map. It's up to the service
85             implementing the <code>XMap</code> interface to specify which special values are not
86             supported. For instances, implementations might decide to not allow <VOID/> keys, or
87             to reject <code>Double.NaN</code> (<em>not a number</em>) to due its problematic
88             behavior with respect to equality.
94     /** determines whether the map contains a mapping to a given value.
97             is the value whose presence in the map is to be tested.
99             <TRUE/> if and only one or more keys map to the given value.
102             if the given value is not of a type which is accepted by the map. It's up to the service
103             implementing the <code>XMap</code> interface to specify which special values are not
104 …        supported. For instances, implementations might decide to not allow <code>Double.NaN</code>
105             (<em>not a number</em>) to due its problematic behavior with respect to equality.
107             if the given value is not supported to be put into the map.
113     /** gets the value to which a given key maps.
116             they key whose associated value is to be returned.
123             if the given key is not supported to be put into the map. It's up to the service
124             implementing the <code>XMap</code> interface to specify which special values are not
125             supported. For instances, implementations might decide to not allow <VOID/> keys, or
126             to reject <code>Double.NaN</code> (<em>not a number</em>) to due its problematic
127             behavior with respect to equality.
152 …          if the given key, or the given value, is not supported to be put into the map. It's up to
153             the service implementing the <code>XMap</code> interface to specify which special values
155             For instances, implementations might decide to not allow <VOID/> keys or values, or to
156             reject <code>Double.NaN</code> (<em>not a number</em>) to due its problematic behavior
157             with respect to equality.
176             if the given key is not supported to be put into the map. It's up to the service
177             implementing the <code>XMap</code> interface to specify which special values are not
178             supported. For instances, implementations might decide to not allow <VOID/> keys, or
179             to reject <code>Double.NaN</code> (<em>not a number</em>) to due its problematic
180             behavior with respect to equality.