FitStreamReader Class Reference

The FitStreamReader class provides a streaming parser for reading Garmin FIT files. More...

Public Member Functions
	FitStreamReader ()
	Constructs a FIT stream reader with no initial data. More...
	FitStreamReader (const QByteArray &data)
	Constructs a FIT stream reader that reads from data. More...
	FitStreamReader (QIODevice *device)
	Constructs a FIT stream reader that reads from device. More...
	~FitStreamReader ()
	Destroys the FIT stream reader.
void	addData (const QByteArray &data)
	Adds more data to read. More...
bool	atEnd () const
	Returns true if the reader has reached the end of the underlying data or device, or an error has occurred. More...
void	clear ()
	Clears the FIT stream reader. More...
QIODevice *	device () const
	Returns the current device associated with the reader, or nullptr if no device is assigned. More...
void	setDevice (QIODevice *device)
	Sets the current device to device, and resets the stream to its initial state. More...
QVersionNumber	protocolVersion () const
	Returns the protocol version read from the FIT file header, otherwise a null QVersionNumber. More...
QVersionNumber	profileVersion () const
	Returns the profile version read from the FIT file header, otherwise a null QVersionNumber. More...
AbstractDataMessage *	readNext ()
	Returns the next FIT data message from the underlying stream, or a null data message if none could be read. More...

Detailed Description

The FitStreamReader class provides a streaming parser for reading Garmin FIT files.

Todo:

Mention that this is a lower-level class, a users should probably use some yet-to-be FitFile class, that wraps up the calls to this one.

See also

https://developer.garmin.com/fit/protocol/

Constructor & Destructor Documentation

FitStreamReader() [1/3]

FitStreamReader::FitStreamReader

(

)

Constructs a FIT stream reader with no initial data.

Use addData() or setDevice() to provide data when ready.

See also

addData

setDevice

FitStreamReader() [2/3]

FitStreamReader::FitStreamReader ( const QByteArray &  data )

explicit

Constructs a FIT stream reader that reads from data.

data may be empty or incomplete, in which case more data can be added later via addData().

Parameters

data	FIT data to begin reading.

See also

addData

FitStreamReader() [3/3]

FitStreamReader::FitStreamReader ( QIODevice *  device )

explicit

Constructs a FIT stream reader that reads from device.

device must be open for reading, but does not need to have any bytes available yet.

Note

The caller is responsible for ensuring that device remains valid for the lifetime of the constructed reader, or until clear() or setDevice() is used to clear or replace the device.

Parameters

device

Device to to begin reading.

See also

clear

setDevice

Here is the call graph for this function:

Member Function Documentation

addData()

void FitStreamReader::addData

(

const QByteArray &

data

)

Adds more data to read.

Note

It is not valid to use this function if a device has been assigned, ie via either the FitStreamReader(QIODevice *device) constructor, or setDevice().

Parameters

data	Additonal data to read.

atEnd()

bool FitStreamReader::atEnd

(

)

const

Returns true if the reader has reached the end of the underlying data or device, or an error has occurred.

Todo:

Implement this method.

Returns

true if the reader has reached the end of the underlying data or device.

Todo:

Implement this method.

clear()

void FitStreamReader::clear

(

)

Clears the FIT stream reader.

This returns the reader to a state equivalent to having just been default-constructed.

See also

FitStreamReader()

Here is the caller graph for this function:

device()

QIODevice * FitStreamReader::device

(

)

const

Returns the current device associated with the reader, or nullptr if no device is assigned.

Returns

the current device associated with the reader, or nullptr if no device is assigned.

See also

setDevice

Here is the caller graph for this function:

profileVersion()

QVersionNumber FitStreamReader::profileVersion

(

)

const

Returns the profile version read from the FIT file header, otherwise a null QVersionNumber.

FIT profile versions have only two components - major and minor. Both have a maximum value of 15, as the underlying format uses 4-bits for each component.

Returns

the profile version read from the FIT file header, otherwise a null QVersionNumber.

protocolVersion()

QVersionNumber FitStreamReader::protocolVersion

(

)

const

Returns the protocol version read from the FIT file header, otherwise a null QVersionNumber.

FIT protocol versions have only two components - major and minor. The minor component is limited to the range 0 to 100, whereas the major component may be (theoreticlly) 0 to 655.

Returns

the protocol version read from the FIT file header, otherwise a null QVersionNumber.

readNext()

AbstractDataMessage * FitStreamReader::readNext

(

)

Returns the next FIT data message from the underlying stream, or a null data message if none could be read.

If FIT header has not been read yet, it will be read first. If any FIT definition messages are found, they will be parsed, and kept in a dictionary, to used for interpretation of subsequent data messages. Reading will continue until the next FIT data message is found, or no more bytes are available for reading.

Todo:

Document how the caller should distinguish errors, from more-data-needed.

Returns

the next FIT data message, or a null data message.

See also

addData

setDevice()

void FitStreamReader::setDevice

(

QIODevice *

device

)

Sets the current device to device, and resets the stream to its initial state.

device must be open for reading, but does not need to have any bytes available yet.

Note

The caller is responsible for ensuring that device remains valid for the lifetime of the constructed reader, or until clear() or setDevice() is used to clear or replace the device.

Parameters

device

IO device to read from.

See also

device

Here is the call graph for this function:

---

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

• fitstreamreader.h
• fitstreamreader.cpp