StopWatch.cpp

Go to the documentation of this file.

 
// Inclusione <automatica> dell'header che si sta implementando
#include "StopWatch.h"
 
// Implementazione del metodo 'Init' della categoria 'Init'
bool StopWatch::Init()
{
    // Se esiste, dealloco istanza corrente per 'm_StopWatch'
    if (m_StopWatch)
    {
        // Deallocazione
        delete m_StopWatch;
 
        // Sanificazione manuale
        m_StopWatch = nullptr;
    }
 
    // Costruzione dell'oggetto di classe "StopWatchData" attraverso il corrispettivo costruttore di default
    // Allocazione dinamica [heap]
    m_StopWatch = new StopWatchData();
 
    // Dopo l'allocazione, controllo che effettivamente � andata a buon fine. Un puntatore nullo (i.e. 'nullptr') sarebbe indice di errori durante l'allocazione.
    if (m_StopWatch)
        return true;
 
    return false;
}
 
// Implementazione del metodo 'Start' della categoria 'Service Management'
bool StopWatch::Start()
{
    // Avvio il cronometro con il rispettivo metodo 'Start' della classe "StopWatchData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_StopWatch' sia stato effettivamente allocato
    if (m_StopWatch)
        return m_StopWatch->Start();
    else
        return false;
}
 
// Implementazione del metodo 'Stop' della categoria 'Service Management'
bool StopWatch::Stop()
{
    // Arresto il cronometro con il rispettivo metodo 'Stop' della classe "StopWatchData"
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_StopWatch' sia stato effettivamente allocato
    if (m_StopWatch)
        return m_StopWatch->Stop();
    else
        return false;
}
 
// Implementazione del metodo 'Reset' della categoria 'Service Management'
bool StopWatch::Reset()
{
    // Resetto il cronometro allocando un nuovo oggetto cronometro di classe "StopWatchData".
    // L'allocazione provocher� come risultato un nuovo oggetto, con nuovi valori (quelli di default).
    // Il vecchio oggetto con tutte le sue informazioni verr� deallocato.
    // Ritorno, inoltre, il valore booleano 'true' o 'false' indicante il risultato dell'operazione appena eseguita
    return Init();
}
 
// Implementazione del metodo 'get_StopWatch' della categoria 'LowLevel getters'
StopWatchData* const StopWatch::get_StopWatch()
{
    // Ritorno l'attributo 'm_StopWatch' perch� rappresenta gi� un puntatore
    return m_StopWatch;
}
 
// Implementazione del metodo 'get_CurrentFormattedStopWatch' della categoria 'Metodi'
String StopWatch::get_CurrentFormattedStopWatch()
{
    // Ottengo i valori del cronometro formattati in un tipo 'String' [stringa] --> 'hh:mm:ss'
    // Per fare ci�, utilizzo il metodo 'get_CurrentFormattedStopWatch' della classe "StopWatchData"
    // In caso di errore, ottengo come stringa il valore della 'constexpr' '_invalidvalue'
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_StopWatch' sia stato effettivamente allocato
    if (m_StopWatch)
    {
        // Creo una variabile locale allo STACK FRAME di questo metodo <-- [reference '&'] non disponibile in ritorno
        // La variabile verr� utilizzata per evitare le 'recall' ridondanti durante l'analisi del valore in ritorno con l'invalidatore della classe "StopWatchData"
        auto l_Supporter = m_StopWatch->get_CurrentFormattedStopWatch();
 
        if (l_Supporter == String(StopWatchData::get_CoreInvalidator()))
            return String(m_Invalidator);
        else
            return l_Supporter;
    }
        
    else
        return String(m_Invalidator);
}
 
// Implementazione del metodo 'get_WorkingState' della categoria 'Metodi'
const StopWatchData::WorkingState StopWatch::get_WorkingState()
{
    // Ottengo lo stato attuale del cronometro
    // Per fare ci�, utilizzo il metodo 'get_WorkingState' della classe "StopWatchData"
    // In caso di errore, restituisce lo stato 'WorkingState::INVALID'
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_StopWatch' sia stato effettivamente allocato
    if (m_StopWatch)
        return m_StopWatch->get_WorkingState();
    else
        // Questa eventualità impedisce la presenza di una 'reference [&]' nel tipo di ritorno
        return StopWatchData::WorkingState::INVALID;
}
 
// Implementazione del metodo 'Trigger_to_Check' della categoria 'Metodi'
void StopWatch::Trigger_to_Check()
{
    // Effettuo l'operazione richiamando il metodo 'Trigger_to_Check' della classe "StopWatchData"
 
    // Prima di effettuare una qualsiasi chiamata, verifico che l'oggetto 'm_StopWatch' sia stato effettivamente allocato
    if (m_StopWatch)
        m_StopWatch->Trigger_to_Check();
}
 
// Implementazione del metodo 'get_Invalidator' della categoria 'getter -> Invalidator'
/*La specificazione 'inline' rappresenta una grossa ottimizzazione!!*/
inline const int& StopWatch::get_Invalidator()
{
    // Ritorno il valore dell'attributo 'm_Invalidator'. Per evitare la copia durante la fase di ritorno, ritorno l'attributo
    // originale [referenza --> reference '&']. L'attributo � gi� costante, questo evita modifiche non autorizzate.
    return m_Invalidator;
}