SCStack.h

См. документацию.

//
//  SCStack.h
//  scl
//
//  Created by Viacheslav Smolensky on 13.04.12.
//  Copyright (c) 2007 - 2017 by Samond Development Corporation. All rights reserved.
//

#import <scl/SCCollection.h>

#pragma mark -
#pragma mark Class Constants

#define SCStackClass    @"SCStack"  


@interface SCStack : SCCollection {
    NSMutableArray *fStack; // Internal data storage
}

@property (nonatomic, retain, readonly, getter=topObject) id topObject;

#pragma mark -
#pragma mark Creating Stacks
+ (instancetype)stackWithCoder:(NSCoder *)coder;
+ (instancetype)stackWithContentsOfSerializedFile:(NSString *)path;
+ (instancetype)stackWithDataDictionary:(NSDictionary *)dictionary;
+ (instancetype)stackWithDataDictionaryFromFile:(NSString *)path;
+ (instancetype)stackWithStream:(SCStream *)stream;
+ (instancetype)stackWithFileStream:(NSString *)path;

+ (instancetype)stackWithName:(NSString *)name;
+ (instancetype)stackWithObject:(id<SCCollectioning>)object;
+ (instancetype)stackWithObjects:(id<SCCollectioning>)object, ... NS_REQUIRES_NIL_TERMINATION;
+ (instancetype)stackWithCollection:(id<SCCollection>)collection;
+ (instancetype)stackWithStack:(SCStack *)stack;
+ (instancetype)stack;

#pragma mark -
#pragma mark Initializing Stacks
- (instancetype)initWithName:(NSString *)name;
- (instancetype)initWithObject:(id<SCCollectioning>)object;
- (instancetype)initWithObjects:(id<SCCollectioning>)object, ... NS_REQUIRES_NIL_TERMINATION;
- (instancetype)initWithCollection:(id<SCCollection>)collection;
- (instancetype)initWithStack:(SCStack *)stack;
- (instancetype)init;

#pragma mark -
#pragma mark Copying Stacks
- (void)setStack:(SCStack *)stack;

#pragma mark -
#pragma mark Comparing Stacks
- (BOOL)isEqualToStack:(SCStack *)stack;
- (BOOL)isEqualToContentsOfStack:(SCStack *)stack;

#pragma mark -
#pragma mark Pushing Objects
- (void)pushObject:(id<SCCollectioning>)object;
- (void)pushObjects:(id<SCCollectioning>)object, ... NS_REQUIRES_NIL_TERMINATION;
- (void)pushCollection:(id<SCCollection>)collection;

#pragma mark -
#pragma mark Poping Objects
- (void)pop;
- (id)popObject;

#pragma mark -
#pragma mark Removing Objects
- (void)removeTopObject;

#pragma mark -
#pragma mark Copying Objects
- (void)duplicateTopObject;

#pragma mark -
#pragma mark Querying a Stack
- (id)topObject;

@end