Cache/Statistics.h

Go to the documentation of this file.

/*
 * Copyright(c) Sophist Solutions, Inc. 1990-2025.  All rights reserved
 */
#ifndef _Stroika_Foundation_Cache_Statistics_h_
#define _Stroika_Foundation_Cache_Statistics_h_ 1
 
#include "Stroika/Foundation/StroikaPreComp.h"
 
#include <type_traits>
 
#include "Stroika/Foundation/Characters/String.h"
 
/**
 *      \file
 */
 
namespace Stroika::Foundation::Cache::Statistics {
 
    /**
     *  Helper detail class for analyzing and tuning cache statistics.
     *
     *  \note   \em Thread-Safety   <a href="Thread-Safety.md#Internally-Synchronized-Thread-Safety">Internally-Synchronized-Thread-Safety</a>
     */
    struct Stats_Basic {
        Stats_Basic () = default;
        Stats_Basic (const Stats_Basic& src);
 
        void IncrementHits ();
        void IncrementMisses ();
 
        /**
         *  @see Characters::ToString ();
         */
        nonvirtual Characters::String ToString () const;
 
        atomic<unsigned int> fCachedCollected_Hits{};
        atomic<unsigned int> fCachedCollected_Misses{};
    };
 
    /**
     *  Helper for DefaultTraits - when not collecting stats.
     *
     *  \note   \em Thread-Safety   <a href="Thread-Safety.md#Internally-Synchronized-Thread-Safety">Internally-Synchronized-Thread-Safety</a>
     */
    struct Stats_Null {
        void IncrementHits ();
        void IncrementMisses ();
 
        /**
         *  @see Characters::ToString ();
         */
        nonvirtual Characters::String ToString () const;
    };
 
    /**
     *  Helper for DefaultTraits.
     *
     *  \note   \em Thread-Safety   <a href="Thread-Safety.md#Internally-Synchronized-Thread-Safety">Internally-Synchronized-Thread-Safety</a>
     */
    using StatsType_DEFAULT = conditional_t<qStroika_Foundation_Debug_AssertionsChecked, Stats_Basic, Stats_Null>;
 
}
 
/*
 ********************************************************************************
 ***************************** Implementation Details ***************************
 ********************************************************************************
 */
#include "Statistics.inl"
 
#endif /*_Stroika_Foundation_Cache_Statistics_h_*/