SCTextException.h

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

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

#import <scl/SCException.h>
#import <scl/SCStream.h>

#pragma mark -
#pragma mark Class Constants

#define SCTextExceptionCalss    @"SCTextException"
#define SCTextErrorName         @"SCText"

#pragma mark -
#pragma mark Error ID Contants

#define SCTextEIDUnspecified    @"SCL-20060"        
#define SCTextEIDSource         @"SCL-20061"        
#define SCTextEIDInputStream    @"SCL-20062"        
#define SCTextEIDReadOnly       @"SCL-20063"        
#define SCTextEIDEmptyString    @"SCL-20064"        
#define SCTextEIDClosedStream   @"SCL-20065"        
#define SCTextEIDUnsupported    @"SCL-20066"        
#define SCTextEIDRead           @"SCL-20067"        
#define SCTextEIDEmptyPath      @"SCL-20068"        
#define SCTextEIDDuplicated     @"SCL-20069"        
#define SCTextEIDSorter         @"SCL-20070"        
#define SCTextEIDOutputStream   @"SCL-20071"        
#define SCTextEIDIndex          @"SCL-20072"        
#define SCTextEIDRange          @"SCL-20073"        
#define SCTextEIDIndexSet       @"SCL-20074"        
#define SCTextEIDIndexesCount   @"SCL-20075"        
#define SCTextEIDIntersected    @"SCL-20076"        
#define SCTextEIDWrite          @"SCL-20077"        

#pragma mark -
#pragma mark Class Support Types

enum _SCTextError {
    SCTextErrorUnspecified              = -20060,
    SCTextErrorSource                   = -20061,
    SCTextErrorInputStream              = -20062,
    SCTextErrorReadOnly                 = -20063,
    SCTextErrorEmptyString              = -20064,
    SCTextErrorClosedStream             = -20065,
    SCTextErrorUnsupported              = -20066,
    SCTextErrorRead                     = -20067,
    SCTextErrorEmptyPath                = -20068,
    SCTextErrorDuplicated               = -20069,
    SCTextErrorSorter                   = -20070,
    SCTextErrorOutputStream             = -20071,
    SCTextErrorIndex                    = -20072,
    SCTextErrorRange                    = -20073,
    SCTextErrorIndexSet                 = -20074,
    SCTextErrorIndexesCount             = -20075,
    SCTextErrorIntersected              = -20076,
    SCTextErrorWrite                    = -20077,
};

typedef enum _SCTextError SCTextError;

@interface SCTextException : SCException {
    NSString    *fTextName;     // Erroneous text name
    NSString    *fString;       // Incorrect string
    SCIndex      fIndex;        // Incorrect index
    NSIndexSet  *fIndexSet;     // Incorrect index set
    NSString    *fUnsupported;  // Name of unsupported class
    SCULong      fIndexesCount; // Number of indexes
    SCULong      fStringsCount; // Number of strings
    NSRange      fRange;        // Incorrect range of strings
    NSRange      fIntersected;  // Intersected range
    SCStream    *fStream;       // Erroneous stream
}
@property (nonatomic, retain, readonly, getter=textName) NSString *textName;

@property (nonatomic, retain, readonly, getter=string) NSString *string;

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

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

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

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

@property (nonatomic, assign, readonly, getter=stringsCount) SCULong stringsCount;

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

@property (nonatomic, assign, readonly, getter=intersected) NSRange intersected;

@property (nonatomic, assign, readonly, getter=stream) SCStream *stream;

#pragma mark -
#pragma mark Accessing Instance Properties
- (NSString *)textName;
- (NSString *)string;
- (SCIndex)index;
- (NSIndexSet *)indexSet;
- (NSString *)unsupported;
- (SCULong)indexesCount;
- (SCULong)stringsCount;
- (NSRange)range;
- (NSRange)intersected;
- (SCStream *)stream;

#pragma mark -
#pragma mark Creating and Initializing the Generic Text Exceptions (SCL-20060)
+ (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;
- (instancetype)initWithName:(NSString *)name;
- (instancetype)init;

#pragma mark -
#pragma mark Creating and Initializing Source Exception (SCL-20061)
+ (instancetype)sourceExceptionWithName:(NSString *)name;
+ (instancetype)sourceException;
- (instancetype)initSourceExceptionWithName:(NSString *)name;
- (instancetype)initSourceException;

#pragma mark -
#pragma mark Creating and Initializing Incorrect Input Stream Exception (SCL-20062)
+ (instancetype)exceptionWithInputStream:(SCStream *)stream name:(NSString *)name;
+ (instancetype)exceptionWithInputStream:(SCStream *)stream;
- (instancetype)initWithInputStream:(SCStream *)stream name:(NSString *)name;
- (instancetype)initWithInputStream:(SCStream *)stream;

#pragma mark -
#pragma mark Creating and Initialzing Read Only Exception (SCL-20063)
+ (instancetype)readOnlyExceptionWithName:(NSString *)name;
+ (instancetype)readOnlyException;
- (instancetype)initReadOnlyWithName:(NSString *)name;
- (instancetype)initReadOnly;

#pragma mark -
#pragma mark Creating and Initializing Empty String Exceptions (SCL-20064)
+ (instancetype)emptyStringExceptionWithName:(NSString *)name;
+ (instancetype)emptyStringException;
- (instancetype)initEmptyStringWithName:(NSString *)name;
- (instancetype)initEmptyString;

#pragma mark -
#pragma mark Creating and Initializing Closed Stream Exception (SCL-20065)
+ (instancetype)exceptionWithClosedStream:(SCStream *)stream name:(NSString *)name;
+ (instancetype)exceptionWithClosedStream:(SCStream *)stream;
- (instancetype)initWithClosedStream:(SCStream *)stream name:(NSString *)name;
- (instancetype)initWithClosedStream:(SCStream *)stream;

#pragma mark -
#pragma mark Creating and Initializing Unsupported Class Exception (SCL-20066)
+ (instancetype)exceptionWithUnsupported:(NSString *)unsupported name:(NSString *)name;
+ (instancetype)exceptionWithUnsupported:(NSString *)unsupported;
- (instancetype)initWithUnsupported:(NSString *)unsupported name:(NSString *)name;
- (instancetype)initWithUnsupported:(NSString *)unsupported;

#pragma mark -
#pragma mark Creating and Initializing Reading Error Exception (SCL-20067)
+ (instancetype)readErrorExceptionWithStream:(SCStream *)stream name:(NSString *)name;
+ (instancetype)readErrorExceptionWithStream:(SCStream *)stream;
- (instancetype)initReadErrorWithStream:(SCStream *)stream name:(NSString *)name;
- (instancetype)initReadErrorWithStream:(SCStream *)stream;

#pragma mark -
#pragma mark Creating and Initializing Empty Path Exception (SCL-20068)
+ (instancetype)emptyPathExceptionWithName:(NSString *)name;
+ (instancetype)emptyPathException;
- (instancetype)initEmptyPathExceptionWithName:(NSString *)name;
- (instancetype)initEmptyPathException;

#pragma mark -
#pragma mark Creating and Initializing String Unique Violation Exception (SCL-20069)
+ (instancetype)duplicateExceptionWithName:(NSString *)name string:(NSString *)string index:(SCIndex)index;
+ (instancetype)duplicateExceptionWithString:(NSString *)string index:(SCIndex)index;
- (instancetype)initDuplicateWithName:(NSString *)name string:(NSString *)string index:(SCIndex)index;
- (instancetype)initDuplicateWithString:(NSString *)string index:(SCIndex)index;

#pragma mark -
#pragma mark Creating and Initializing Incorrect Sorter Exception (SCL-20070)
+ (instancetype)sorterExceptionWithName:(NSString *)name;
+ (instancetype)sorterException;
- (instancetype)initSorterExceptionWithName:(NSString *)name;
- (instancetype)initSorterException;

#pragma mark -
#pragma mark Creating and Initializing Incorrect Output Stream Exception (SCL-20071)
+ (instancetype)exceptionWithOutputStream:(SCStream *)stream name:(NSString *)name;
+ (instancetype)exceptionWithOutputStream:(SCStream *)stream;
- (instancetype)initWithOutputStream:(SCStream *)stream name:(NSString *)name;
- (instancetype)initWithOutputStream:(SCStream *)stream;

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

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

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

#pragma mark -
#pragma mark Creating and Initializing Indexes and Strings Count Exception (SCL-20075)
+ (instancetype)exceptionWithIndexesCount:(SCULong)icount stringsCount:(SCULong)scount name:(NSString *)name;
+ (instancetype)exceptionWithIndexesCount:(SCULong)icount stringsCount:(SCULong)scount;
- (instancetype)initWithIndexesCount:(SCULong)icount stringsCount:(SCULong)scount name:(NSString *)name;
- (instancetype)initWithIndexesCount:(SCULong)icount stringsCount:(SCULong)scount;

#pragma mark -
#pragma mark Creating and Initializing Intersected Ranges Exception (SCL-20076)
+ (instancetype)exceptionWithRange:(NSRange)range intersected:(NSRange)intersected name:(NSString *)name;
+ (instancetype)exceptionWithRange:(NSRange)range intersected:(NSRange)intersected;
- (instancetype)initWithRange:(NSRange)range intersected:(NSRange)intersected name:(NSString *)name;
- (instancetype)initWithRange:(NSRange)range intersected:(NSRange)intersected;

#pragma mark -
#pragma mark Creating and Initializing Writing Exception (SCL-20077)
+ (instancetype)writeErrorExceptionWithStream:(SCStream *)stream name:(NSString *)name;
+ (instancetype)writeErrorExceptionWithStream:(SCStream *)stream;
- (instancetype)initWriteErrorWithStream:(SCStream *)stream name:(NSString *)name;
- (instancetype)initWriteErrorWithStream:(SCStream *)stream;

@end