mirror of
https://github.com/gnustep/libs-base.git
synced 2025-05-05 14:11:00 +00:00
Initial version sent to Scott Christley.
git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@887 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Andrew McCallum
parent
dbed66c4a3
commit
64a265c2ec
1 changed files with 417 additions and 0 deletions
417
STATUS
Normal file
417
STATUS
Normal file
|
|
@ -0,0 +1,417 @@
|
|||
Key:
|
||||
[10] - complete and tested
|
||||
[8] - missing a few non-core methods, definitely usable
|
||||
[6] - missing several methods, but core is there, usable
|
||||
[4] - begun, but missing core functionality, not usable
|
||||
[2] - skeleton
|
||||
[0] - nothing there
|
||||
|
||||
Classes
|
||||
=======
|
||||
|
||||
(Many classes do not raise the proper NSExceptions yet.)
|
||||
|
||||
* NSArchiver:: [8]
|
||||
Missing class name substitution methods.
|
||||
Coder could be much more efficient and compressed by
|
||||
implementing interesting idea I had about not writing out the
|
||||
xref tags for encoded objects.
|
||||
|
||||
* NSArray:: [8]
|
||||
|
||||
* NSAssertionHandler:: [9]
|
||||
|
||||
* NSAutoreleasePool:: [9]
|
||||
But not exception- or thread-safe
|
||||
|
||||
* NSBTreeBlock:: [0]
|
||||
|
||||
* NSBTreeCursor:: [0]
|
||||
|
||||
* NSBundle:: [8]
|
||||
|
||||
* NSByteStore:: [0]
|
||||
|
||||
* NSByteStoreFile:: [0]
|
||||
|
||||
* NSCalendarDate:: [0]
|
||||
|
||||
* NSCharacterSet:: [8]
|
||||
decomposableCharacterSet and illegalCharacter set missing
|
||||
No Unicode support
|
||||
|
||||
* NSCoder:: [8]
|
||||
Missing class name substitution methods.
|
||||
|
||||
* NSConditionLock:: [0]
|
||||
|
||||
* NSConnection:: [0]
|
||||
But GNU Connection is there as a base.
|
||||
GNU Connection, however, needs:
|
||||
* to handle retain/release/dealloc properly
|
||||
* to be integrated with NSNotification's
|
||||
* to be integrated with NSRunLoop
|
||||
* to be integrated with NSInvocation
|
||||
* to be integrated with pending collection class fixes
|
||||
* to be more robust than UDP
|
||||
* Thread-safety overhaul, this is major
|
||||
|
||||
* NSCountedSet:: [8]
|
||||
|
||||
* NSData:: [8]
|
||||
|
||||
* NSDate:: [8]
|
||||
|
||||
* NSDeserializer:: [0]
|
||||
|
||||
* NSDictionary:: [8]
|
||||
|
||||
* NSDistantObject:: [0]
|
||||
But GNU Proxy is there as a base.
|
||||
See todo's for NSConnection.
|
||||
|
||||
* NSEnumerator:: [9]
|
||||
|
||||
* NSException:: [9]
|
||||
But this needs integration with new, better
|
||||
|
||||
* NSInvocation:: [3]
|
||||
|
||||
* NSLock:: [0]
|
||||
|
||||
* NSMethodSignature:: [4]
|
||||
|
||||
* NSMutableArray:: [8]
|
||||
|
||||
* NSMutableCharacterSet:: [4]
|
||||
|
||||
* NSMutableData:: [8]
|
||||
|
||||
* NSMutableDictionary:: [8]
|
||||
|
||||
* NSMutableSet:: [8]
|
||||
|
||||
* NSMutableString:: [8]
|
||||
|
||||
* NSNotification:: [0]
|
||||
But supposedly Georg has it almost finished.
|
||||
He's been saying this for months, though.
|
||||
|
||||
* NSNotificationCenter:: [0]
|
||||
See NSNotification
|
||||
|
||||
* NSNotificationQueue:: [0]
|
||||
See NSNotification
|
||||
|
||||
* NSNumber:: [9]
|
||||
|
||||
* NSObject:: [10]
|
||||
|
||||
* NSProcessInfo:: [9]
|
||||
|
||||
* NSProxy:: [0]
|
||||
But GNU Proxy is there as a base.
|
||||
See todo's for NSConnection
|
||||
|
||||
* NSRecursiveLock:: [0]
|
||||
|
||||
* NSRunLoop:: [0]
|
||||
But Allan Clearwaters is working on it
|
||||
|
||||
* NSScanner:: [0]
|
||||
|
||||
* NSSerializer:: [0]
|
||||
|
||||
* NSSet:: [8]
|
||||
|
||||
* NSString:: [8]
|
||||
Careful, relationship with GNU String is tricky; this could
|
||||
also use fixing.
|
||||
|
||||
* NSThread:: [0]
|
||||
|
||||
* NSTimeZone:: [8]
|
||||
|
||||
* NSTimeZoneDetail:: [8]
|
||||
|
||||
* NSTimer:: [0]
|
||||
|
||||
* NSUnarchiver:: [8]
|
||||
See NSArchvier
|
||||
|
||||
* NSUserDefaults:: [0]
|
||||
But I thought Georg had something for this.
|
||||
|
||||
* NSValue:: [9]
|
||||
|
||||
|
||||
Cross-Class Projects
|
||||
====================
|
||||
|
||||
* Collection classes need overhaul for
|
||||
* OpenStep compatibility
|
||||
* Getting rid of function pointers so that DO will work
|
||||
* Efficiency
|
||||
* Integrating with new NSHashtable and NSMaptable functions
|
||||
|
||||
|
||||
Protocols
|
||||
=========
|
||||
|
||||
* NSCoding:: [9]
|
||||
* NSCopying:: [9]
|
||||
* NSLocking:: [9]
|
||||
* NSMutableCopying:: [9]
|
||||
* NSObjCTypeSerializationCallBack:: [9]
|
||||
* NSObject (Protocol):: [9]
|
||||
|
||||
|
||||
Functions
|
||||
=========
|
||||
|
||||
Memory Allocation Functions
|
||||
---------------------------
|
||||
|
||||
[0] Get the Virtual Memory Page Size
|
||||
`unsigned NSPageSize (void)'
|
||||
`unsigned NSLogPageSize (void)'
|
||||
`unsigned NSRoundDownToMultipleOfPageSize (unsigned BYTECOUNT)'
|
||||
`unsigned NSRoundUpToMultipleOfPageSize (unsigned BYTECOUNT)'
|
||||
|
||||
[0] Get the Amount of Real Memory
|
||||
`unsigned NSRealMemoryAvailable (void)'
|
||||
|
||||
[0] Allocate or Free Virtual Memory
|
||||
`void *NSAllocateMemoryPages (unsigned BYTECOUNT)'
|
||||
`void NSDeallocateMemoryPages (void *POINTER, unsigned BYTECOUNT)'
|
||||
`void NSCopyMemoryPages (const void *SOURCE, void *DESTINATION, unsigned BYTECOUNT)'
|
||||
|
||||
[6] Child and Merge Zones
|
||||
void NSMergeZone(NSZone *zonep)
|
||||
NSZone *NSCreateChildZone(NSZone *parentZone, size_t startSize, size_t granularity, int canFree)
|
||||
|
||||
[9] Get a Zone
|
||||
`NSZone *NSCreateZone (unsigned STARTSIZE, unsigned GRANULARITY, BOOL CANFREE)'
|
||||
`NSZone *NSDefaultMallocZone (void)'
|
||||
`NSZone *NSZoneFromPointer (void *POINTER)'
|
||||
|
||||
[10] Allocate or Free Memory in a Zone
|
||||
`void *NSZoneMalloc (NSZone *ZONE,'
|
||||
`void *NSZoneCalloc (NSZone *ZONE, unsigned NUMELEMS, unsigned NUMBYTES)'
|
||||
`void *NSZoneRealloc (NSZone *ZONE, void *POINTER, unsigned SIZE)'
|
||||
`void NSRecycleZone (NSZone *ZONE)'
|
||||
`void NSZoneFree (NSZone *ZONE, void *POINTER)'
|
||||
|
||||
[9] Name a Zone
|
||||
But the function names are wrong
|
||||
`void NSSetZoneName (NSZone *ZONE, NSString *name)'
|
||||
`NSString *NSZoneName (NSZone *ZONE)'
|
||||
|
||||
Object Allocation Functions
|
||||
---------------------------
|
||||
|
||||
[10] Allocate or Free an Object
|
||||
`NSObject *NSAllocateObject (Class ACLASS, unsigned EXTRABYTES, NSZone *ZONE)'
|
||||
`NSObject *NSCopyObject(NSObject *ANOBJECT, unsigned EXTRABYTES, NSZone *ZONE)'
|
||||
`void NSDeallocateObject (NSObject *ANOBJECT)'
|
||||
|
||||
[9] Decide Whether to Retain an Object
|
||||
`BOOL NSShouldRetainWithZone (NSObject *ANOBJECT, NSZone *REQUESTEDZONE)'
|
||||
|
||||
[9] Modify the Number of References to an Object
|
||||
`BOOL NSDecrementExtraRefCountWasZero(id ANOBJECT)'
|
||||
`void NSIncrementExtraRefCount(id ANOBJECT)'
|
||||
|
||||
Error-Handling Functions
|
||||
------------------------
|
||||
|
||||
[9] Change the Top-level Error Handler
|
||||
``NSUncaughtException'Handler *`NSGetUncaughtException'Handler(void)'
|
||||
`void `NSSetUncaughtException'Handler(`NSUncaughtException'Handler *HANDLER)'
|
||||
|
||||
[9] Macros to Handle an Exception
|
||||
`NS_DURING'
|
||||
`NS_ENDHANDLER'
|
||||
`NS_HANDLER'
|
||||
`NS_VALUERETURN(VALUE, TYPE)'
|
||||
`NS_VOIDRETURN'
|
||||
|
||||
[9] Call the Assertion Handler from the Body of an Objective-C Method
|
||||
`NSAssert(BOOL CONDITION, NSString *DESCRIPTION)'
|
||||
`NSAssert1(BOOL CONDITION, NSString *DESCRIPTION, ARG)'
|
||||
`NSAssert2(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2)'
|
||||
`NSAssert3(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2, ARG3)'
|
||||
`NSAssert4(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2, ARG3, ARG4)'
|
||||
`NSAssert5(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2, ARG3, ARG4, ARG5)'
|
||||
|
||||
[9] Call the Assertion Handler from the Body of a C Function
|
||||
`NSCAssert(BOOL CONDITION, NSString *DESCRIPTION)'
|
||||
`NSCAssert1(BOOL CONDITION, NSString *DESCRIPTION, ARG)'
|
||||
`NSCAssert2(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2)'
|
||||
`NSCAssert3(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2, ARG3)'
|
||||
`NSCAssert4(BOOL CONDITION, NSString *DESCRIPTION, arg1, ARG2, ARG3, ARG4)'
|
||||
`NSCAssert5(BOOL CONDITION, NSString *DESCRIPTION, ARG1, ARG2, ARG3, ARG4, ARG5)'
|
||||
|
||||
[9] Validate a Parameter
|
||||
`NSParameterAssert(BOOL CONDITION)'
|
||||
`NSCParameterAssert(BOOL CONDITION)'
|
||||
|
||||
Geometric Functions
|
||||
-------------------
|
||||
|
||||
[9] Create Basic Structures
|
||||
`NSPoint NSMakePoint(float X, float Y)'
|
||||
`NSSize NSMakeSize(float W, float H)'
|
||||
`NSRect NSMakeRect(float X, float Y, float W, float H)'
|
||||
`NSRange NSMakeRange(unsigned int LOCATION, unsigned int LENGTH)'
|
||||
|
||||
[9] Get a Rectangle's Coordinates
|
||||
`float NSMaxX(NSRect ARECT)'
|
||||
`float NSMaxY(NSRect ARECT)'
|
||||
`float NSMidX(NSRect ARECT)'
|
||||
`float NSMidY(NSRect ARECT)'
|
||||
`float NSMinX(NSRect ARECT)'
|
||||
`float NSMinY(NSRect ARECT)'
|
||||
`float NSWidth(NSRect ARECT)'
|
||||
`float NSHeight(NSRect ARECT)'
|
||||
|
||||
[9] Modify a Copy of a Rectangle
|
||||
`NSRect NSInsetRect(NSRect ARECT, float DX, float DY)'
|
||||
`NSRect NSOffsetRect(NSRect ARECT, float DX, float DY)'
|
||||
`void NSDivideRect(NSRect INRECT, NSRect *SLICE, NSRect *REMAINDER, float AMOUNT, NSRectEdge EDGE)'
|
||||
`NSRect NSIntegralRect(NSRect ARECT)'
|
||||
|
||||
[9] Compute a Third Rectangle from Two Rectangles
|
||||
`NSRect NSUnionRect(NSRect ARECT, NSRect BRECT)'
|
||||
`NSRect NSIntersectionRect(NSRect ARECT, NSRect BRECT)'
|
||||
|
||||
[9] Test Geometric Relationships
|
||||
`BOOL NSEqualRects(NSRect ARECT, NSRect BRECT)'
|
||||
`BOOL NSEqualSizes(NSSize ASIZE, NSSize BSIZE)'
|
||||
`BOOL NSEqualPoints(NSPoint APOINT, NSPoint BPOINT)'
|
||||
`BOOL NSIsEmptyRect(NSRect ARECT)'
|
||||
`BOOL NSMouseInRect(NSPoint APOINT, NSRect ARECT, BOOL FLIPPED)'
|
||||
`BOOL NSPointInRect(NSPoint APOINT, NSRect ARECT)'
|
||||
`BOOL NSContainsRect(NSRect ARECT, NSRect BRECT)'
|
||||
|
||||
[0] Get a String Representation
|
||||
`NSString *NSStringFromPoint(NSPoint APOINT)'
|
||||
`NSString *NSStringFromRect(NSRect ARECT)'
|
||||
`NSString *NSStringFromSize(NSSize ASIZE)'
|
||||
|
||||
Range Functions
|
||||
---------------
|
||||
|
||||
[9] Query a Range
|
||||
`BOOL NSEqualRanges(NSRange RANGE1, NSRange RANGE2)'
|
||||
`unsigned NSMaxRange(NSRange RANGE)'
|
||||
`BOOL NSLocationInRange(unsigned LOCATION, NSRange RANGE)'
|
||||
|
||||
[9] Compute a Range from Two Other Ranges
|
||||
`NSRange NSUnionRange(NSRange RANGE1, NSRange RANGE2)'
|
||||
`NSRange NSIntersectionRange(NSRange RANGE1, NSRange RANGE2)'
|
||||
|
||||
[9] Get a String Representation
|
||||
`NSString *NSStringFromRange(NSRange RANGE)'
|
||||
|
||||
Hash Table Functions
|
||||
--------------------
|
||||
|
||||
[0]
|
||||
NSHashTable functions have been implemented by Albin Jones.
|
||||
However, integrating the code is not necessarily trivial
|
||||
|
||||
Create a Table
|
||||
`NSHashTable * NSCreateHashTable(NSHashTableCallBacks CALLBACKS, unsigned CAPACITY)'
|
||||
`NSHashTable * NSCreateHashTableWithZone(NSHashTableCallBacks CALLBACKS, unsigned CAPACITY, NSZone * ZONE)'
|
||||
`NSHashTable * NSCopyHashTableWithZone(NSHashTable * TABLE, NSZone * ZONE)'
|
||||
|
||||
Free a Table
|
||||
`void NSFreeHashTable(NSHashTable * TABLE)'
|
||||
`void NSResetHashTable(NSHashTable * TABLE)'
|
||||
|
||||
Compare Two Tables
|
||||
`BOOL NSCompareHashTables(NSHashTable * TABLE1, NSHashTable * TABLE2)'
|
||||
|
||||
Get the Number of Items
|
||||
`unsigned NSCountHashTable(NSHashTable * TABLE)'
|
||||
Returns the number of elements in TABLE.
|
||||
|
||||
Retrieve Items
|
||||
`void * NSHashGet(NSHashTable * TABLE, const void * POINTER)'
|
||||
`NSArray * NSAllHashTableObjects(NSHashTable * TABLE)'
|
||||
`NSHashEnumerator NSEnumerateHashTable(NSHashTable * TABLE)'
|
||||
`void * NSNextHashEnumeratorItem(NSHashEnumerator * ENUMERATOR)'
|
||||
|
||||
Add or Remove an Item
|
||||
`void NSHashInsert(NSHashTable * TABLE, const void * POINTER)'
|
||||
`void NSHashInsertKnownAbsent(NSHashTable * TABLE, const void * POINTER)'
|
||||
`void * NSHashInsertIfAbsent(NSHashTable * TABLE, const void * POINTER)'
|
||||
`void NSHashRemove(NSHashTable * TABLE, const void * POINTER)'
|
||||
|
||||
Get a String Representation
|
||||
`NSString * NSStringFromHashTable(NSHashTable * TABLE)'
|
||||
|
||||
Map Table Functions
|
||||
-------------------
|
||||
|
||||
[0]
|
||||
NSMapTable functions have been implemented by Albin Jones.
|
||||
However, integrating the code is not necessarily trivial
|
||||
|
||||
Create a Table
|
||||
`NSMapTable * NSCreateMapTable(NSMapTableKeyCallBacks KEYCALLBACKS, NSMapTableValueCallBacks VALUECALLBACKS, unsigned CAPACITY)'
|
||||
`NSMapTable * NSCreateMapTableWithZone(NSMapTableKeyCallBacks KEYCALLBACKS, NSMapTableValueCallBacks VALUECALLBACKS, unsigned CAPACITY,'
|
||||
`NSMapTable * NSCopyMapTableWithZone(NSMapTable * TABLE, NSZone * ZONE)'
|
||||
|
||||
Free a Table
|
||||
`void NSFreeMapTable(NSMapTable * TABLE)'
|
||||
`void NSResetMapTable(NSMapTable * TABLE)'
|
||||
|
||||
Compare Two Tables:
|
||||
`BOOL NSCompareMapTables(NSMapTable * TABLE1, NSMapTable * TABLE2)'
|
||||
|
||||
Get the Number of Items
|
||||
`unsigned NSCountMapTable(NSMapTable * TABLE)'
|
||||
|
||||
Retrieve Items
|
||||
`BOOL NSMapMember(NSMapTable * TABLE, const void * KEY, void ** ORIGINALKEY, void ** VALUE)'
|
||||
`void * NSMapGet(NSMapTable * TABLE,'
|
||||
`NSMapEnumerator NSEnumerateMapTable(NSMapTable * TABLE)'
|
||||
`BOOL NSNextMapEnumeratorPair(NSMapEnumerator * ENUMERATOR, void ** KEY, void ** VALUE)'
|
||||
`NSArray * NSAllMapTableKeys(NSMapTable * TABLE)'
|
||||
`NSArray * NSAllMapTableValues(NSMapTable * TABLE)'
|
||||
|
||||
Add or Remove an Item
|
||||
`void NSMapInsert(NSMapTable * TABLE, const void * KEY, const void * VALUE)'
|
||||
`void * NSMapInsertIfAbsent(NSMapTable * TABLE, const void * KEY, const void * VALUE)'
|
||||
`void NSMapInsertKnownAbsent(NSMapTable * TABLE, const void * KEY, const void * VALUE)'
|
||||
`void NSMapRemove(NSMapTable * TABLE,'
|
||||
`NSString *NSStringFromMapTable(NSMapTable *TABLE)'
|
||||
|
||||
Miscellaneous Functions
|
||||
-----------------------
|
||||
|
||||
[0] Get Information about a User
|
||||
`NSString *NSUserName(void)'
|
||||
`NSString *NSHomeDirectory(void)'
|
||||
`NSString *NSHomeDirectoryForUser(NSString *USERNAME)'
|
||||
|
||||
[0] Log an Error Message
|
||||
`void NSLog(NSString *format,...'
|
||||
`void NSLogv(NSString * FORMAT, va_list ARGS)'
|
||||
|
||||
[0] Get Localized Versions of Strings
|
||||
`NSString * NSLocalizedString(NSString * KEY, NSString * COMMENT)'
|
||||
`NSString * NSLocalizedStringFromTable(NSString * KEY, NSString * TABLENAME, NSString * COMMENT)'
|
||||
`NSString * NSLocalizedStringFromTableInBundle(NSString * KEY, NSString * TABLENAME, NSBundle * ABUNDLE, NSString * COMMENT)'
|
||||
|
||||
[9] Convert to and from a String
|
||||
`Class NSClassFromString(NSString *ACLASSNAME)'
|
||||
`SEL NSSelectorFromString(NSString *ASELECTORNAME)'
|
||||
`NSString *NSStringFromClass(Class ACLASS)'
|
||||
`NSString *NSStringFromSelector(SEL ASELECTOR)'
|
||||
|
||||
[0] Compose a Message To Be Sent Later to an Object
|
||||
`NSInvocation *NS_INVOCATION(Class ACLASS, INSTANCEMESSAGE)'
|
||||
`NSInvocation *NS_MESSAGE(id ANOBJECT, INSTANCEMESSAGE)'
|
||||
Loading…
Reference in a new issue