Up

NSDebug utilities reference

Authors

Richard Frith-Macdonald (richard@brainstorm.co.uk)
Nicola Pero (n.pero@mi.flashnet.it)

Date: Generated at 2023-12-20 19:35:39 -0500

Copyright: (C) 1997,1999,2000,2001 Free Software Foundation, Inc.

Software documentation for the GSLogDelegate protocol

GSLogDelegate

Declared in:
Foundation/NSDebug.h
Conforms to:
NSObject
Availability: OpenStep

Protocol for a delegate, set as an extension in some classes, to handle debug logging of low level I/O. The rationale for this protocol is that on occasion debug logging may be required, but the data being logged may contain sensitive information which should not be writtent to file. In that situation, the delegate may filter/mask the sensitive information from the logs by taking over the simpel writing to stderr that the inbuilt debug logging provides.
Method summary

getBytes: ofLength: byHandle: 

- (BOOL) getBytes: (const uint8_t*)bytes ofLength: (NSUInteger)length byHandle: (NSObject*)handle;
Availability: OpenStep

Method sent to the delegate to ask it to log a chunk of data that has been read. The delegate should return YES if it has handled the logging, NO if it wants the default mechanism to be used.
The handle is the object which is performing the read operation.

putBytes: ofLength: byHandle: 

- (BOOL) putBytes: (const uint8_t*)bytes ofLength: (NSUInteger)length byHandle: (NSObject*)handle;
Availability: OpenStep

Method sent to the delegate to ask it to log a chunk of data that has been written (or is immediately going to be written). The delegate should return YES if it has handled the logging, NO if it wants the default logging mechanism to be used.
The handle is the object which is performing the write operation.


Up