Class for performing a radix sort (fast comparison-less sort based on byte value) on various standard STL containers.
More...
template<class TContainer, class TContainerValueType, typename TCompValueType>
class Ogre::RadixSort< TContainer, TContainerValueType, TCompValueType >
Class for performing a radix sort (fast comparison-less sort based on byte value) on various standard STL containers.
- This is a template class to allow it to deal with a variety of containers, and a variety of value types to sort on. In addition to providing the container and value type on construction, you also need to supply a functor object which will retrieve the value to compare on for each item in the list. For example, if you had an std::vector of by-value instances of an object of class 'Bibble', and you wanted to sort on Bibble::getDoobrie(), you'd have to firstly create a functor like this:
struct BibbleSortFunctor
{
float operator()(const Bibble& val) const
{
return val.getDoobrie();
}
}
Then, you need to declare a RadixSort class which names the container type, the value type in the container, and the type of the value you want to sort by. You can then call the sort function. E.g.
BibbleSortFunctor functor;
radixSorter.
sort(myBibbleList, functor);
void sort(TContainer &container, TFunction func)
Main sort function.
You should try to reuse RadixSort instances, since repeated allocation of the internal storage is then avoided.
- Note
- Radix sorting is often associated with just unsigned integer values. Our implementation can handle both unsigned and signed integers, as well as floats (which are often not supported by other radix sorters). doubles are not supported; you will need to implement your functor object to convert to float if you wish to use this sort routine.
Definition at line 88 of file OgreRadixSort.h.
template<class TContainer, class TContainerValueType, typename TCompValueType>
template<class TFunction>
void Ogre::RadixSort< TContainer, TContainerValueType, TCompValueType >::sort |
( |
TContainer & | container, |
|
|
TFunction | func ) |
Main sort function.
- Parameters
-
container | A container of the type you declared when declaring |
func | A functor which returns the value for comparison when given a container value |
Definition at line 246 of file OgreRadixSort.h.
References finalPass(), getByte(), mCounters, mDest, mNumPasses, mSortArea1, mSortArea2, mSortSize, mSrc, mTmpContainer, and sortPass().
template<class TContainer, class TContainerValueType, typename TCompValueType>
void Ogre::RadixSort< TContainer, TContainerValueType, TCompValueType >::sortPass |
( |
int | byteIndex | ) |
|
|
protected |
template<class TContainer, class TContainerValueType, typename TCompValueType>
int Ogre::RadixSort< TContainer, TContainerValueType, TCompValueType >::mCounters[4][256] |
|
protected |