Concurrency::affinity_partitioner Class Reference

The affinity_partitioner class is similar to the static_partitioner class, but it improves cache affinity by its choice of mapping subranges to worker threads. It can improve performance significantly when a loop is re-executed over the same data set, and the data fits in cache. Note that the same affinity_partitioner object must be used with subsequent iterations of a parallel loop that is executed over a particular data set, to benefit from data locality. More...

#include <ppl.h>

Public Member Functions
	affinity_partitioner ()
	Constructs an affinity_partitioner object. More...
	~affinity_partitioner ()
	Destroys an affinity_partitioner object. More...
location &	_Get_chunk_location (unsigned int _ChunkIndex)
template<class _Type >
_Type	_Get_num_chunks (_Type)

Private Member Functions
void	_Initialize_locations (unsigned int _Num_chunks)

Private Attributes
unsigned int	_M_num_chunks
location *	_M_pChunk_locations

Detailed Description

The affinity_partitioner class is similar to the static_partitioner class, but it improves cache affinity by its choice of mapping subranges to worker threads. It can improve performance significantly when a loop is re-executed over the same data set, and the data fits in cache. Note that the same affinity_partitioner object must be used with subsequent iterations of a parallel loop that is executed over a particular data set, to benefit from data locality.

Constructor & Destructor Documentation

Concurrency::affinity_partitioner::affinity_partitioner ( )

inline

Constructs an affinity_partitioner object.

                           : _M_num_chunks(0), _M_pChunk_locations(NULL)
    {
    }

Concurrency::affinity_partitioner::~affinity_partitioner ( )

inline

Destroys an affinity_partitioner object.

    {
        delete [] _M_pChunk_locations;
    }

Member Function Documentation

location& Concurrency::affinity_partitioner::_Get_chunk_location ( unsigned int  _ChunkIndex )

inline

    {
        return _M_pChunk_locations[_ChunkIndex];
    }

template<class _Type >

_Type Concurrency::affinity_partitioner::_Get_num_chunks ( _Type  )

inline

    {
        if (_M_num_chunks == 0)
        {
            _Initialize_locations(Concurrency::details::_CurrentScheduler::_GetNumberOfVirtualProcessors());
        }

        return static_cast<_Type>(_M_num_chunks);
    }

void Concurrency::affinity_partitioner::_Initialize_locations ( unsigned int  _Num_chunks )

inlineprivate

    {
        _M_num_chunks = _Num_chunks;
        _M_pChunk_locations = new location[_Num_chunks];
    }

Member Data Documentation

unsigned int Concurrency::affinity_partitioner::_M_num_chunks

private

location* Concurrency::affinity_partitioner::_M_pChunk_locations

private

---

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

• VS2013/inc/ppl.h