00001 /* 00002 * Copyright (c) 2000, 2020, Oracle and/or its affiliates. 00003 * 00004 * Licensed under the Universal Permissive License v 1.0 as shown at 00005 * http://oss.oracle.com/licenses/upl. 00006 */ 00007 #ifndef COH_LIST_MUTERATOR_HPP 00008 #define COH_LIST_MUTERATOR_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/util/ListIterator.hpp" 00013 #include "coherence/util/Muterator.hpp" 00014 00015 00016 00017 COH_OPEN_NAMESPACE2(coherence,util) 00018 00019 00020 /** 00021 * Muterator is mutating iterator, that is it is capable of changing the 00022 * list it iterates. 00023 * 00024 * @author mf 2008.05.05 00025 */ 00026 class COH_EXPORT ListMuterator 00027 : public interface_spec<ListMuterator, 00028 implements<ListIterator, Muterator> > 00029 { 00030 // ----- ListMuterator interface ---------------------------------------- 00031 00032 public: 00033 /** 00034 * Insert the specified element immediately before the element to be 00035 * returned from the next call to the next() method. A subsequent call 00036 * to next() will not return the added element, while a call to 00037 * previous() would return the added element. 00038 * 00039 * @param oh the element to add 00040 * 00041 * @throws UnsupportedOperationException if addition is not supported 00042 */ 00043 virtual void add(Object::Holder oh) = 0; 00044 00045 /** 00046 * Replace the last element returned by next() or previous() with 00047 * the specified element. 00048 * 00049 * @param oh the element to store 00050 * 00051 * @throws UnsupportedOperationException if set is not supported 00052 */ 00053 virtual void set(Object::Holder oh) = 0; 00054 }; 00055 00056 COH_CLOSE_NAMESPACE2 00057 00058 #endif // COH_LIST_MUTERATOR_HPP