SCStream.h

Go to the documentation of this file.

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

#import <Foundation/Foundation.h>
#import <scl/SCTypes.h>
#import <scl/SCObject.h>
#import <scl/SCStreamException.h>
#import <scl/SCSystemException.h>
#import <scl/SCStreaming.h>

#pragma mark -
#pragma mark Константы класса

#define SCStreamClass               @"SCStream"
#define SC_STREAM_MAX_STRING_LENGTH 4096

#pragma mark -
#pragma mark Типы данных для поддержки потоков

enum _SCStreamErrorHandling {
    SCStreamErrorHandlingSystem = 1,
    
    SCStreamErrorHandlingStream = 2,
    
    SCStreamErrorHandlingStatus = 3
};

typedef enum _SCStreamErrorHandling SCStreamErrorHandling;

enum _SCStreamStatus {
    SCStreamOK                      = 0,
    
    SCStreamNotOpenError            = -20021,
    
    SCStreamReadOnlyError           = -20022,
    
    SCStreamWriteOnlyError          = -20023,
    
    SCStreamUnknownClassError       = -20024,
    
    SCStreamUnexpectedClassError    = -20025,
    
    SCStreamUnsupportedClassError   = -20026,
    
    SCStreamIncompleteReadError     = -20027,
    
    SCStreamIncompleteWriteError    = -20028,
    
    SCStreamOpenError               = -20029,
    
    SCStreamReadError               = -20030,
    
    SCStreamWriteError              = -20031,
};

typedef SCInteger SCStreamStatus;

@protocol SCStreamDelegate;

#pragma mark -

@interface SCStream : SCObject {
    SCStreamErrorHandling   fErrorHandling;     // Режим обработки ошибок
    SCStreamStatus          fStatus;            // Состяние потока
    NSString                *fName;             // Имя потока
    BOOL                    fOpened;            // Флаг открытия потока
    id                      fObject;            // Указатель на текущий загружаемый объект
    SCStreamException      *fStreamException;   // Указатель на последнюю ошибку в работе потока
    SCSystemException      *fSystemException;   // Указатель на последнюю системную ошибку
    id<SCStreamDelegate>    fDelegate;          // Объект обработки событий
    SCULong                 fTotalRead;         // Общее количество прочитанных символов
    SCULong                 fTotalWrite;        // Общее количество записанных символов
    SCULong                 fLastRead;          // Количество прочитанных символов во время последней операции чтения
    SCULong                 fLastWrite;         // Количество записанных символов во время последней операции записи
}
#pragma mark -
#pragma mark Свойства экземпляра класса

@property (nonatomic, assign, getter=errorHandling, setter=setErrorHandling:) SCStreamErrorHandling errorHandling;

@property (nonatomic, assign, readonly, getter=status) SCStreamStatus status;

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

@property (nonatomic, assign, readonly, getter=opened) BOOL opened;

@property (nonatomic, assign, readonly, getter=readable) BOOL readable;

@property (nonatomic, assign, readonly, getter=writable) BOOL writable;

@property (nonatomic, assign, readonly, getter=readOnly) BOOL readOnly;

@property (nonatomic, assign, readonly, getter=writeOnly) BOOL writeOnly;

@property (nonatomic, assign, readonly, getter=readWrite) BOOL readWrite;

@property (retain, readonly, getter=object) id object;

@property (nonatomic, assign, readonly, getter=streamException) SCStreamException *streamException;

@property (nonatomic, assign, readonly, getter=systemException) SCSystemException *systemException;

@property (nonatomic, assign, getter=delegate, setter=setDelegate:) id<SCStreamDelegate> delegate;

@property (nonatomic, assign, readonly, getter=eof) BOOL eof;

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

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

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

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

#pragma mark -
#pragma mark Доступ к свойствам экземпляра класса
- (SCStreamErrorHandling)errorHandling;
- (SCStreamStatus)status;
- (NSString *)name;
- (BOOL)opened;
- (BOOL)readable;
- (BOOL)writable;
- (BOOL)readOnly;
- (BOOL)writeOnly;
- (BOOL)readWrite;
- (id)object;
- (SCStreamException *)streamException;
- (SCSystemException *)systemException;
- (id<SCStreamDelegate>)delegate;
- (void)setErrorHandling:(SCStreamErrorHandling)mode;
- (void)setDelegate:(id<SCStreamDelegate>)delegate;

#pragma mark -
#pragma mark Инициализация потоков
- (id)init;

#pragma mark -
#pragma mark Чтение данных из потока
- (SCUSize)readBytes:(SCUSize)count toBuffer:(void *)buffer;
- (id<SCStreaming>)readObject;
- (SCByte)readByte;
- (SCUByte)readUByte;
- (SCShort)readShort;
- (SCUShort)readUShort;
- (SCInteger)readInteger;
- (SCUInteger)readUInteger;
- (SCLong)readLong;
- (SCULong)readULong;
- (char)readChar;
- (unichar)readUnichar;
- (const char *)readCharString;
- (BOOL)readBool;
- (SCFloat)readFloat;
- (SCDouble)readDouble;
- (SCUSize)readToByte:(SCByte *)buffer;
- (SCUSize)readToUByte:(SCUByte *)buffer;
- (SCUSize)readToShort:(SCShort *)buffer;
- (SCUSize)readToUShort:(SCUShort *)buffer;
- (SCUSize)readToInteger:(SCInteger *)buffer;
- (SCUSize)readToUInteger:(SCUInteger *)buffer;
- (SCUSize)readToLong:(SCULong *)buffer;
- (SCUSize)readToULong:(SCULong *)buffer;
- (SCUSize)readToChar:(char *)buffer;
- (SCUSize)readToUnichar:(unichar *)buffer;
- (SCUSize)readToCharString:(char *)buffer max:(SCUSize)max;
- (SCUSize)readToBool:(BOOL *)buffer;
- (SCUSize)readToFloat:(SCFloat *)buffer;
- (SCUSize)readToDouble:(SCDouble *)buffer;

#pragma mark -
#pragma mark Запись данных в поток
- (SCUSize)writeBytes:(SCUSize)count fromBuffer:(const void *)buffer;
- (void)writeObject:(id<SCStreaming>)object;
- (void)writeByte:(SCByte)variable;
- (void)writeUByte:(SCUByte)variable;
- (void)writeShort:(SCShort)variable;
- (void)writeUShort:(SCUShort)variable;
- (void)writeInteger:(SCInteger)variable;
- (void)writeUInteger:(SCUInteger)variable;
- (void)writeLong:(SCLong)variable;
- (void)writeULong:(SCULong)variable;
- (void)writeChar:(char)variable;
- (void)writeUnichar:(unichar)variable;
- (void)writeCharString:(const char *)variable;
- (void)writeBool:(BOOL)variable;
- (void)writeFloat:(SCFloat)variable;
- (void)writeDouble:(SCDouble)variable;

#pragma mark -
#pragma mark Поддержка текстовых файлов
- (NSString *)readStringWithEncoding:(NSStringEncoding)encoding max:(SCUInteger)max;
- (NSString *)readStringWithEncoding:(NSStringEncoding)encoding;
- (NSString *)readStringWithMax:(SCUInteger)max;
- (NSString *)readString;
- (void)writeString:(NSString *)string encoding:(NSStringEncoding)encoding;
- (void)writeString:(NSString *)string;

#pragma mark -
#pragma mark Позиционирование в потоках
- (BOOL)eof;

#pragma mark -
#pragma mark Доступ к статистическим данным
- (SCULong)totalRead;
- (SCULong)totalWrite;
- (SCULong)lastRead;
- (SCULong)lastWrite;
- (void)resetStats;

@end