ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/group/trunk/OOPSE-2.0/src/utils/next_combination.hpp
(Generate patch)

Comparing trunk/OOPSE-2.0/src/utils/next_combination.hpp (file contents):
Revision 1679 by tim, Thu Oct 28 21:28:04 2004 UTC vs.
Revision 1682 by tim, Thu Oct 28 22:34:01 2004 UTC

# Line 24 | Line 24
24   */
25  
26   /**
27 < * @file GenerateCombination.hpp
27 > * @file next_combination.hpp
28   * @author    tlin
29   * @date  10/27/2004
30   * @version 1.0
# Line 80 | Line 80 | bool next_combination(IteratorContainer<RandomAccessIt
80          iterContainer.insert(iterContainer.end(), first);
81          return true;
82      } else if (*(--i) != endIter){
83 <        //if the last iterator in iterContainer does not reaches the end, just increment it
83 >        //if the last iterator in iterContainer does not reaches the end, just increase its iterator by 1
84          ++(*i);
85          return true;
86      } else {// the last iterator in iterContainer does not reaches the end
87  
88          //starts at the end of the sequence and works its way towards the front, looking for two
89          //consecutive members of the sequence where the difference between them is greater
90 <        //than one. For example , if the sequence contains 1, 5, 8, 9 (total number is 10, begin
91 <        //index is 0, therefore 9 is the end index, and the current size is 4). At the end of while
90 >        //than one. For example , if the sequence contains 1, 5, 8, 9 (total number is 10, first is 0
91 >        //and the last is 10 (due to STL's half open range)). At the end of while
92          //loop, j will point to 5, and i will point to 8, next combination should be 1, 6, 7, 8.
93          //If j is less than zero, it means it already reaches the last combination of current size.
94          //For instance, sequence may contain 6, 7, 8, 9 at this time, we need to increase the size
# Line 133 | Line 133 | bool next_combination(IteratorContainer<RandomAccessIt
133   /**
134   * @brief iteratively replace the sequence with wild cards
135   * @return true if more combination sequence is avaliable, otherwise return true
136 < * @param cont iterator container, if expect whole series of combination, just pass an empty iterator
137 < * container. The user should not modify the iterator container
136 > * @param cont iterator container, if expect the whole series of combinations,  pass an empty iterator
137 > * container. The user should not modify this iterator container
138   * @param sequence the whole sequence used to generate combination
139   * @param result a possible combination sequence which is set on return
140 < * @wildCard the wild card string. Its value is "X" by default
140 > * @param wildCard the wild card string. Its value is "X" by default
141   * @note since next_combination never returns an empty sequence, replaceWildCard will not generate
142   * one special combination, which is n identical wild cards (n is equal to the size of the passing sequence)
143   *
# Line 163 | Line 163 | bool next_combination(IteratorContainer<RandomAccessIt
163   * //H X N
164   * //X C N
165   * //H C N
166 < @endcode
166 > * @endcode
167   */
168   bool replaceWildCard(std::vector<std::vector<std::string>::iterator>& cont,
169                                               std::vector<std::string>& sequence, std::vector<std::string>& result,
# Line 184 | Line 184 | bool replaceWildCard(std::vector<std::vector<std::stri
184  
185       return hasMoreCombination;
186      
187 < }
187 > }//end replaceWildCard
188  
189   } //end namespace oopse
190   #endif //UTILS_NEXT_COMBINATION_HPP

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines