vitrio::strict_image_transfer_sanitizer Class Reference

A sanitizer that refuses every region that does not fit. More...

#include <vitrio/strict_image_transfer_sanitizer.hpp>

Inheritance diagram for vitrio::strict_image_transfer_sanitizer:

Collaboration diagram for vitrio::strict_image_transfer_sanitizer:

Public Member Functions
std::vector< image_transfer_plan >	sanitize (const image_transfer_plan &regions, span< const std::size_t > file_extents, span< const std::size_t > array_extents) const override
	Get the plans to transfer in place of a plan.
Public Member Functions inherited from vitrio::image_transfer_sanitizer
	image_transfer_sanitizer (const image_transfer_sanitizer &other)=delete
	image_transfer_sanitizer (image_transfer_sanitizer &&other)=delete
image_transfer_sanitizer &	operator= (const image_transfer_sanitizer &other)=delete
image_transfer_sanitizer &	operator= (image_transfer_sanitizer &&other)=delete

Static Public Member Functions
static const std::shared_ptr< const strict_image_transfer_sanitizer > &	get_shared ()
	Get the instance every use shares.

Detailed Description

A sanitizer that refuses every region that does not fit.

A plan whose regions all fit both sides is answered unchanged. A region reaching past the file or past the array is refused with std::out_of_range rather than shortened or dropped, so nothing of a plan is transferred unless all of it can be.

Member Function Documentation

get_shared()

static const std::shared_ptr< const strict_image_transfer_sanitizer > & vitrio::strict_image_transfer_sanitizer::get_shared ( )

static

Get the instance every use shares.

Returns

const std::shared_ptr<const strict_image_transfer_sanitizer>& The instance, never null.

sanitize()

std::vector< image_transfer_plan > vitrio::strict_image_transfer_sanitizer::sanitize ( const image_transfer_plan &  regions, span< const std::size_t >  file_extents, span< const std::size_t >  array_extents  ) const

overridevirtual

Get the plans to transfer in place of a plan.

Every region of every plan returned fits both sides. The plans have the file rank and the array rank of regions. Their extents may differ from those of regions and from one another, which is why more than one may be returned.

Parameters

regions	The regions asked for.
file_extents	Extents of the file. Must have the file rank of regions.
array_extents	Extents of the array. Must have the array rank of regions.

Returns

std::vector<image_transfer_plan> The plans to transfer. Empty when nothing is to be transferred.

Exceptions

std::invalid_argument	If either extents do not have the rank of the side they describe.
std::out_of_range	If a region that does not fit is refused.

Implements vitrio::image_transfer_sanitizer.

---

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

• vitrio/strict_image_transfer_sanitizer.hpp