TransformIterator


1   // ============================================================================
2   // $Id: TransformIterator.java,v 1.8 2006/05/22 03:36:36 davidahall Exp $
3   // Copyright (c) 2002-2005  David A. Hall
4   // ============================================================================
5   // The contents of this file are subject to the Common Development and
6   // Distribution License (CDDL), Version 1.0 (the License); you may not use this 
7   // file except in compliance with the License.  You should have received a copy
8   // of the the License along with this file: if not, a copy of the License is 
9   // available from Sun Microsystems, Inc.
10  //
11  // http://www.sun.com/cddl/cddl.html
12  //
13  // From time to time, the license steward (initially Sun Microsystems, Inc.) may
14  // publish revised and/or new versions of the License.  You may not use,  
15  // distribute, or otherwise make this file available under subsequent versions 
16  // of the License.
17  // 
18  // Alternatively, the contents of this file may be used under the terms of the 
19  // GNU Lesser General Public License Version 2.1 or later (the "LGPL"), in which
20  // case the provisions of the LGPL are applicable instead of those above. If you 
21  // wish to allow use of your version of this file only under the terms of the 
22  // LGPL, and not to allow others to use your version of this file under the 
23  // terms of the CDDL, indicate your decision by deleting the provisions above 
24  // and replace them with the notice and other provisions required by the LGPL. 
25  // If you do not delete the provisions above, a recipient may use your version 
26  // of this file under the terms of either the CDDL or the LGPL.
27  // 
28  // This library is distributed in the hope that it will be useful,
29  // but WITHOUT ANY WARRANTY; without even the implied warranty of
30  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
31  // ============================================================================
32  
33  package net.sf.jga.util;
34  
35  import java.util.Iterator  ;
36  import net.sf.jga.algorithms.Transform;
37  import net.sf.jga.fn.UnaryFunctor;
38  
39  /**
40   * Iterator that returns the results of applying the given functor to the
41   * elements of the given iterator.
42   * Note -- in addition to this class being deprecated in order to be moved,
43   * its implementation of Iterable<T> is also deprecated: the successor class
44   * will not implement Iterable<T>.
45   * <p>
46   * Copyright &copy; 2002-2005  David A. Hall
47   *
48   * @author <a HREF="mailto:davidahall@users.sourceforge.net">David A. Hall</a>
49   * @deprecated moved to within Transform class: use Transform.TransformIterator
50   **/
51  
52  public class TransformIterator<T,R> extends Transform.TransformIterator<T,R> implements Iterable  <R> {
53  
54      /**
55       * Builds a TransformIterator that applies the given functor to each element
56       * of the given base iterator.
57       */
58      public TransformIterator(Iterator  <? extends T> iter, UnaryFunctor<T,R> fn) {
59          super(iter, fn);
60      }
61  
62      // - - - - - - - - - - - -
63      // Iterable implementation
64      // - - - - - - - - - - - -
65      
66      /**
67       * @deprecated the successor class will not implement Iterable<T>
68       */
69      public Iterator  <R> iterator() { return this; }
70  }
71
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags