dunedaq::daqdataformats::TriggerRecordHeader Class Reference

C++ representation of a TriggerRecordHeader, which wraps a flat array that is the TriggerRecordHeader's "actual" form. More...

#include <TriggerRecordHeader.hpp>

Public Member Functions
	TriggerRecordHeader (const std::vector< ComponentRequest > &components)
	Construct a TriggerRecordHeader using a vector of ComponentRequest objects.
	TriggerRecordHeader (void *existing_trigger_record_header_buffer, bool copy_from_buffer=false)
	Construct a TriggerRecordHeader using an existing TriggerRecordHeader data array.
TriggerRecordHeaderData	get_header () const
trigger_number_t	get_trigger_number () const
void	set_trigger_number (trigger_number_t trigger_number)
timestamp_t	get_trigger_timestamp () const
void	set_trigger_timestamp (timestamp_t trigger_timestamp)
uint64_t	get_num_requested_components () const
run_number_t	get_run_number () const
void	set_run_number (run_number_t run_number)
std::bitset< 32 >	get_status_bits () const
void	set_status_bits (std::bitset< 32 > bits)
bool	get_status_bit (TriggerRecordStatusBits bit) const
	Get the value of the given status bit.
void	set_status_bit (TriggerRecordStatusBits bit, bool value)
	Set the given status bit to the given value.
trigger_type_t	get_trigger_type () const
void	set_trigger_type (trigger_type_t trigger_type)
trigger_number_t	get_sequence_number () const
void	set_sequence_number (sequence_number_t number)
trigger_number_t	get_max_sequence_number () const
void	set_max_sequence_number (sequence_number_t number)
SourceID	get_element_id () const
	Get the SourceID for this TriggerRecordHeader.
void	set_element_id (SourceID source_id)
	Set the SourceID for this TriggerRecordHeader.
size_t	get_total_size_bytes () const
	Get the total size of the TriggerRecordHeader, including header and all component requests.
const void *	get_storage_location () const
	Get read-only access to the underlying flat data array.
const ComponentRequest &	at (size_t idx) const
	Access ComponentRequest by index.
ComponentRequest const &	get_component_for_source_id (SourceID const &source_id) const
	Access ComponentRequest by SourceID.
	TriggerRecordHeader (TriggerRecordHeader const &other)
TriggerRecordHeader &	operator= (TriggerRecordHeader const &other)
	TriggerRecordHeader (TriggerRecordHeader &&other)
TriggerRecordHeader &	operator= (TriggerRecordHeader &&other)
	~TriggerRecordHeader ()

Private Member Functions
TriggerRecordHeaderData *	header_ () const
	Get the TriggerRecordHeaderData from the m_data_arr array.

Private Attributes
void *	m_data_arr
	Flat memory containing a TriggerRecordHeaderData header and an array of ComponentRequests.
bool	m_alloc { false }
	Whether the TriggerRecordHeader owns the memory pointed by m_data_arr.

Detailed Description

C++ representation of a TriggerRecordHeader, which wraps a flat array that is the TriggerRecordHeader's "actual" form.

Definition at line 36 of file TriggerRecordHeader.hpp.

Constructor & Destructor Documentation

TriggerRecordHeader() [1/4]

dunedaq::daqdataformats::TriggerRecordHeader::TriggerRecordHeader ( const std::vector< ComponentRequest > & components )

inlineexplicit

Construct a TriggerRecordHeader using a vector of ComponentRequest objects.

Parameters

components

Vector of ComponentRequests to copy into TriggerRecordHeader

Definition at line 173 of file TriggerRecordHeader.hpp.

{
  size_t size = sizeof(TriggerRecordHeaderData) + components.size() * sizeof(ComponentRequest);
 
  m_data_arr = malloc(size); // NOLINT
  if (m_data_arr == nullptr) {
    throw std::bad_alloc();
  }
  m_alloc = true;
 
  TriggerRecordHeaderData header;
  header.num_requested_components = components.size();
  std::memcpy(m_data_arr, &header, sizeof(header));
  std::memcpy(static_cast<uint8_t*>(m_data_arr) + sizeof(header), // NOLINT
              components.data(),
              sizeof(ComponentRequest) * components.size());
}

TriggerRecordHeader() [2/4]

dunedaq::daqdataformats::TriggerRecordHeader::TriggerRecordHeader ( void * existing_trigger_record_header_buffer, bool copy_from_buffer = false )

inlineexplicit

Construct a TriggerRecordHeader using an existing TriggerRecordHeader data array.

Parameters

existing_trigger_record_header_buffer	Pointer to existing TriggerRecordHeader array
copy_from_buffer	Whether to create a copy of the exiting buffer (true) or use that memory without taking ownership (false)

Definition at line 191 of file TriggerRecordHeader.hpp.

{
  if (!copy_from_buffer) {
    m_data_arr = existing_trigger_record_header_buffer;
  } else {
    auto header = reinterpret_cast<TriggerRecordHeaderData*>(existing_trigger_record_header_buffer); // NOLINT
    size_t size = header->num_requested_components * sizeof(ComponentRequest) + sizeof(TriggerRecordHeaderData);
 
    m_data_arr = malloc(size); // NOLINT
    if (m_data_arr == nullptr) {
      throw std::bad_alloc();
    }
    m_alloc = true;
    std::memcpy(m_data_arr, existing_trigger_record_header_buffer, size);
  }
}

TriggerRecordHeader() [3/4]

dunedaq::daqdataformats::TriggerRecordHeader::TriggerRecordHeader ( TriggerRecordHeader const & other )

inline

Definition at line 208 of file TriggerRecordHeader.hpp.

  : TriggerRecordHeader(other.m_data_arr, true)
{
}

TriggerRecordHeader() [4/4]

dunedaq::daqdataformats::TriggerRecordHeader::TriggerRecordHeader ( TriggerRecordHeader && other )

inline

Definition at line 138 of file TriggerRecordHeader.hpp.

  {
    m_alloc = other.m_alloc;
    other.m_alloc = false;
    m_data_arr = other.m_data_arr;
  }

~TriggerRecordHeader()

dunedaq::daqdataformats::TriggerRecordHeader::~TriggerRecordHeader ( )

inline

Definition at line 152 of file TriggerRecordHeader.hpp.

  {
    if (m_alloc)
      free(m_data_arr); // NOLINT
  }

Member Function Documentation

at()

const ComponentRequest & dunedaq::daqdataformats::TriggerRecordHeader::at ( size_t idx ) const

inline

Access ComponentRequest by index.

Parameters

idx	Index for access

Returns

Const reference of ComponentRequest at index

Exceptions

std::range_error

exception if idx is outside of allowable range

Definition at line 232 of file TriggerRecordHeader.hpp.

{
  if (idx >= header_()->num_requested_components) {
    throw std::range_error(std::format(
      "Supplied ComponentRequest index {} out of range (size: {})", idx, header_()->num_requested_components));
  }
 
  // Increment header pointer by one to skip header
  return *(reinterpret_cast<ComponentRequest*>(header_() + 1) + idx); // NOLINT
}

get_component_for_source_id()

ComponentRequest const & dunedaq::daqdataformats::TriggerRecordHeader::get_component_for_source_id ( SourceID const & source_id ) const

inline

Access ComponentRequest by SourceID.

Parameters

source_id

SourceID to access

Returns

ComponentRequest constant reference

Exceptions

std::invalid_argument

exception if source_id is not in ComponentRequest list

Definition at line 244 of file TriggerRecordHeader.hpp.

{
  for (uint64_t idx = 0; idx < get_num_requested_components(); ++idx) { // NOLINT(build/unsigned)
    ComponentRequest const& component_obj = *(reinterpret_cast<ComponentRequest*>(header_() + 1) + idx); // NOLINT
    if (source_id == component_obj.component) {
      return component_obj;
    }
  }
  throw std::invalid_argument("Supplied SourceID (" + source_id.to_string() +
                              ") was not found in the ComponentRequest list.");
}

get_element_id()

SourceID dunedaq::daqdataformats::TriggerRecordHeader::get_element_id ( ) const

inline

Get the SourceID for this TriggerRecordHeader.

Returns

The element_id TriggerRecordHeaderData field

Definition at line 103 of file TriggerRecordHeader.hpp.

{ return header_()->element_id; }

get_header()

TriggerRecordHeaderData dunedaq::daqdataformats::TriggerRecordHeader::get_header ( ) const

inline

Definition at line 53 of file TriggerRecordHeader.hpp.

{ return *header_(); }

get_max_sequence_number()

trigger_number_t dunedaq::daqdataformats::TriggerRecordHeader::get_max_sequence_number ( ) const

inline

Definition at line 96 of file TriggerRecordHeader.hpp.

{ return header_()->max_sequence_number; }

get_num_requested_components()

uint64_t dunedaq::daqdataformats::TriggerRecordHeader::get_num_requested_components ( ) const

inline

Definition at line 61 of file TriggerRecordHeader.hpp.

  {
    return header_()->num_requested_components;
  }

get_run_number()

run_number_t dunedaq::daqdataformats::TriggerRecordHeader::get_run_number ( ) const

inline

Definition at line 66 of file TriggerRecordHeader.hpp.

{ return header_()->run_number; }

get_sequence_number()

trigger_number_t dunedaq::daqdataformats::TriggerRecordHeader::get_sequence_number ( ) const

inline

Definition at line 93 of file TriggerRecordHeader.hpp.

{ return header_()->sequence_number; }

get_status_bit()

bool dunedaq::daqdataformats::TriggerRecordHeader::get_status_bit ( TriggerRecordStatusBits bit ) const

inline

Get the value of the given status bit.

Parameters

bit	Bit to get

Returns

Value of bit (true/false)

Definition at line 77 of file TriggerRecordHeader.hpp.

{ return get_status_bits()[static_cast<size_t>(bit)]; }

get_status_bits()

std::bitset< 32 > dunedaq::daqdataformats::TriggerRecordHeader::get_status_bits ( ) const

inline

Definition at line 69 of file TriggerRecordHeader.hpp.

{ return header_()->status_bits; }

get_storage_location()

const void * dunedaq::daqdataformats::TriggerRecordHeader::get_storage_location ( ) const

inline

Get read-only access to the underlying flat data array.

Definition at line 117 of file TriggerRecordHeader.hpp.

{ return m_data_arr; }

get_total_size_bytes()

size_t dunedaq::daqdataformats::TriggerRecordHeader::get_total_size_bytes ( ) const

inline

Get the total size of the TriggerRecordHeader, including header and all component requests.

Definition at line 111 of file TriggerRecordHeader.hpp.

  {
    return header_()->num_requested_components * sizeof(ComponentRequest) + sizeof(TriggerRecordHeaderData);
  }

get_trigger_number()

trigger_number_t dunedaq::daqdataformats::TriggerRecordHeader::get_trigger_number ( ) const

inline

Definition at line 55 of file TriggerRecordHeader.hpp.

{ return header_()->trigger_number; }

get_trigger_timestamp()

timestamp_t dunedaq::daqdataformats::TriggerRecordHeader::get_trigger_timestamp ( ) const

inline

Definition at line 58 of file TriggerRecordHeader.hpp.

{ return header_()->trigger_timestamp; }

get_trigger_type()

trigger_type_t dunedaq::daqdataformats::TriggerRecordHeader::get_trigger_type ( ) const

inline

Definition at line 90 of file TriggerRecordHeader.hpp.

{ return header_()->trigger_type; }

header_()

TriggerRecordHeaderData * dunedaq::daqdataformats::TriggerRecordHeader::header_ ( ) const

inlineprivate

Get the TriggerRecordHeaderData from the m_data_arr array.

Returns

Pointer to the TriggerRecordHeaderData

Definition at line 163 of file TriggerRecordHeader.hpp.

{ return static_cast<TriggerRecordHeaderData*>(m_data_arr); }

operator=() [1/2]

TriggerRecordHeader & dunedaq::daqdataformats::TriggerRecordHeader::operator= ( TriggerRecordHeader && other )

inline

Definition at line 144 of file TriggerRecordHeader.hpp.

  {
    m_alloc = other.m_alloc;
    other.m_alloc = false;
    m_data_arr = other.m_data_arr;
    return *this;
  }

operator=() [2/2]

TriggerRecordHeader & dunedaq::daqdataformats::TriggerRecordHeader::operator= ( TriggerRecordHeader const & other )

inline

Definition at line 214 of file TriggerRecordHeader.hpp.

{
  if (&other == this)
    return *this;
 
  if (m_alloc) {
    free(m_data_arr); // NOLINT
  }
  m_data_arr = malloc(other.get_total_size_bytes()); // NOLINT
  if (m_data_arr == nullptr) {
    throw std::bad_alloc();
  }
  m_alloc = true;
  std::memcpy(m_data_arr, other.m_data_arr, other.get_total_size_bytes());
  return *this;
}

set_element_id()

void dunedaq::daqdataformats::TriggerRecordHeader::set_element_id ( SourceID source_id )

inline

Set the SourceID for this TriggerRecordHeader.

Parameters

source_id

SourceID value to set

Definition at line 108 of file TriggerRecordHeader.hpp.

{ header_()->element_id = source_id; }

set_max_sequence_number()

void dunedaq::daqdataformats::TriggerRecordHeader::set_max_sequence_number ( sequence_number_t number )

inline

Definition at line 97 of file TriggerRecordHeader.hpp.

{ header_()->max_sequence_number = number; }

set_run_number()

void dunedaq::daqdataformats::TriggerRecordHeader::set_run_number ( run_number_t run_number )

inline

Definition at line 67 of file TriggerRecordHeader.hpp.

{ header_()->run_number = run_number; }

set_sequence_number()

void dunedaq::daqdataformats::TriggerRecordHeader::set_sequence_number ( sequence_number_t number )

inline

Definition at line 94 of file TriggerRecordHeader.hpp.

{ header_()->sequence_number = number; }

set_status_bit()

void dunedaq::daqdataformats::TriggerRecordHeader::set_status_bit ( TriggerRecordStatusBits bit, bool value )

inline

Set the given status bit to the given value.

Parameters

bit	Bit to set
value	Value to set (true/false)

Definition at line 83 of file TriggerRecordHeader.hpp.

  {
    auto bits = get_status_bits();
    bits[static_cast<size_t>(bit)] = value;
    set_status_bits(bits);
  }

set_status_bits()

void dunedaq::daqdataformats::TriggerRecordHeader::set_status_bits ( std::bitset< 32 > bits )

inline

Definition at line 70 of file TriggerRecordHeader.hpp.

{ header_()->status_bits = bits.to_ulong(); }

set_trigger_number()

void dunedaq::daqdataformats::TriggerRecordHeader::set_trigger_number ( trigger_number_t trigger_number )

inline

Definition at line 56 of file TriggerRecordHeader.hpp.

{ header_()->trigger_number = trigger_number; }

set_trigger_timestamp()

void dunedaq::daqdataformats::TriggerRecordHeader::set_trigger_timestamp ( timestamp_t trigger_timestamp )

inline

Definition at line 59 of file TriggerRecordHeader.hpp.

{ header_()->trigger_timestamp = trigger_timestamp; }

set_trigger_type()

void dunedaq::daqdataformats::TriggerRecordHeader::set_trigger_type ( trigger_type_t trigger_type )

inline

Definition at line 91 of file TriggerRecordHeader.hpp.

{ header_()->trigger_type = trigger_type; }

Member Data Documentation

m_alloc

bool dunedaq::daqdataformats::TriggerRecordHeader::m_alloc { false }

private

Whether the TriggerRecordHeader owns the memory pointed by m_data_arr.

Definition at line 168 of file TriggerRecordHeader.hpp.

{ false }; 

m_data_arr

void* dunedaq::daqdataformats::TriggerRecordHeader::m_data_arr

private

Initial value:

{
    nullptr
  }

Flat memory containing a TriggerRecordHeaderData header and an array of ComponentRequests.

Definition at line 165 of file TriggerRecordHeader.hpp.

                  {
    nullptr
  }; 

---

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

• /github/workspace/dunedaq/sourcecode/daqdataformats/include/daqdataformats/TriggerRecordHeader.hpp