JaffarPlus
High-performance best-first search optimizer for tool-assisted speedruns
Loading...
Searching...
No Matches
Public Member Functions | List of all members
jaffarPlus::InputHistoryNone Class Referencefinal

Records nothing; smallest per-state footprint (the runner's count alone), no solution reconstruction. More...

#include <inputHistoryNone.hpp>

Inheritance diagram for jaffarPlus::InputHistoryNone:
[legend]

Public Member Functions

void reset () override
 Resets the cursor to the empty path.
 
void pushInput (const size_t, const InputSet::inputIndex_t) override
 Records one applied input at path position stepCount (the runner's current step counter).
 
void serializeCold (jaffarCommon::serializer::Base &) const override
 Writes the compact "cold" path representation (stored in each StateDb slot), excluding the count.
 
void deserializeCold (jaffarCommon::deserializer::Base &) override
 Restores the cursor from a "cold" representation (the count is restored by the runner).
 
void serializeFull (jaffarCommon::serializer::Base &) const override
 Writes the self-contained "full" path representation (for standalone snapshot buffers), excluding the count.
 
void deserializeFull (jaffarCommon::deserializer::Base &, const size_t) override
 Restores the cursor from a "full" representation.
 
std::string toString (const std::map< InputSet::inputIndex_t, std::string > &, const size_t) const override
 Reconstructs the path as a newline-separated string of input strings (the solution).
 
size_t getColdSize () const override
 Size, in bytes, of the cold path representation in a StateDb slot (EXCLUDING the runner's count).
 
size_t getFullSize () const override
 Size, in bytes, of the full (self-contained) path representation in a snapshot buffer (EXCLUDING the count).
 
void captureColdToFull (const void *, void *) const override
 Converts a stored cold path into a self-contained full one (best/worst snapshot).
 
virtual void initColdSlot (void *cold) const
 Prepares a fresh/recycled cold slot (e.g. marks it as holding no trie node). Default: no-op.
 
virtual void releaseColdSlot (void *cold, const size_t shard) const
 Releases any shared resource a freed cold slot was holding (trie GC).
 
virtual size_t getApproxMemoryBytes () const
 Approximate resident memory of any shared structure (e.g. the trie), in bytes. Default: 0.
 

Detailed Description

Records nothing; smallest per-state footprint (the runner's count alone), no solution reconstruction.

Definition at line 15 of file inputHistoryNone.hpp.

Member Function Documentation

◆ captureColdToFull()

void jaffarPlus::InputHistoryNone::captureColdToFull ( const void *  cold,
void *  full 
) const
inlineoverridevirtual

Converts a stored cold path into a self-contained full one (best/worst snapshot).

Operates on the path only; the runner's count prefix is copied separately by the StateDb.

Implements jaffarPlus::InputHistory.

Definition at line 31 of file inputHistoryNone.hpp.

◆ deserializeCold()

void jaffarPlus::InputHistoryNone::deserializeCold ( jaffarCommon::deserializer::Base &  d)
inlineoverridevirtual

Restores the cursor from a "cold" representation (the count is restored by the runner).

Implements jaffarPlus::InputHistory.

Definition at line 22 of file inputHistoryNone.hpp.

◆ deserializeFull()

void jaffarPlus::InputHistoryNone::deserializeFull ( jaffarCommon::deserializer::Base &  d,
const size_t  stepCount 
)
inlineoverridevirtual

Restores the cursor from a "full" representation.

stepCount is the runner's already-restored step counter, needed by strategies (the trie) that rebuild their cursor from the path length.

Implements jaffarPlus::InputHistory.

Definition at line 24 of file inputHistoryNone.hpp.

◆ getApproxMemoryBytes()

virtual size_t jaffarPlus::InputHistory::getApproxMemoryBytes ( ) const
inlinevirtualinherited

Approximate resident memory of any shared structure (e.g. the trie), in bytes. Default: 0.

Reimplemented in jaffarPlus::InputHistoryTrie.

Definition at line 94 of file inputHistory.hpp.

◆ getColdSize()

size_t jaffarPlus::InputHistoryNone::getColdSize ( ) const
inlineoverridevirtual

Size, in bytes, of the cold path representation in a StateDb slot (EXCLUDING the runner's count).

Implements jaffarPlus::InputHistory.

Definition at line 28 of file inputHistoryNone.hpp.

◆ getFullSize()

size_t jaffarPlus::InputHistoryNone::getFullSize ( ) const
inlineoverridevirtual

Size, in bytes, of the full (self-contained) path representation in a snapshot buffer (EXCLUDING the count).

Implements jaffarPlus::InputHistory.

Definition at line 29 of file inputHistoryNone.hpp.

◆ initColdSlot()

virtual void jaffarPlus::InputHistory::initColdSlot ( void *  cold) const
inlinevirtualinherited

Prepares a fresh/recycled cold slot (e.g. marks it as holding no trie node). Default: no-op.

Reimplemented in jaffarPlus::InputHistoryTrie.

Definition at line 81 of file inputHistory.hpp.

◆ pushInput()

void jaffarPlus::InputHistoryNone::pushInput ( const size_t  stepCount,
const InputSet::inputIndex_t  input 
)
inlineoverridevirtual

Records one applied input at path position stepCount (the runner's current step counter).

Implements jaffarPlus::InputHistory.

Definition at line 19 of file inputHistoryNone.hpp.

◆ releaseColdSlot()

virtual void jaffarPlus::InputHistory::releaseColdSlot ( void *  cold,
const size_t  shard 
) const
inlinevirtualinherited

Releases any shared resource a freed cold slot was holding (trie GC).

shard is the freeing thread's id, used to recycle into a contention-free per-thread pool. Default: no-op.

Reimplemented in jaffarPlus::InputHistoryTrie.

Definition at line 84 of file inputHistory.hpp.

◆ reset()

void jaffarPlus::InputHistoryNone::reset ( )
inlineoverridevirtual

Resets the cursor to the empty path.

Implements jaffarPlus::InputHistory.

Definition at line 18 of file inputHistoryNone.hpp.

◆ serializeCold()

void jaffarPlus::InputHistoryNone::serializeCold ( jaffarCommon::serializer::Base &  s) const
inlineoverridevirtual

Writes the compact "cold" path representation (stored in each StateDb slot), excluding the count.

Implements jaffarPlus::InputHistory.

Definition at line 21 of file inputHistoryNone.hpp.

◆ serializeFull()

void jaffarPlus::InputHistoryNone::serializeFull ( jaffarCommon::serializer::Base &  s) const
inlineoverridevirtual

Writes the self-contained "full" path representation (for standalone snapshot buffers), excluding the count.

Implements jaffarPlus::InputHistory.

Definition at line 23 of file inputHistoryNone.hpp.

◆ toString()

std::string jaffarPlus::InputHistoryNone::toString ( const std::map< InputSet::inputIndex_t, std::string > &  inputStringMap,
const size_t  stepCount 
) const
inlineoverridevirtual

Reconstructs the path as a newline-separated string of input strings (the solution).

stepCount is the runner's step counter, bounding how many recorded steps are rendered.

Implements jaffarPlus::InputHistory.

Definition at line 26 of file inputHistoryNone.hpp.

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