CChain Class Reference

An in-memory indexed chain of blocks. More...

#include <chain.h>

Public Member Functions
CBlockIndex *	Genesis () const
	Returns the index entry for the genesis block of this chain, or nullptr if none. More...
CBlockIndex *	Tip () const
	Returns the index entry for the tip of this chain, or nullptr if none. More...
CBlockIndex *	operator[] (int nHeight) const
	Returns the index entry at a particular height in this chain, or nullptr if no such height exists. More...
bool	Contains (const CBlockIndex *pindex) const
	Efficiently check whether a block is present in this chain. More...
CBlockIndex *	Next (const CBlockIndex *pindex) const
	Find the successor of a block in this chain, or nullptr if the given index is not found or is the tip. More...
int	Height () const
	Return the maximal height in the chain. More...
void	SetTip (CBlockIndex *pindex)
	Set/initialize a chain with a given tip. More...
CBlockLocator	GetLocator (const CBlockIndex *pindex=nullptr) const
	Return a CBlockLocator that refers to a block in this chain (by default the tip). More...
const CBlockIndex *	FindFork (const CBlockIndex *pindex) const
	Find the last common block between this chain and a block index entry. More...
CBlockIndex *	FindEarliestAtLeast (int64_t nTime) const
	Find the earliest block with timestamp equal or greater than the given. More...

Private Attributes
std::vector< CBlockIndex * >	vChain

Friends
bool	operator== (const CChain &a, const CChain &b)
	Compare two chains efficiently. More...

Detailed Description

An in-memory indexed chain of blocks.

Definition at line 437 of file chain.h.

Member Function Documentation

Contains()

bool CChain::Contains ( const CBlockIndex *  pindex ) const

inline

Efficiently check whether a block is present in this chain.

Definition at line 466 of file chain.h.

Here is the caller graph for this function:

FindEarliestAtLeast()

CBlockIndex * CChain::FindEarliestAtLeast

(

int64_t

nTime

)

const

Find the earliest block with timestamp equal or greater than the given.

Definition at line 63 of file chain.cpp.

Here is the caller graph for this function:

FindFork()

const CBlockIndex * CChain::FindFork

(

const CBlockIndex *

pindex

)

const

Find the last common block between this chain and a block index entry.

Definition at line 52 of file chain.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Genesis()

CBlockIndex* CChain::Genesis ( ) const

inline

Returns the index entry for the genesis block of this chain, or nullptr if none.

Definition at line 443 of file chain.h.

Here is the caller graph for this function:

GetLocator()

CBlockLocator CChain::GetLocator

(

const CBlockIndex *

pindex = nullptr

)

const

Return a CBlockLocator that refers to a block in this chain (by default the tip).

Definition at line 24 of file chain.cpp.

Here is the call graph for this function:

Height()

int CChain::Height ( ) const

inline

Return the maximal height in the chain.

Is equal to chain.Tip() ? chain.Tip()->nHeight : -1.

Definition at line 479 of file chain.h.

Here is the caller graph for this function:

Next()

CBlockIndex* CChain::Next ( const CBlockIndex *  pindex ) const

inline

Find the successor of a block in this chain, or nullptr if the given index is not found or is the tip.

Definition at line 471 of file chain.h.

operator[]()

CBlockIndex* CChain::operator[] ( int  nHeight ) const

inline

Returns the index entry at a particular height in this chain, or nullptr if no such height exists.

Definition at line 453 of file chain.h.

SetTip()

void CChain::SetTip

(

CBlockIndex *

pindex

)

Set/initialize a chain with a given tip.

CChain implementation.

Definition at line 12 of file chain.cpp.

Here is the caller graph for this function:

Tip()

CBlockIndex* CChain::Tip ( ) const

inline

Returns the index entry for the tip of this chain, or nullptr if none.

Definition at line 448 of file chain.h.

Here is the caller graph for this function:

Friends And Related Function Documentation

operator==

bool operator== ( const CChain &  a, const CChain &  b  )

friend

Compare two chains efficiently.

Definition at line 460 of file chain.h.

Member Data Documentation

vChain

std::vector<CBlockIndex*> CChain::vChain

private

Definition at line 439 of file chain.h.

---

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

• src/chain.h
• src/chain.cpp