Up
Authors
- Richard Frith-Macdonald (
rfm@gnu.org)
-
Date: Generated at 2025-02-11 22:19:38 +0100
Copyright: (C) 2003-2010 Free Software Foundation, Inc.
- Declared in:
- GNUstepBase/NSData+GNUstepBase.h
Availability: Not in OpenStep/MacOS-X
Description forthcoming.
+ (id)
dataWithRandomBytesOfLength: (
NSUInteger)length;
Availability: Not in OpenStep/MacOS-X
Returns an autoreleased data instance initialised
with pseudo-random bytes of the specified
length.
On failure returns
nil. This may be due to:
A zero
length or unreasonably large
length argument or,
Failure to
allocate memory to hold the random data or,
Failure of the underlying random data generation.
- (NSString*)
escapedRepresentation;
Availability: Not in OpenStep/MacOS-X
Returns an NSString object containing a backslash
escaped representation of the receiver.
- (char*)
escapedRepresentation: (
NSUInteger*)length;
Availability: Not in OpenStep/MacOS-X
Returns a buffer containing an ASCII backslash
escaped representation of the receiver, (and
optionally the size of the buffer excluding the
trailing nul terminator).
- (NSData*)
gunzipped;
Availability: Not in OpenStep/MacOS-X
Returns data formed by gunzipping the contents of
the receiver.
If the receiver did not contain
data produced by gzip, this method simply returns the
receiver.
If the gnuzipping failed, this
method returns nil.
Otherwise,
the returned object is an autorelease mutable data
object.
- (NSData*)
gzipped: (int)level;
Availability: Not in OpenStep/MacOS-X
Returns data formed by gzipping the contents of the
receiver using the specified compression
level (from 0 to 9 with 0 meaning no
compression and 9 meaning maximum compression).
Use a value outside the 0 to 9 range (eg -1) to employ
the default compression.
NB. It is permissable
to gzip an empty data object, and it is also permissable
to gzip a data object which already contains gzipped
data.
Returns nil on failure.
- (NSString*)
hexadecimalRepresentation;
Availability: Not in OpenStep/MacOS-X
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.
- (char*)
hexadecimalRepresentation: (
NSUInteger*)length;
Availability: Not in OpenStep/MacOS-X
Returns a buffer containing an ASCII string with a
nul terminated hexadecimal representation of the
receiver, (and optionally the size of the buffer
excluding the trailing nul terminator).
- (id)
initWithHexadecimalRepresentation: (NSString*)string;
Availability: Not in OpenStep/MacOS-X
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.
- (BOOL)
isGzipped;
Availability: Not in OpenStep/MacOS-X
Returns YES if the receiver is a
non-empty data object with a gzip header,
NO otherwise.
- (NSData*)
md5Digest;
Availability: Not in OpenStep/MacOS-X
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.
- (BOOL)
uudecodeInto: (NSMutableData*)decoded
name: (NSString**)namePtr
mode: (
NSInteger*)modePtr;
Availability: Not in OpenStep/MacOS-X
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.
- (BOOL)
uuencodeInto: (NSMutableData*)encoded
name: (NSString*)name
mode: (
NSInteger)mode;
Availability: Not in OpenStep/MacOS-X
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.
Up