Improvements to mappings controller. Move array munging into a separate category...

[enjoyable.git] / Categories / NSMutableArray+MoveObject.h

diff --git a/Categories/NSMutableArray+MoveObject.h b/Categories/NSMutableArray+MoveObject.h
index c1c60d2..ce62234 100644 (file)
--- a/Categories/NSMutableArray+MoveObject.h
+++ b/Categories/NSMutableArray+MoveObject.h
@@ -11,5 +11,24 @@
 @interface NSMutableArray (MoveObject)
 
 - (void)moveObjectAtIndex:(NSUInteger)src toIndex:(NSUInteger)dst;
+    // Move the object at index src to (pre-move) index dst. Other
+    // objects shift up or down as necessary to make room, as in
+    // insertObject:atIndex:. Because the object is also removed from
+    // the source index, its resulting index may be one less than dst.
+
+- (BOOL)moveFirstwards:(id)object upTo:(NSUInteger)minIndex;
+- (BOOL)moveLastwards:(id)object upTo:(NSUInteger)maxIndex;
+    // Move an object one step towards the first or last position in
+    // the array, up to a minimum or maximum index. Returns YES if the
+    // array changed; NO if the object was not in the array or was
+    // already at the minimum/maximum index.
+
+- (BOOL)moveFirstwards:(id)object;
+- (BOOL)moveLastwards:(id)object;
+    // Move an object towards the first or last position in the array.
+    // Returns YES if the array changed; NO if the object was not in
+    // the array or if the object was already in the first/last
+    // position.
+
 
 @end