Up

GSCategories documentation

Authors

Richard Frith-Macdonald (rfm@gnu.org)

Copyright: (C) 2003 Free Software Foundation, Inc.


Contents -

  1. Software documentation for the NSArray(GSCompatibility) category
  2. Software documentation for the NSAttributedString(GSCategories) category
  3. Software documentation for the NSBundle(GSCompatibility) category
  4. Software documentation for the NSCalendarDate(GSCategories) category
  5. Software documentation for the NSData(GSCategories) category
  6. Software documentation for the NSDistantObject(GSCompatibility) category
  7. Software documentation for the NSFileHandle(GSCompatibility) category
  8. Software documentation for the NSInvocation(GSCompatibility) category
  9. Software documentation for the NSLock(GSCategories) category
  10. Software documentation for the NSLock(GSCompatibility) category
  11. Software documentation for the NSMutableString(GSCategories) category
  12. Software documentation for the NSNumber(GSCategories) category
  13. Software documentation for the NSObject(GSCategories) category
  14. Software documentation for the NSObject(GSCompatibility) informal protocol
  15. Software documentation for the NSProcessInfo(GSCompatibility) category
  16. Software documentation for the NSRecursiveLock(GSCategories) category
  17. Software documentation for the NSRecursiveLock(GSCompatibility) category
  18. Software documentation for the NSString(GSCategories) category
  19. Software documentation for the NSString(GSCompatibility) category

Software documentation for the NSArray(GSCompatibility) category

NSArray(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

initWithArray: copyItems: 

- (id) initWithArray: (NSArray*)array copyItems: (BOOL)shouldCopy;
Availability: OpenStep

Description forthcoming.

insertionPosition: usingFunction: context: 

- (unsigned) insertionPosition: (id)item usingFunction: (NSComparisonResult(*)(id,id,void*))sorter context: (void*)context;
Availability: OpenStep

Description forthcoming.

insertionPosition: usingSelector: 

- (unsigned) insertionPosition: (id)item usingSelector: (SEL)comp;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSAttributedString(GSCategories) category

NSAttributedString(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

attributedSubstringWithRange: 

- (NSAttributedString*) attributedSubstringWithRange: (NSRange)aRange;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSBundle(GSCompatibility) category

NSBundle(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

pathForLibraryResource: ofType: inDirectory: 

+ (NSString*) pathForLibraryResource: (NSString*)name ofType: (NSString*)ext inDirectory: (NSString*)bundlePath;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSCalendarDate(GSCategories) category

NSCalendarDate(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Extension methods for the NSCalendarDate class
Method summary

weekOfYear 

- (int) weekOfYear;
Availability: OpenStep

The ISO standard week of the year is based on the first week of the year being that week (starting on monday) for which the thursday is on or after the first of january.
This has the effect that, if january first is a friday, saturday or sunday, the days of that week (up to and including the sunday) are considered to be in week 53 of the preceding year. Similarly if the last day of the year is a monday tuesday or wednesday, these days are part of week 1 of the next year.

Software documentation for the NSData(GSCategories) category

NSData(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Extension methods for the NSData class.
Method summary

hexadecimalRepresentation 

- (NSString*) hexadecimalRepresentation;
Availability: OpenStep

Returns an NSString object containing an ASCII hexadecimal representation of the receiver. This means that the returned object will contain exactly twice as many characters as there are bytes as the receiver, as each byte in the receiver is represented by two hexadecimal digits.
The high order four bits of each byte is encoded before the low order four bits. Capital letters 'A' to 'F' are used to represent values from 10 to 15.
If you need the hexadecimal representation as raw byte data, use code like -
   hexData = [[sourceData hexadecimalRepresentation]     dataUsingEncoding: NSASCIIStringEncoding]; 

initWithHexadecimalRepresentation: 

- (id) initWithHexadecimalRepresentation: (NSString*)string;
Availability: OpenStep

Initialises the receiver with the supplied string data which contains a hexadecimal coding of the bytes. The parsing of the string is fairly tolerant, ignoring whitespace and permitting both upper and lower case hexadecimal digits (the -hexadecimalRepresentation method produces a string using only uppercase digits with no white space).
If the string does not contain one or more pairs of hexadecimal digits then an exception is raised.

md5Digest 

- (NSData*) md5Digest;
Availability: OpenStep

Creates an MD5 digest of the information stored in the receiver and returns it as an autoreleased 16 byte NSData object.
If you need to produce a digest of string information, you need to decide what character encoding is to be used and convert your string to a data object of that encoding type first using the [NSString -dataUsingEncoding:] method -
   myDigest = [[myString dataUsingEncoding: NSUTF8StringEncoding] md5Digest]; 
If you need to use the digest in a human readable form, you will probably want it to be seen as 32 hexadecimal digits, and can do that using the -hexadecimalRepresentation method.

uudecodeInto: name: mode: 

- (BOOL) uudecodeInto: (NSMutableData*)decoded name: (NSString**)namePtr mode: (int*)modePtr;
Availability: OpenStep

Decodes the source data from uuencoded and return the result.
Returns the encoded file name in namePtr if it is not null. Returns the encoded file mode in modePtr if it is not null.

uuencodeInto: name: mode: 

- (BOOL) uuencodeInto: (NSMutableData*)encoded name: (NSString*)name mode: (int)mode;
Availability: OpenStep

Encode the source data to uuencoded.
Uses the supplied name as the filename in the encoded data, and says that the file mode is as specified.
If no name is supplied, uses untitled as the name.

Software documentation for the NSDistantObject(GSCompatibility) category

NSDistantObject(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

setDebug: 

+ (void) setDebug: (int)val;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSFileHandle(GSCompatibility) category

NSFileHandle(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

fileHandleAsServerAtAddress: service: protocol: 

+ (id) fileHandleAsServerAtAddress: (NSString*)address service: (NSString*)service protocol: (NSString*)protocol;
Availability: OpenStep

Description forthcoming.

socketAddress 

- (NSString*) socketAddress;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSInvocation(GSCompatibility) category

NSInvocation(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

initWithArgframe: selector: 

- (id) initWithArgframe: (arglist_t)args selector: (SEL)selector;
Availability: OpenStep

Description forthcoming.

returnFrame: 

- (retval_t) returnFrame: (arglist_t)args;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSLock(GSCategories) category

NSLock(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

newLockAt: 

+ (id) newLockAt: (id*)location;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSLock(GSCompatibility) category

NSLock(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

gcFinalize 

- (void) gcFinalize;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSMutableString(GSCategories) category

NSMutableString(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

GNUstep specific (non-standard) additions to the NSMutableString class.
Method summary

deletePrefix: 

- (void) deletePrefix: (NSString*)prefix;
Availability: OpenStep

Removes the specified prefix from the string. Raises an exception if the prefix is not present.

deleteSuffix: 

- (void) deleteSuffix: (NSString*)suffix;
Availability: OpenStep

Removes the specified suffix from the string. Raises an exception if the suffix is not present.

replaceString: withString: 

- (void) replaceString: (NSString*)replace withString: (NSString*)by;
Availability: OpenStep

Replaces all occurrences of the string replace with the string by in the receiver.
Has no effect if replace does not occur within the receiver. NB. an empty string is not considered to exist within the receiver.
Calls - replaceOccurrencesOfString:withString:options:range: passing zero for the options and a range from 0 with the length of the receiver. Note that is has to work for [tmp replaceString: @"&" withString: @"&"];

trimLeadSpaces 

- (void) trimLeadSpaces;
Availability: OpenStep

Removes all leading white space from the receiver.

trimSpaces 

- (void) trimSpaces;
Availability: OpenStep

Removes all leading or trailing white space from the receiver.

trimTailSpaces 

- (void) trimTailSpaces;
Availability: OpenStep

Removes all trailing white space from the receiver.

Software documentation for the NSNumber(GSCategories) category

NSNumber(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

GNUstep specific (non-standard) additions to the NSNumber class.
Method summary

valueFromString: 

+ (NSValue*) valueFromString: (NSString*)string;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSObject(GSCategories) category

NSObject(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Extension methods for the NSObject class
Method summary

compare: 

- (NSComparisonResult) compare: (id)anObject;
Availability: OpenStep

WARNING: The -compare: method for NSObject is deprecated due to subclasses declaring the same selector with conflicting signatures. Comparison of arbitrary objects is not just meaningless but also dangerous as most concrete implementations expect comparable objects as arguments often accessing instance variables directly. This method will be removed in a future release.

notImplemented: 

- (id) notImplemented: (SEL)aSel;
Availability: OpenStep

Description forthcoming.

shouldNotImplement: 

- (id) shouldNotImplement: (SEL)aSel;
Availability: OpenStep

Description forthcoming.

subclassResponsibility: 

- (id) subclassResponsibility: (SEL)aSel;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSObject(GSCompatibility) informal protocol

NSObject(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

notImplemented: 

+ (id) notImplemented: (SEL)selector;
Availability: OpenStep

Description forthcoming.

isInstance 

- (BOOL) isInstance;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSProcessInfo(GSCompatibility) category

NSProcessInfo(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

debugSet 

- (NSMutableSet*) debugSet;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSRecursiveLock(GSCategories) category

NSRecursiveLock(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

newLockAt: 

+ (id) newLockAt: (id*)location;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSRecursiveLock(GSCompatibility) category

NSRecursiveLock(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

gcFinalize 

- (void) gcFinalize;
Availability: OpenStep

Description forthcoming.

Software documentation for the NSString(GSCategories) category

NSString(GSCategories)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

GNUstep specific (non-standard) additions to the NSString class.
Method summary

stringWithFormat: arguments: 

+ (id) stringWithFormat: (NSString*)format arguments: (va_list)argList;
Availability: OpenStep

Returns an autoreleased string initialized with -initWithFormat:arguments: .

stringByDeletingPrefix: 

- (NSString*) stringByDeletingPrefix: (NSString*)prefix;
Availability: OpenStep

Returns a string formed by removing the prefix string from the receiver. Raises an exception if the prefix is not present.

stringByDeletingSuffix: 

- (NSString*) stringByDeletingSuffix: (NSString*)suffix;
Availability: OpenStep

Returns a string formed by removing the suffix string from the receiver. Raises an exception if the suffix is not present.

stringByReplacingString: withString: 

- (NSString*) stringByReplacingString: (NSString*)replace withString: (NSString*)by;
Availability: OpenStep

Returns a string in which any (and all) occurrences of replace in the receiver have been replaced with by. Returns the receiver if replace does not occur within the receiver. NB. an empty string is not considered to exist within the receiver.

stringByTrimmingLeadSpaces 

- (NSString*) stringByTrimmingLeadSpaces;
Availability: OpenStep

Returns a string formed by removing leading white space from the receiver.

stringByTrimmingSpaces 

- (NSString*) stringByTrimmingSpaces;
Availability: OpenStep

Returns a string formed by removing both leading and trailing white space from the receiver.

stringByTrimmingTailSpaces 

- (NSString*) stringByTrimmingTailSpaces;
Availability: OpenStep

Returns a string formed by removing trailing white space from the receiver.

Software documentation for the NSString(GSCompatibility) category

NSString(GSCompatibility)

Declared in:
GNUstepBase/GSCategories.h
Availability: OpenStep

Description forthcoming.
Method summary

boolValue 

- (BOOL) boolValue;
Availability: OpenStep

Description forthcoming.

substringFromRange: 

- (NSString*) substringFromRange: (NSRange)range;
Availability: OpenStep

Description forthcoming.


Up