source: trunk/c++_tools/gslapi/utility.h @ 597

// $Id: utility.h 304 2005-05-02 14:10:50Z peter $

#ifndef _theplu_gslapi_utility_ 
#define _theplu_gslapi_utility_

#include <utility>

#include <c++_tools/gslapi/vector.h>


namespace theplu {
namespace gslapi {

  ///
  /// This function returns the indices of the minimum and maximum
  /// values in the sub-vector (defined by \a subset), storing them in
  /// imin and imax. When there are several equal minimum or maximum
  /// elements then the lowest indices are returned. The returned
  /// index is the index from the complete vector (not the sub-vector)
  ///
  /// @return Index corresponding to the smallest and largest value.
  ///
  /// @note If \a subset is emtpy, the result is undefined.
  ///
  std::pair<size_t,size_t> minmax_index(const vector& vec,
                                        const std::vector<size_t>& subset);

  ///
  /// Randomly shuffles the elements in vector \a invec
  ///
  void shuffle(vector& invec); 

}} // of namespace gslapi and namespace theplu

#endif