Chomp/CHOMPEnumeratorTrampoline.h

   1 //
   2 //  CHOMPEnumeratorTrampoline.h
   3 //  Chomp
   4 //
   5 //  Created by Michael Ash on 12/15/04.
   6 //
   7
   8 #import <Foundation/Foundation.h>
   9
  10 #import "CHOMPTrampoline.h"
  11
  12
  13 // This class provides a framework for HOM enumeration constructs.
  14
  15 @interface CHOMPEnumeratorTrampoline : CHOMPTrampoline {
  16         BOOL iterate;
  17 }
  18
  19 + trampolineWithSelector:(SEL)sel collection:cln iterate:(BOOL)iter;
  20
  21 - initWithSelector:(SEL)sel collection:cln iterate:(BOOL)iter;
  22
  23 - (void)iterateWithInvocation:(NSInvocation *)invocation;
  24
  25 // the following methods allow subclasses to add additional behavior
  26
  27 // allows subclasses to perform setup for an iteration session
  28 // the default implementation does nothing
  29 - (void)prepareWithInvocation:(NSInvocation *)invocation;
  30
  31 // send the invocation to the given target
  32 // the default implementation simply invokes the invocation; if a subclass
  33 // overrides this, it must either invoke the invocation itself, or call
  34 // super to do it
  35 - (void)sendInvocation:(NSInvocation *)invocation toTarget:obj;
  36
  37 // allows subclasses to do something with the return values from the method calls
  38 // this will only be called if the method actually returns an object
  39 // the default implementation does nothing
  40 - (void)processReturnValue:retVal;
  41
  42 // allows subclasses to provide a custom return value for the entire HOM
  43 // this will only be called if the method actually returns an object
  44 // the default implementation returns nil
  45 - getReturnValue;
  46
  47 // allows subclasses to perform a takedown for an iteration session
  48 // the default implementation does nothing
  49 - (void)finalizeWithInvocation:(NSInvocation *)invocation;
  50
  51 @end