237 // TODO: set-like map operations (union, intersect, difference) |
237 // TODO: set-like map operations (union, intersect, difference) |
238 |
238 |
239 /** |
239 /** |
240 * Creates a value iterator for a map. |
240 * Creates a value iterator for a map. |
241 * |
241 * |
242 * \note An iterator iterates over all elements successively. Therefore the order |
242 * \note An iterator iterates over all elements successively. Therefore, the order |
243 * highly depends on the map implementation and may change arbitrarily when the contents change. |
243 * highly depends on the map implementation and may change arbitrarily when the contents change. |
244 * |
244 * |
245 * @param map the map to create the iterator for |
245 * @param map the map to create the iterator for |
246 * @return an iterator for the currently stored values |
246 * @return an iterator for the currently stored values |
247 */ |
247 */ |
254 /** |
254 /** |
255 * Creates a key iterator for a map. |
255 * Creates a key iterator for a map. |
256 * |
256 * |
257 * The elements of the iterator are keys of type CxHashKey. |
257 * The elements of the iterator are keys of type CxHashKey. |
258 * |
258 * |
259 * \note An iterator iterates over all elements successively. Therefore the order |
259 * \note An iterator iterates over all elements successively. Therefore, the order |
260 * highly depends on the map implementation and may change arbitrarily when the contents change. |
260 * highly depends on the map implementation and may change arbitrarily when the contents change. |
261 * |
261 * |
262 * @param map the map to create the iterator for |
262 * @param map the map to create the iterator for |
263 * @return an iterator for the currently stored keys |
263 * @return an iterator for the currently stored keys |
264 */ |
264 */ |
271 /** |
271 /** |
272 * Creates an iterator for a map. |
272 * Creates an iterator for a map. |
273 * |
273 * |
274 * The elements of the iterator are key/value pairs of type CxMapEntry. |
274 * The elements of the iterator are key/value pairs of type CxMapEntry. |
275 * |
275 * |
276 * \note An iterator iterates over all elements successively. Therefore the order |
276 * \note An iterator iterates over all elements successively. Therefore, the order |
277 * highly depends on the map implementation and may change arbitrarily when the contents change. |
277 * highly depends on the map implementation and may change arbitrarily when the contents change. |
278 * |
278 * |
279 * @param map the map to create the iterator for |
279 * @param map the map to create the iterator for |
280 * @return an iterator for the currently stored entries |
280 * @return an iterator for the currently stored entries |
281 * @see cxMapIteratorKeys() |
281 * @see cxMapIteratorKeys() |
289 |
289 |
290 |
290 |
291 /** |
291 /** |
292 * Creates a mutating iterator over the values of a map. |
292 * Creates a mutating iterator over the values of a map. |
293 * |
293 * |
294 * \note An iterator iterates over all elements successively. Therefore the order |
294 * \note An iterator iterates over all elements successively. Therefore, the order |
295 * highly depends on the map implementation and may change arbitrarily when the contents change. |
295 * highly depends on the map implementation and may change arbitrarily when the contents change. |
296 * |
296 * |
297 * @param map the map to create the iterator for |
297 * @param map the map to create the iterator for |
298 * @return an iterator for the currently stored values |
298 * @return an iterator for the currently stored values |
299 */ |
299 */ |
304 /** |
304 /** |
305 * Creates a mutating iterator over the keys of a map. |
305 * Creates a mutating iterator over the keys of a map. |
306 * |
306 * |
307 * The elements of the iterator are keys of type CxHashKey. |
307 * The elements of the iterator are keys of type CxHashKey. |
308 * |
308 * |
309 * \note An iterator iterates over all elements successively. Therefore the order |
309 * \note An iterator iterates over all elements successively. Therefore, the order |
310 * highly depends on the map implementation and may change arbitrarily when the contents change. |
310 * highly depends on the map implementation and may change arbitrarily when the contents change. |
311 * |
311 * |
312 * @param map the map to create the iterator for |
312 * @param map the map to create the iterator for |
313 * @return an iterator for the currently stored keys |
313 * @return an iterator for the currently stored keys |
314 */ |
314 */ |
319 /** |
319 /** |
320 * Creates a mutating iterator for a map. |
320 * Creates a mutating iterator for a map. |
321 * |
321 * |
322 * The elements of the iterator are key/value pairs of type CxMapEntry. |
322 * The elements of the iterator are key/value pairs of type CxMapEntry. |
323 * |
323 * |
324 * \note An iterator iterates over all elements successively. Therefore the order |
324 * \note An iterator iterates over all elements successively. Therefore, the order |
325 * highly depends on the map implementation and may change arbitrarily when the contents change. |
325 * highly depends on the map implementation and may change arbitrarily when the contents change. |
326 * |
326 * |
327 * @param map the map to create the iterator for |
327 * @param map the map to create the iterator for |
328 * @return an iterator for the currently stored entries |
328 * @return an iterator for the currently stored entries |
329 * @see cxMapMutIteratorKeys() |
329 * @see cxMapMutIteratorKeys() |