This is NSByteStoreFile.rtf in view mode; [Download] [Up]
paperh18648 margl-907 margr0 margt0 margb0 fi0 ri0 ql sb0 f1 fs24 Copyright f3 'e3f1 1994 by NeXT Computer, Inc. All Rights Reserved.
s4 li100 fi0 ri1007 ql f0 b fs36 fs100
fs36 NSByteStoreFile
pard s11 li2872 fi-2771 ri1007 ql tx2872 f1 b0 fs28 fs48
fs28 f0 b fs24 Inherits From:tab b0 fs28 f1 NSByteStore : NSObject
fs20
fs28 s6 f0 b fs24 Conforms To:tab b0 fs28 f1 NSObject (NSObject)
fs20
fs28 s7 f0 b fs24 Declared In:tab b0 fs28 f1 Foundation/NSByteStore.h
fs20
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs28 fs20
fs28 Class Description
fs14
fs28 pard s1 li477 fi0 ri1007 ql tx2494 tx2872 tx3250 f1 b0 fs2
fs28 NSByteStoreFile is a subclass of NSByteStore that keeps its storage in a file. NSByteStoreFile guarantees the integrity of stored data against process and system crashes when protected by transactions (described in the NSByteStore class specification), provided that the physical media remains intact.
fs16
fs28 When you create an NSByteStoreFile, you specify a storage file and open it for reading only or for both reading and writing. The methods you use to access the contents of the file are implemented in NSByteStore.
fs16
fs28 To support the use of preconfigured files, a process using an NSByteStoreFile opened for reading only may freely modify the NSByteStoreFile; all modified pages are reflected only in the address space of the process. The modifications are never written to the file and are discarded when the NSByteStoreFile is freed.
fs16
fs28 pard s16 li100 fi0 ri1007 ql f0 b fs24
fs28 Creating and Initializing an NSByteStoreFile Instance
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 + (NSByteStore *)b byteStoreFile:b0 (NSString*)i pathi0 tab Creates and initializes an NSByteStoreFile with i pathi0 as its
s9 li7030 fi-6553 fi-5796 b transactionsEnabled:b0 (BOOL)i enablei0 tab tab storage file. If i enablei0 is YES, transactions are enabled.
b create:b0 (BOOL)i create tab tab i0 If i createi0 is YES, the file i pathi0 is created. If i readOnlyi0 is
b readOnly:b0 (BOOL)i readOnlytab tab i0 YES, i pathi0 is opened for reading. If i readOnlyi0 is NO, path is opened for reading and writing.
s8 li7029 fi-5794 fi-6552 fs16
fs28 fi-6552 {f3 -} (id)b initWithPath:b0 (NSString*)i pathi0 tab Initializes a newly allocated NSByteStoreFile with i pathi0 as
s9 li7030 fi-6553 fi-5796 b transactionsEnabled:b0 (BOOL)i enablei0 tab tab its storage file. If i enablei0 is YES, transactions are
b create:b0 (BOOL)i create tab tab i0 enabled. If i createi0 is YES, the file i pathi0 is created. If
b readOnly:b0 (BOOL)i readOnlytab tab readOnlyi0 is YES, i pathi0 is opened for reading. If i readOnlyi0 is NO, path is opened for reading and writing.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Accessing the Storage File
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (NSString *)b storePathb0 tab Returns the path of the storage file.
pard s16 li100 fi0 ri1007 ql f0 b fs48
fs28 Reducing Memory Consumption
fs14
fs28 pard s8 li7029 fi-6552 ri1007 ql tx6652 tx7030 f1 b0 fs2
fs28 fi-6552 {f3 -} (void)b compactUntilDate:b0 (NSDate *)i limitDatei0 tab Removes free space by relocating blocks toward the origin of the virtual address space defined by the NSByteStoreFile. i limitDatei0 sets a time limit on this operation. No i limitDatei0 allows the compaction to run to completion.
}These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.