SCStack.h

Go to the documentation of this file.

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

#import <scl/SCCollection.h>

#define SCStackClass @"SCStack" ///< SCStack class name

@interface SCStack : SCCollection {
    NSMutableArray *fStack; // Stack items array
}
#pragma mark -
#pragma mark Class properties
#if (__MAC_OS_X_VERSION_MIN_REQUIRED > 1040) || IOS_TARGET
// Stack name property
@property (retain, getter=stackName, setter=setStackName:) NSString *stackName;
#endif

#pragma mark -
#pragma mark Creating Stack

+ (SCStack *)stackWithDataDictionary:(NSDictionary *)dictionary;

+ (SCStack *)stackWithDataDictionaryFromFile:(NSString *)path;

+ (SCStack *)stackWithCoder:(NSCoder *)coder;

+ (SCStack *)stackWithContentsOfSerializedFile:(NSString *)path;

+ (SCStack *)stackWithStream:(SCStream *)stream;

+ (SCStack *)stackWithFileStream:(NSString *)path;

+ (SCStack *)stack;

+ (SCStack *)stackWithStackName:(NSString *)name capacity:(SCULong)capacity;

+ (SCStack *)stackWithStackName:(NSString *)name;

+ (SCStack *)stackWithCapacity:(SCULong)capacity;

+ (SCStack *)stackWithDelegate:(id<SCCollectionDelegate>)delegate;

+ (SCStack *)stackWithDelegate:(id<SCCollectionDelegate>)delegate collection:(id)collection;

+ (SCStack *)stackWithCollection:(id)collection;

+ (SCStack *)stackWithDelegate:(id<SCCollectionDelegate>)delegate object:(id)object;

+ (SCStack *)stackWithObject:(id)object;

+ (SCStack *)stackWithDelegate:(id<SCCollectionDelegate>)delegate objects:(id)object, ...;

+ (SCStack *)stackWithObjects:(id)object, ...;

+ (SCStack *)stackWithStack:(SCStack *)stack;

#pragma mark -
#pragma mark Initializing Stack

- (id)init;

- (id)initWithStackName:(NSString *)name capacity:(SCULong)capacity;

- (id)initWithStackName:(NSString *)name;

- (id)initWithCapacity:(SCULong)capacity;

- (id)initWithDelegate:(id<SCCollectionDelegate>)delegate;

- (id)initWithDelegate:(id<SCCollectionDelegate>)delegate collection:(id)collection;

- (id)initWithCollection:(id)collection;

- (id)initWithDelegate:(id<SCCollectionDelegate>)delegate object:(id)object;

- (id)initWithObject:(id)object;

- (id)initWithDelegate:(id<SCCollectionDelegate>)delegate objects:(id)object, ...;

- (id)initWithObjects:(id)object, ...;

- (id)initWithStack:(SCStack *)stack;

#pragma mark -
#pragma mark Querying and Setting Stack Properties

- (NSString *)stackName;

- (void)setStackName:(NSString *)name;

#pragma mark -
#pragma mark Querying Stack

- (id)lastObject;

- (NSString *)lastString;

- (NSNumber *)lastNumber;

- (SCByte)lastByte;

- (SCUByte)lastUByte;

- (SCShort)lastShort;

- (SCUShort)lastUShort;

- (SCInteger)lastInteger;

- (SCUInteger)lastUInteger;

- (SCLong)lastLong;

- (SCULong)lastULong;

- (char)lastChar;

- (unichar)lastUnichar;

- (const char *)lastCharString;

- (BOOL)lastBool;

- (SCFloat)lastFloat;

- (SCDouble)lastDouble;

#pragma mark -
#pragma mark Pushing Objects

- (void)pushObject:(id)object;

- (void)pushByte:(SCByte)byte;

- (void)pushUByte:(SCUByte)byte;

- (void)pushShort:(SCShort)shortint;

- (void)pushUShort:(SCUShort)shortint;

- (void)pushInteger:(SCInteger)integer;

- (void)pushUInteger:(SCUInteger)integer;

- (void)pushLong:(SCLong)longint;

- (void)pushULong:(SCULong)longint;

- (void)pushChar:(char)chr;

- (void)pushUnichar:(unichar)chr;

- (void)pushCharString:(const char *)string;

- (void)pushBool:(BOOL)boolean;

- (void)pushFloat:(SCFloat)flt;

- (void)pushDouble:(SCDouble)dbl;

- (void)pushObjects:(id)object, ...;

- (void)pushObjectsFromCollection:(id)collection;

#pragma mark -
#pragma mark Poping Objects

- (void)pop;

- (id)popObject;

- (NSString *)popString;

- (NSNumber *)popNumber;

- (SCByte)popByte;

- (SCUByte)popUByte;

- (SCShort)popShort;

- (SCUShort)popUShort;

- (SCInteger)popInteger;

- (SCUInteger)popUInteger;

- (SCLong)popLong;

- (SCULong)popULong;

- (char)popChar;

- (unichar)popUnichar;

- (const char *)popCharString;

- (BOOL)popBool;

- (SCFloat)popFloat;

- (SCDouble)popDouble;

#pragma mark -
#pragma mark Removing Objects

- (void)removeLastObject;

#pragma mark -
#pragma mark Copying Objects

- (void)duplicateLastObject;

@end