fn() computeSplitters

Compute splitters for a sequence of objects.

/*!
 * @fn computeSplitters
 * 
 * @headerfile <seqan/parallel.h>
 * 
 * @brief Compute splitters for a sequence of objects.
 * 
 * @signature void computeSplitters(splitters, size, count);
 * 
 * @param[out] splitters Resulting splitters, will be resized to contain
 *                       <tt>count + 1</tt> elements, e.g. an @link AllocString
 *                       @endlink of integers.
 * @param[in] size The number of objects to split.
 * @param[in] count The number of chunks.
 * 
 * @section Remarks
 * 
 * The first <tt>count - 1</tt> chunks will have the size <tt>ceil(size /
 * count)</tt>, the last chunk will contain the rest.
 * 
 * @section Examples
 * 
 * Most simple case for splitting.
 * 
 * @code{.cpp}
 * String<unsigned> splitters;
 * computeSplitters(splitters, 10, 5);
 * // splitters == {0, 5, 10}
 * @endcode
 * 
 * 
 * In this case, the last chunks will stay empty.
 * 
 * @code{.cpp}
 * computeSplitters(splitters, 3, 5);
 * // splitters == {0, 1, 2, 3, 3, 3}
 * @endcode
 */