HFByteArray.h

Go to the documentation of this file.

//
//  HFByteArray.h
//  HexFiend_2
//
//  Created by Peter Ammon on 11/4/07.
//  Copyright 2007 ridiculous_fish. All rights reserved.
//

#import <Cocoa/Cocoa.h>

@class HFByteSlice, HFProgressTracker, HFFileReference;

enum
{
    HFHexDataStringType,
    HFASCIIDataStringType
};
typedef NSUInteger HFByteArrayDataStringType;

@interface HFByteArray : NSObject <NSCopying, NSMutableCopying> {
@private
    NSUInteger changeLockCounter;
    NSUInteger changeGenerationCount;
}


- (unsigned long long)length;

- (void)copyBytes:(unsigned char *)dst range:(HFRange)range;

- (NSArray *)byteSlices;

- (NSEnumerator *)byteSliceEnumerator;

- (void)insertByteSlice:(HFByteSlice *)slice inRange:(HFRange)lrange;

- (void)insertByteArray:(HFByteArray *)array inRange:(HFRange)lrange;

- (void)deleteBytesInRange:(HFRange)range;

- (HFByteArray *)subarrayWithRange:(HFRange)range;


- (void)incrementChangeLockCounter;

- (void)decrementChangeLockCounter;

- (BOOL)changesAreLocked;

/* @name Generation count
   Manipulate the generation count */
// @{
- (void)incrementGenerationOrRaiseIfLockedForSelector:(SEL)sel;

- (NSUInteger)changeGenerationCount;




- (unsigned long long)indexOfBytesEqualToBytes:(HFByteArray *)findBytes inRange:(HFRange)range searchingForwards:(BOOL)forwards trackingProgress:(HFProgressTracker *)progressTracker;

@end


@interface HFByteArray (HFFileWriting)
/* Attempts to write the receiver to a file.  This is a concrete method on HFByteArray.
   @param targetURL A URL to the file to be written to.  It is OK for the receiver to contain one or more instances of HFByteSlice that are sourced from the file.
   @param progressTracker An HFProgressTracker to allow progress reporting and cancelleation for the write operation.
   @param error An out NSError parameter.
   @return YES if the write succeeded, NO if it failed.
*/
- (BOOL)writeToFile:(NSURL *)targetURL trackingProgress:(HFProgressTracker *)progressTracker error:(NSError **)error;

- (NSArray *)rangesOfFileModifiedIfSavedToFile:(HFFileReference *)reference;

- (BOOL)clearDependenciesOnRanges:(NSArray *)ranges inFile:(HFFileReference *)reference;

@end

---