SCNSMutableArray.h

Go to the documentation of this file.

//
//  SCMutableArrayNSMutableArray.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>
#import <scl/SCSortingProtocol.h>

#define NSMutableArrayClass @"NSMutableArray" ///< NSMutableArray class name

@interface NSMutableArray(SCNSMutableArray) <SCStreamProtocol, SCCollectionProtocol,
                                             SCDictionaryObjectProtocol>
#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 Class Instance

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#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

- (void)sortingArrayAscendingWithMethod:(id<SCSortingProtocol>)method;

- (void)sortingArrayDescendingWithMethod:(id<SCSortingProtocol>)method;

- (void)sortingArrayWithMethod:(id<SCSortingProtocol>)method;

- (void)sortingArrayAscending;

- (void)sortingArrayDescending;

- (void)sortingArray;

@end