GrabbaMagstripeData Class Reference

Description

Class encapsulating magnetic stripe data tracks.

Track data may be read in 5-bit or 7-bit formats. These will be decoded according to standard magstripe encoding rules, and each track's embedded checksum will be verified. If verification succeeds, then track data is stored in this structure in the NSString format.

Note

All property values are passed by copy; a new copy of the value will be generated each time a property is read.

Thread safety:

• Concurrent accesses to distinct objects: safe
• Concurrent accesses to the same object: unsafe, unless all accesses are read-only (i.e. property reads)

Inheritance diagram for GrabbaMagstripeData:

Instance Methods
(instancetype _Nullable)	- init
	Initialise an empty magstripe data object. More...
(instancetype _Nullable)	- initWithTrack1:track2:track3:
	Initialise a magstripe data object given the contents of each track. More...

Class Methods
(instancetype _Nullable)	+ magstripeData
	Allocate and initialise an empty magstripe data object. More...
(instancetype _Nullable)	+ magstripeDataWithTrack1:track2:track3:
	Allocate and initialise a magstripe data object given the contents of each track. More...

Properties
NSString *_Nonnull	track1
	First track's data as a string if track is present and valid, otherwise an empty string. More...
NSString *_Nonnull	track2
	Second track's data as a string if track is present and valid, otherwise an empty string. More...
NSString *_Nonnull	track3
	Third track's data as a string if track is present and valid, otherwise an empty string. More...

Method Documentation

init()

- (instancetype _Nullable) init

Initialise an empty magstripe data object.

Returns

Pointer to initialised object if initialisation succeeded; nil if it failed

initWithTrack1:track2:track3:()

- (instancetype _Nullable) initWithTrack1:		(NSString *_Nonnull)	track1
track2:		(NSString *_Nonnull)	track2
track3:		(NSString *_Nonnull)	track3

Initialise a magstripe data object given the contents of each track.

Parameters

track1	Initial value of the first track - non-empty for valid read or empty for invalid/missing
track2	Initial value of the first track - non-empty for valid read or empty for invalid/missing
track3	Initial value of the first track - non-empty for valid read or empty for invalid/missing

Returns

Pointer to initialised object if initialisation succeeded; nil if it failed

magstripeData()

+ (instancetype _Nullable) magstripeData

Allocate and initialise an empty magstripe data object.

Returns

Pointer to initialised object if initialisation succeeded; nil if it failed

magstripeDataWithTrack1:track2:track3:()

+ (instancetype _Nullable) magstripeDataWithTrack1:		(NSString *_Nonnull)	track1
track2:		(NSString *_Nonnull)	track2
track3:		(NSString *_Nonnull)	track3

Allocate and initialise a magstripe data object given the contents of each track.

Parameters

track1	Initial value of the first track - non-empty for valid read or empty for invalid/missing
track2	Initial value of the first track - non-empty for valid read or empty for invalid/missing
track3	Initial value of the first track - non-empty for valid read or empty for invalid/missing

Returns

Pointer to initialised object if initialisation succeeded; nil if it failed

Property Documentation

track1

- (NSString* _Nonnull) track1

readwritenonatomiccopy

First track's data as a string if track is present and valid, otherwise an empty string.

track2

- (NSString* _Nonnull) track2

readwritenonatomiccopy

Second track's data as a string if track is present and valid, otherwise an empty string.

track3

- (NSString* _Nonnull) track3

readwritenonatomiccopy

Third track's data as a string if track is present and valid, otherwise an empty string.