NSDate(SCDate) Category Reference

Standard class NSDate functionality extending category. More...

#import <SCDate.h>

Inheritance diagram for NSDate(SCDate):

Serialized Files Support
(NSDate *)	+ dateWithCoder:
(NSDate *)	+ dateWithContentsOfSerializedFile:
(id)	- initWithContentsOfSerializedFile:
(BOOL)	- writeContentsToSerializedFile:

Data Dictionaries Support
(NSDate *)	+ dateWithDataDictionary:
(NSDate *)	+ dateWithDataDictionaryFromFile:
(id)	- initWithDataDictionary:
(id)	- initWithDataDictionaryFromFile:
(void)	- writeToDataDictionary:
(void)	- writeToDataDictionaryFile:atomically:
(void)	- writeToDataDictionaryFile:
(NSDictionary *)	- dataDictionary

Streams Support
(NSDate *)	+ dateWithStream:
(NSDate *)	+ dateWithFileStream:
(id)	- initWithStream:
(id)	- initWithFileStream:
(void)	- writeToStream:
(void)	- writeToFileStream:
(void)	- appendToFileStream:

Collections Support
(id< SCCollectioning >)	- copyObject
(SCComparisonResult)	- compareWithObject:

Additional Inherited Members

Instance Methods inherited from <SCCoding>

Instance Methods inherited from <SCDictionaring>

Instance Methods inherited from <SCCollectioning>

Detailed Description

Standard class NSDate functionality extending category.

Since

version 1.1.6

Declares the additional methods for add into the standard class NSDate the additional functionality, such as dictionaries, collections and streans support and so on.

Method Documentation

- (void) appendToFileStream:

(NSString *)

path

Appends the receiving date to the file stream with the specified path.

Parameters

path	- the path to the destination file stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

Reimplemented from <SCStreaming>.

- (SCComparisonResult) compareWithObject:

(id<SCCollectioning>)

object

Returns the result of comparison the receiving date with a given another class instance.

Parameters

object

- the second class instance for comparison

Returns

Comparison result:

• SCComparisonEqual - class instances are equal
• SCComparisonLess - the receiving date is less than the specified class instance
• SCComparisonGreater - the receiving date is greater than the second class instance
• SCComparisonNotAllowed - instances cannot be compared

Reimplemented from <SCCollectioning>.

- (id< SCCollectioning >) copyObject

Returns a copy of the receiving date.

Returns

A copy of the receiving date

Reimplemented from <SCCollectioning>.

- (NSDictionary *) dataDictionary

Returns the dictionary with the receiving date.

Returns

A dictionary which contains the receiving date

Reimplemented from <SCDictionaring>.

+ (NSDate *) dateWithCoder:

(NSCoder *)

coder

Returns a date created by using the data from the specified coder.

Parameters

coder

- the source coder

Returns

A created date

+ (NSDate *) dateWithContentsOfSerializedFile:

(NSString *)

path

Returns a date created by using the data from the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns

A created date

+ (NSDate *) dateWithDataDictionary:

(NSDictionary *)

dictionary

Returns a date created by using the data from the specified data dictionary.

Parameters

dictionary

- the source data dictionary

Returns

A created date

+ (NSDate *) dateWithDataDictionaryFromFile:

(NSString *)

path

Returns a date created by using the data from the dictionary file with the specified path.

Parameters

path	- the path to the source dictionary file

Returns

A created date

+ (NSDate *) dateWithFileStream:

(NSString *)

path

Returns a date created by using the data from the file stream with the specified path.

Parameters

path	- the path to the source file stream

Returns

A created date

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

+ (NSDate *) dateWithStream:

(SCStream *)

stream

Returns a date created by using the data from the specified stream.

Parameters

stream

- the source stream

Returns

A created date

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

- (id) initWithContentsOfSerializedFile:

(NSString *)

path

Initializes a date using the data from the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns

A newly initialized date

Reimplemented from <SCCoding>.

- (id) initWithDataDictionary:

(NSDictionary *)

dictionary

Initializes a date using the data from the specified data dictionary.

Parameters

dictionary

- the source data dictionary

Returns

A newly initialized date

Reimplemented from <SCDictionaring>.

- (id) initWithDataDictionaryFromFile:

(NSString *)

path

Initializes a date using the data from the dictionary file with the specified path.

Parameters

path	- the path to the source dictionary file

Returns

A newly initialized date

Reimplemented from <SCDictionaring>.

- (id) initWithFileStream:

(NSString *)

path

Initializes a date using the data from the file stream with the specified path.

Parameters

path	- the path to the source file stream

Returns

A newly initialized date

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

Reimplemented from <SCStreaming>.

- (id) initWithStream:

(SCStream *)

stream

Initializes a date using the data from the specified stream.

Parameters

stream

- the source stream

Returns

A newly initialized date

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

Reimplemented from <SCStreaming>.

- (BOOL) writeContentsToSerializedFile:

(NSString *)

path

Writes the receiving date to the serialized file with the specified path.

Parameters

path	- the path to the serialized file

Returns

YES if the operation is successfully, otherwise NO

Reimplemented from <SCCoding>.

- (void) writeToDataDictionary:

(NSMutableDictionary *)

dictionary

Writes the receiving date into the specified data dictionary.

Parameters

dictionary

- the dictionary to store the receiving class instance

Reimplemented from <SCDictionaring>.

- (void) writeToDataDictionaryFile:

(NSString *)

path

Writes the receiving date into the data dictionary file with the specified path.

Parameters

path	- the path to the data dictionary file

Reimplemented from <SCDictionaring>.

- (void) writeToDataDictionaryFile:		(NSString *)	path
atomically:		(BOOL)	atomically

Writes the receiving date into the data dictionary file with the specified path.

Parameters

path	- the path to the data dictionary file
atomically	- YES for using the intermediate file and NO for direct writing operation

Reimplemented from <SCDictionaring>.

- (void) writeToFileStream:

(NSString *)

path

Writes the receiving date to the file stream with the specified path.

Parameters

path	- the path to the destination file stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

Reimplemented from <SCStreaming>.

- (void) writeToStream:

(SCStream *)

stream

Writes the receiving date to the specified stream.

Parameters

stream

- the destination stream

Exceptions

SCStreamException	- stream error detected
SCSystemException	- system error detected

Reimplemented from <SCStreaming>.

---

The documentation for this category was generated from the following files:

• SCDate.h
• SCDate.m