# NSDebug utilities reference

richard@brainstorm.co.uk
n.pero@mi.flashnet.it
Generated at 2025-02-13 06:02:40 +0000
1997,1999,2000,2001 Free Software Foundation, Inc.
Software documentation for the GSLogDelegate protocol
Foundation/NSDebug.h
NSObject
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.
getBytes:
bytes
ofLength:
length
byHandle:
handle
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:
bytes
ofLength:
length
byHandle:
handle
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.