SCNSArray.h

Go to the documentation of this file.

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

#import <Foundation/Foundation.h>
#import <scl/SCTypes.h>
#import <scl/SCCollectionProtocol.h>

#define NSArrayClass @"NSArray" ///< NSArray class name

@interface NSArray(SCNSArray) <SCDictionaryObjectProtocol, SCStreamProtocol, SCCollectionProtocol>
#pragma mark -
#pragma mark Category properties
#if (__MAC_OS_X_VERSION_MIN_REQUIRED > 1040) || IOS_TARGET
// Instance class name property
@property (retain, readonly, getter=className) NSString *className;
#endif

#pragma mark -
#pragma mark Creating and Initializing Array

+ (NSArray *)arrayWithContentsOfSerializedFile:(NSString *)path;

+ (NSArray *)arrayWithDataDictionary:(NSDictionary *)dictionary;

+ (NSArray *)arrayWithDataDictionaryFromFile:(NSString *)path;

+ (NSArray *)arrayWithCoder:(NSCoder *)coder;

+ (NSArray *)arrayWithStream:(SCStream *)stream;

+ (NSArray *)arrayWithFileStream:(NSString *)path;

+ (NSArray *)arraySortedAscendingWithArray:(NSArray *)array
                                                           usingMethod:(id<SCSortingProtocol>)method;

+ (NSArray *)arraySortedDescendingWithArray:(NSArray *)array
                                                                usingMethod:(id<SCSortingProtocol>)method;

+ (NSArray *)arraySortedWithArray:(NSArray *)array usingMethod:(id<SCSortingProtocol>)method;

+ (NSArray *)arraySortedAscendingWithArray:(NSArray *)array;

+ (NSArray *)arraySortedDescendingWithArray:(NSArray *)array;

+ (NSArray *)arraySortedWithArray:(NSArray *)array;

- (id)initWithContentsOfSerializedFile:(NSString *)path;

- (id)initWithDataDictionary:(NSDictionary *)dictionary;

- (id)initWithDataDictionaryFromFile:(NSString *)path;

- (id)initWithStream:(SCStream *)stream;

- (id)initWithFileStream:(NSString *)path;

- (id)initSortedAscendingWithArray:(NSArray *)array usingMethod:(id<SCSortingProtocol>)method;

- (id)initSortedDescendingWithArray:(NSArray *)array usingMethod:(id<SCSortingProtocol>)method;

- (id)initSortedWithArray:(NSArray *)array usingMethod:(id<SCSortingProtocol>)method;

- (id)initSortedAscendingWithArray:(NSArray *)array;

- (id)initSortedDescendingWithArray:(NSArray *)array;

- (id)initSortedWithArray:(NSArray *)array;

#pragma mark -
#pragma mark Supporting Data Dictionaries

- (void)writeToDataDictionary:(NSMutableDictionary *)dictionary;

- (void)writeToDataDictionaryFile:(NSString *)path atomically:(BOOL)atomically;

- (void)writeToDataDictionaryFile:(NSString *)path;

- (NSDictionary *)dataDictionary;

#pragma mark -
#pragma mark Supporting Coders and Serialized Files

- (BOOL)writeContentsToSerializedFile:(NSString *)path;

#pragma mark -
#pragma mark Supporting Collections

- (id<SCCollectionProtocol>)copyObject;

- (SCComparisonResult)compareWithObject:(id<SCCollectionProtocol>)object;

#pragma mark -
#pragma mark Supporting Streams

- (void)writeToStream:(SCStream *)stream;

- (void)writeToFileStream:(NSString *)path;

- (void)appendToFileStream:(NSString *)path;

#pragma mark -
#pragma mark Other Methods

- (NSString *)className;

#pragma mark -
#pragma mark Detecting Collection Type

- (BOOL)isCollection;

- (BOOL)isLibraryCollection;

- (BOOL)isFoundationCollection;

- (BOOL)isArray;

- (BOOL)isLibraryArray;

- (BOOL)isFoundationArray;

- (BOOL)isSet;

- (BOOL)isLibrarySet;

- (BOOL)isFoundationSet;

- (BOOL)isOrderedSet;

- (BOOL)isLibraryOrderedSet;

- (BOOL)isFoundationOrderedSet;

- (BOOL)isDictionary;

- (BOOL)isLibraryDictionary;

- (BOOL)isFoundationDictionary;

- (BOOL)isStack;

- (BOOL)isQueue;

- (BOOL)isList;

- (BOOL)isSortable;

#pragma mark -
#pragma mark Sorting Array

- (NSArray *)sortedArrayAscendingWithMethod:(id<SCSortingProtocol>)method;

- (NSArray *)sortedArrayDescendingWithMethod:(id<SCSortingProtocol>)method;

- (NSArray *)sortedArrayWithMethod:(id<SCSortingProtocol>)method;

- (NSArray *)sortedArrayAscending;

- (NSArray *)sortedArrayDescending;

- (NSArray *)sortedArray;

@end