Helper functions for managing PackedLink variables. More...

#include <PackedLinkVectorHelper.h>

Inheritance diagram for SG::detail::PackedLinkVectorHelperBase:

Collaboration diagram for SG::detail::PackedLinkVectorHelperBase:

Classes
class	LinkedVector
	Helper to access the `IAuxTypeVector` for an aux variable. More...

Public Types
using	DataLinkBase = ::DataLinkBase

typedef void	InitLinkFunc_t(DataLinkBase &dl, sgkey_t sgkey, IProxyDict *sg)
	Function to initialize a `DataLink` to a given hashed key. More...

using	DataLinkBase_span = detail::AuxDataSpan< DataLinkBase >
	Spans over the linked `DataLinks`. More...

using	const_DataLinkBase_span = detail::AuxDataConstSpan< DataLinkBase >

using	PackedLinkBase_span = CxxUtils::span< PackedLinkBase >
	Span over links. More...

Static Public Member Functions
static IProxyDict *	storeFromSpan (DataLinkBase_span &links)
	Return the current store from the first valid link in the span. More...

static DataLinkBase_span	getLinkBaseSpan (IAuxTypeVector &linkedVec)
	Return a span over all the linked `DataLinkBase's`, from the linked vector. More...

static const_DataLinkBase_span	getLinkBaseSpan (const IAuxTypeVector &linkedVec)
	Return a span over all the linked DataLinks. More...

static std::pair< size_t, bool >	findCollectionBase (LinkedVector &linkedVec, sgkey_t sgkey, DataLinkBase_span &links, IProxyDict sg, InitLinkFunc_t initLinkFunc)
	Find the collection index in the linked `DataLinks` for a sgkey. More...

static bool	updateLinksBase (IAuxTypeVector &linkedVec, PackedLinkBase_span &links, const const_DataLinkBase_span &srcDLinks, IProxyDict sg, InitLinkFunc_t initLinkFunc)
	Update collection index of a collection of `PackedLink`. More...

static bool	applyThinningBase (IAuxTypeVector &linkedVec, PackedLinkBase_span &links, DataLinkBase_span &dlinks, const SG::ThinningCache tc, IProxyDict sg, InitLinkFunc_t *initLinkFunc)
	Apply thinning to packed links, to prepare them for output. More...

Static Private Member Functions
static bool	resizeLinks (LinkedVector &linkedVec, size_t sz)
	Resize a linked vector of `DataLinks`. More...

Detailed Description

Helper functions for managing PackedLink variables.

Functions that don't depend on the target type.

Definition at line 43 of file PackedLinkVectorHelper.h.

Member Typedef Documentation

◆ const_DataLinkBase_span

using SG::detail::PackedLinkVectorHelperBase::const_DataLinkBase_span = detail::AuxDataConstSpan<DataLinkBase>

Definition at line 70 of file PackedLinkVectorHelper.h.

◆ DataLinkBase

using SG::detail::PackedLinkVectorHelperBase::DataLinkBase = ::DataLinkBase

Definition at line 57 of file PackedLinkVectorHelper.h.

◆ DataLinkBase_span

using SG::detail::PackedLinkVectorHelperBase::DataLinkBase_span = detail::AuxDataSpan<DataLinkBase>

Spans over the linked DataLinks.

These hold the span data by reference, so they update if the underlying vector changes.

Definition at line 69 of file PackedLinkVectorHelper.h.

◆ InitLinkFunc_t

typedef void SG::detail::PackedLinkVectorHelperBase::InitLinkFunc_t(DataLinkBase &dl, sgkey_t sgkey, IProxyDict *sg)

Function to initialize a DataLink to a given hashed key.

Definition at line 61 of file PackedLinkVectorHelper.h.

◆ PackedLinkBase_span

using SG::detail::PackedLinkVectorHelperBase::PackedLinkBase_span = CxxUtils::span<PackedLinkBase>

Span over links.

Definition at line 127 of file PackedLinkVectorHelper.h.

Member Function Documentation

◆ applyThinningBase()

bool SG::detail::PackedLinkVectorHelperBase::applyThinningBase	(	IAuxTypeVector &	linkedVec,
		PackedLinkBase_span &	links,
		DataLinkBase_span &	dlinks,
		const SG::ThinningCache *	tc,
		IProxyDict *	sg,
		InitLinkFunc_t *	initLinkFunc
	)

static

Apply thinning to packed links, to prepare them for output.

Parameters

linkedVec	Interface for the linked vector of `DataLinks`.
links	Span over the links to update, as `PackedLinkBase`.
dlinks	Span over the source link vector, as `DataLinkBase`.
tc	The `ThinningCache` for this object, if it exists.
sg	The `IProxyDict` of the current store. If null, take it from the links in `srcDlinks`, or use the global, thread-local default.
initFunc	Function to initialize a `DataLink` to a given hashed key.

Returns true if it is known that the payload of the linked vector has not moved. (If this is false, any caches/iterators must be assumed to be invalid.)

Definition at line 130 of file PackedLinkVectorHelper.cxx.

 {
   bool cacheValid = true;
   for (PackedLinkBase& l : links) {
     if (l.collection() != 0) {
       sgkey_t sgkey = dlinks[l.collection()].key();
       size_t index = l.index();
       sgkey_t sgkey_out = sgkey;
       size_t index_out = index;
       if (sg) {
         sg->tryELRemap (sgkey, index, sgkey_out, index_out);
       }
       DataProxyHolder::thin (sgkey_out, index_out, tc);
       l.setIndex (index_out);
       if (sgkey_out != sgkey) {
         LinkedVector lv (linkedVec);
         auto [index, flag] = findCollectionBase (lv, sgkey_out, dlinks,
                                                  sg, initLinkFunc);
         l.setCollection (index);
         cacheValid &= flag;
       }
     }
   }
   return cacheValid;
 }

◆ findCollectionBase()

std::pair< size_t, bool > SG::detail::PackedLinkVectorHelperBase::findCollectionBase	(	LinkedVector &	linkedVec,
		sgkey_t	sgkey,
		DataLinkBase_span &	links,
		IProxyDict *	sg,
		InitLinkFunc_t *	initLinkFunc
	)

static

Find the collection index in the linked DataLinks for a sgkey.

Parameters

linkedVec	How to find the linked vector.
sgkey	Hashed key for which to search.
links	Span over the vector of `DataLinks`, as `DataLinkBase`. May be modified if the vector grows.
sg	The `IProxyDict` of the current store. May be null to use the global, thread-local default.
initFunc	Function to initialize a `DataLink` to a given hashed key.

Searches for a DataLinkBase matching sgkey in the linked vector. If not found, then a new entry is added. Returns a pair (INDEX, CACHEVALID). INDEX is the index in the vector of the sgkey (and thus the collection index to store in the PackedLink). CACHEVALID is true if it is known that the payload of the vector has not moved. (If this is false, any caches/iterators must be assumed to be invalid.)

This does not actually initialize the DataLink if the vector grows. The caller should test if the size of the span changed and if so, initialize the last element using sgkey.

Definition at line 42 of file PackedLinkVectorHelper.cxx.

 {
   if (sgkey == 0) {
     if (!links.empty())
       return std::make_pair (0u, true);
   }
   else {
     for (size_t i = 1; i < links.size(); ++i) {
       if (links[i].key() == sgkey) return std::make_pair (i, true);
     }
   }
   size_t oldsz = links.size();
   size_t newsz = oldsz+1;
   if (oldsz == 0 && sgkey != 0) {
     newsz = 2;
   }
   bool cacheValid = resizeLinks (linkedVec, newsz);
   initLinkFunc (links.back(), sgkey, sg);
   return std::make_pair (links.size() - 1, cacheValid);
 }

◆ getLinkBaseSpan() [1/2]

static const_DataLinkBase_span SG::detail::PackedLinkVectorHelperBase::getLinkBaseSpan ( const IAuxTypeVector & linkedVec )

static

Return a span over all the linked DataLinks.

from the linked vector.

Parameters

linkedVec Interface for the linked vector of DataLinks.

◆ getLinkBaseSpan() [2/2]

static DataLinkBase_span SG::detail::PackedLinkVectorHelperBase::getLinkBaseSpan ( IAuxTypeVector & linkedVec )

static

Return a span over all the linked DataLinkBase's, from the linked vector.

Parameters

linkedVec Interface for the linked vector of DataLinkBase's.

◆ resizeLinks()

bool SG::detail::PackedLinkVectorHelperBase::resizeLinks	(	LinkedVector &	linkedVec,
		size_t	sz
	)

staticprivate

Resize a linked vector of DataLinks.

Parameters

linkedVec	How to find the linked vector.
sz	The new size of the container.

Returns true if it is known the the underlying vector did not move.

Definition at line 171 of file PackedLinkVectorHelper.cxx.

 {
   return linkedVec->resize (sz);
 }

◆ storeFromSpan()

static IProxyDict* SG::detail::PackedLinkVectorHelperBase::storeFromSpan ( DataLinkBase_span & links )

static

Return the current store from the first valid link in the span.

If there are no valid links, then return the global default.

Parameters

links The span of links.

◆ updateLinksBase()

bool SG::detail::PackedLinkVectorHelperBase::updateLinksBase	(	IAuxTypeVector &	linkedVec,
		PackedLinkBase_span &	links,
		const const_DataLinkBase_span &	srcDLinks,
		IProxyDict *	sg,
		InitLinkFunc_t *	initLinkFunc
	)

static

Update collection index of a collection of PackedLink.

Parameters

linkedVec	Interface for the linked vector of `DataLinks`.
links	Span over the links to update, as `PackedLinkBase`.
srcDLinks	Span over the source link vector, as `DataLinkBase`.
sg	The `IProxyDict` of the current store. If null, take it from the links in `srcDlinks`, or use the global, thread-local default.
initFunc	Function to initialize a `DataLink` to a given hashed key.

To be used after links have been copied/moved from one container to another. The collection indices are updated to be appropriate for the destination container. Returns true if it is known that the payload of the linked vector has not moved. (If this is false, any caches/iterators must be assumed to be invalid.)

Definition at line 87 of file PackedLinkVectorHelper.cxx.

 {
   DataLinkBase_span DLinks = getLinkBaseSpan (linkedVec);
   if (sg == nullptr) {
     sg = storeFromSpan (DLinks);
   }
   bool cacheValid = true;
   for (PackedLinkBase& l : links) {
     size_t in_coll = l.collection();
     if (in_coll > 0) {
       LinkedVector lv (linkedVec);
       auto [index, thisValid] = findCollectionBase
         (lv, srcDLinks.at(in_coll).key(), DLinks, sg, initLinkFunc);
       l.setCollection (index);
       cacheValid &= thisValid;
     }
   }
   return cacheValid;
 }

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

Classes

Public Types

Static Public Member Functions

Static Private Member Functions

Detailed Description

Member Typedef Documentation

◆ const_DataLinkBase_span

◆ DataLinkBase

◆ DataLinkBase_span

◆ InitLinkFunc_t

◆ PackedLinkBase_span

Member Function Documentation

◆ applyThinningBase()

◆ findCollectionBase()

◆ getLinkBaseSpan() [1/2]

◆ getLinkBaseSpan() [2/2]

◆ resizeLinks()

◆ storeFromSpan()

◆ updateLinksBase()