SCCollectionException.h

Go to the documentation of this file.

//
//  SCCollectionException.h
//  scl
//
//  Created by Viacheslav Smolensky on 12.04.12.
//  Copyright (c) 2007 - 2018 by Samond Development Corporation. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <scl/SCCollectionProtocols.h>
#import <scl/SCException.h>

#pragma mark -
#pragma mark Class Constants

#define SCCollectionExceptionClass      @"SCCollectionException"

#define SCCollectionErrorName           @"SCCollection"


#pragma mark -
#pragma mark Error ID Contants

#define SCCollectionEIDUnspecified      @"SCL-20040"

#define SCCollectionEIDSource           @"SCL-20041"

#define SCCollectionEIDType             @"SCL-20042"

#define SCCollectionEIDReadOnly         @"SCL-20043"

#define SCCollectionEIDItem             @"SCL-20044"

#define SCCollectionEIDObject           @"SCL-20045"

#define SCCollectionEIDUnsupported      @"SCL-20046"

#define SCCollectionEIDUnknown          @"SCL-20047"

#define SCCollectionEIDNotComparable    @"SCL-20048"

#define SCCollectionEIDNotSortable      @"SCL-20049"

#define SCCollectionEIDSorter           @"SCL-20050"

#define SCCollectionEIDIndex            @"SCL-20052"

#define SCCollectionEIDRange            @"SCL-20053"

#define SCCollectionEIDIndexSet         @"SCL-20054"

#define SCCollectionEIDIndexSetCount    @"SCL-20055"

#define SCCollectionEIDKey              @"SCL-20056"

#define SCCollectionEIDKeysCount        @"SCL-20057"

#define SCCollectionEIDValue            @"SCL-20058"


#pragma mark -
#pragma mark Class Support Types

typedef enum {
    SCCollectionErrorUnspecified        = -20040,
    
    SCCollectionErrorSource             = -20041,
    
    SCCollectionErrorType               = -20042,
    
    SCCollectionErrorReadOnly           = -20043,
    
    SCCollectionErrorItem               = -20044,
    
    SCCollectionErrorObject             = -20045,

    SCCollectionErrorUnsupported        = -20046,
    
    SCCollectionErrorUnknown            = -20047,
    
    SCCollectionErrorNotComparable      = -20048,
    
    SCCollectionErrorNotSortable        = -20049,
    
    SCCollectionErrorSorter             = -20050,
    
    SCCollectionErrorIndex              = -20052,
    
    SCCollectionErrorRange              = -20053,
    
    SCCollectionErrorIndexSet           = -20054,
    
    SCCollectionErrorIndexSetCount      = -20055,
    
    SCCollectionErrorKey                = -20056,
    
    SCCollectionErrorKeysCount          = -20057,
    
    SCCollectionErrorValue              = -20058,

} SCCollectionError;


#pragma mark -

@interface SCCollectionException : SCException {
    NSString    *_collectionName;   // Collection name
    NSString    *_typeName;         // Name of the unsupported collection type
    NSString    *_unsupported;      // Unsupported class name
    NSString    *_unknown;          // Unknown clas name
    SCIndex      _index;            // Incorrect index
    NSRange      _range;            // Incorrect reange of the objects
    NSIndexSet  *_indexSet;         // Incorrect index set
    SCULong      _indexesCount;     // Number of the indexes
    SCULong      _objectsCount;     // Number of the objects
    NSString    *_key;              // Incorrect object key
    SCULong      _keysCount;        // Number of the keys
}
#pragma mark -
#pragma mark Instance Properties

@property (nonatomic, readonly, retain) NSString *collectionName;

@property (nonatomic, readonly, retain) NSString *typeName;

@property (nonatomic, readonly, retain) NSString *unsupported;

@property (nonatomic, readonly, retain) NSString *unknown;

@property (nonatomic, readonly, assign) SCIndex index;

@property (nonatomic, readonly, assign) NSRange range;

@property (nonatomic, readonly, retain) NSIndexSet *indexSet;

@property (nonatomic, readonly, assign) SCULong indexesCount;

@property (nonatomic, readonly, assign) SCULong objectsCount;

@property (nonatomic, readonly, retain) NSString *key;

@property (nonatomic, readonly, assign) SCULong keysCount;

#pragma mark -
#pragma mark Creating and Initializing the Generic Collection Exceptions
+ (instancetype)exceptionWithName:(NSString *)name reason:(NSString *)reason code:(SCInteger)code eid:(NSString *)eid;
+ (instancetype)exceptionWithReason:(NSString *)reason code:(SCInteger)code eid:(NSString *)eid;
+ (instancetype)exceptionWithName:(NSString *)name;
+ (instancetype)exception;
- (instancetype)initWithName:(NSString *)name reason:(NSString *)reason code:(SCInteger)code eid:(NSString *)eid;
- (instancetype)initWithReason:(NSString *)reason code:(SCInteger)code eid:(NSString *)eid;

#pragma mark -
#pragma mark Creating Source Exception (SCL-20041)
+ (instancetype)exceptionWithSource;

#pragma mark -
#pragma mark Creating Unsupported Collection Type Exception (SCL-20042)
+ (instancetype)exceptionWithUnsupportedType:(NSString *)type;

#pragma mark -
#pragma mark Creating Read Only Exception (SCL-20043)
+ (instancetype)exceptionWithReadOnlyType:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithReadOnlyType:(NSString *)type;

#pragma mark -
#pragma mark Creating Null Object Exception (SCL-20044)
+ (instancetype)exceptionWithItemType:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithItemType:(NSString *)type;

#pragma mark -
#pragma mark Creating Source Object Exception (SCL-20045)
+ (instancetype)exceptionWithObject;

#pragma mark -
#pragma mark Creating Unsupported Class Exception (SCL-20046)
+ (instancetype)exceptionWithUnsupported:(NSString *)cname type:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithUnsupported:(NSString *)cname type:(NSString *)type;

#pragma mark -
#pragma mark Creating Unknown Class Exception (SCL-20047)
+ (instancetype)exceptionWithUnknown:(NSString *)cname type:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithUnknown:(NSString *)cname type:(NSString *)type;

#pragma mark -
#pragma mark Creating Incomparable Object Exception (SCL-20048)
+ (instancetype)exceptionWithNotComparableType:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithNotComparableType:(NSString *)type;

#pragma mark -
#pragma mark Creating Unsortable Collection Exception (SCL-20049)
+ (instancetype)exceptionWithNotSortableType:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithNotSortableType:(NSString *)type;

#pragma mark -
#pragma mark Creating Incorrect Sorter Exception (SCL-20050)
+ (instancetype)exceptionWithSorterType:(NSString *)type name:(NSString *)name;
+ (instancetype)exceptionWithSorterType:(NSString *)type;

#pragma mark -
#pragma mark Creating Incorrect Index Exception (SCL-20052)
+ (instancetype)exceptionWithIndex:(SCIndex)index name:(NSString *)name;
+ (instancetype)exceptionWithIndex:(SCIndex)index;

#pragma mark -
#pragma mark Creating Incorrect Range Exception (SCL-20053)
+ (instancetype)exceptionWithRange:(NSRange)range name:(NSString *)name;
+ (instancetype)exceptionWithRange:(NSRange)range;

#pragma mark -
#pragma mark Creating Incorrect Index Set Exception (SCL-20054)
+ (instancetype)exceptionWithIndexSet:(NSIndexSet *)indexSet name:(NSString *)name;
+ (instancetype)exceptionWithIndexSet:(NSIndexSet *)indexSet;

#pragma mark -
#pragma mark Creating Indexes and Objects Count Exception (SCL-20055)
+ (instancetype)exceptionWithIndexesCount:(SCULong)indexes objectsCount:(SCULong)objects;

#pragma mark -
#pragma mark Creating Incorrect Key Exception (SCL-20056)
+ (instancetype)exceptionWithKey:(NSString *)key name:(NSString *)name;
+ (instancetype)exceptionWithKey:(NSString *)key;

#pragma mark -
#pragma mark Creating Keys and Objects Count Exception (SCL-20057)
+ (instancetype)exceptionWithKeysCount:(SCULong)keys objectsCount:(SCULong)objects;

#pragma mark -
#pragma mark Creating Empty Value Exception (SCL-20058)
+ (instancetype)exceptionValueForKey:(NSString *)key name:(NSString *)name;
+ (instancetype)exceptionValueForKey:(NSString *)key;

@end