JS8Call-Improved master
Loading...
Searching...
No Matches
LogBook Class Reference

Integrates ADIF, CTY and worked-state utilities for logbook queries. More...

#include <LogBook.h>

Public Member Functions

void init ()
 Initialize internal helpers and data.
bool hasWorkedBefore (const QString &call, const QString &band)
 Check whether a call on a specific band has been worked before.
void match (const QString call, QString &countryName, bool &callWorkedBefore, bool &countryWorkedBefore) const
 Resolve callsign to a country and determine worked-before flags.
bool findCallDetails (const QString call, QString &grid, QString &date, QString &name, QString &comment) const
 Find detailed call information (grid, date, name, comment).
void addAsWorked (const QString call, const QString band, const QString mode, const QString submode, const QString grid, const QString date, const QString name, const QString comment)
 Mark the given call as worked and add it to the ADIF/log store.

Detailed Description

Integrates ADIF, CTY and worked-state utilities for logbook queries.

Member Function Documentation

◆ addAsWorked()

void LogBook::addAsWorked ( const QString call,
const QString band,
const QString mode,
const QString submode,
const QString grid,
const QString date,
const QString name,
const QString comment )

Mark the given call as worked and add it to the ADIF/log store.

Add a new QSO to the logbook and mark the country as worked.

Parameters
callThe callsign of the contacted station.
bandThe band on which the QSO was made.
modeThe mode of the QSO.
submodeThe submode of the QSO.
gridThe grid locator of the contacted station.
dateThe date of the QSO.
nameThe name of the operator.
commentAny comments associated with the QSO.

◆ findCallDetails()

bool LogBook::findCallDetails ( const QString call,
QString & grid,
QString & date,
QString & name,
QString & comment ) const

Find detailed call information (grid, date, name, comment).

Find details associated with a callsign in the logbook.

Parameters
callInput callsign to search for.
gridOutput: Maidenhead grid if found.
dateOutput: QSO date string if found.
nameOutput: operator name if present.
commentOutput: comment if present.
Returns
true if call details were found, false otherwise.
Parameters
callThe callsign to search for.
gridOutput parameter to hold the grid locator.
dateOutput parameter to hold the date of the QSO.
nameOutput parameter to hold the name of the operator.
commentOutput parameter to hold any comments associated with the QSO.
Returns
True if details were found, false otherwise.

◆ hasWorkedBefore()

bool LogBook::hasWorkedBefore ( const QString & call,
const QString & band )

Check whether a call on a specific band has been worked before.

Check if a call has been worked before on a specific band.

Parameters
callCallsign to check.
bandBand string to check.
Returns
true if the call/band combination exists in the log.
Parameters
callThe callsign to check.
bandThe band to check.
Returns
True if the call has been worked before on the specified band, false otherwise.

◆ init()

void LogBook::init ( )

Initialize internal helpers and data.

Initialize the logbook by loading country data and existing log entries.

◆ match()

void LogBook::match ( const QString call,
QString & countryName,
bool & callWorkedBefore,
bool & countryWorkedBefore ) const

Resolve callsign to a country and determine worked-before flags.

Match a callsign to its country and check if it has been worked before.

Parameters
callInput callsign.
countryNameOutput: resolved country/entity name.
callWorkedBeforeOutput: whether this call has been worked.
countryWorkedBeforeOutput: whether the country has been worked.
callThe callsign to match.
countryNameOutput parameter to hold the matched country name.
callWorkedBeforeOutput parameter indicating if the call has been worked before.
countryWorkedBeforeOutput parameter indicating if the country has been worked before.

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