VEC_$IAMAX16                      Domain/OS                       VEC_$IAMAX16


NAME
     vec_$iamax16 - find the maximum absolute value in a 16-bit integer vector

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/vec.h>

     long int vec_$iamax16(
          short int *start_vec,
          long int &length,
          short int *result)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/vec.ins.pas';

     function vec_$iamax16(
          in start_vec: univ vec_$integer16_vector;
          in length: integer32;
          out result: integer16): integer32;

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/vec.ins.ftn'

           parameter (nvec = 10)

           integer*2 start_vec(nvec), result
           integer*4 length, location

           location = vec_$iamax16(start_vec, length, result)

DESCRIPTION
     Vec_$iamax16 searches through length elements of start_vec, places the
     greatest absolute-valued element in result, and returns the location of
     the element with the greatest absolute value. By contrast, vec_$irmax16
     finds the element with greatest signed value.  (The procedure vec_$imax16
     is obsolete and should not be used.)  Vec_$iamax16 differs from vec_$amax
     in that the argument vector contains 16-bit integers.  In the case of a
     tie, vec_$iamax16 returns the index of the first maximum value found.

     start_vec
          The vector to be searched.

     length
          The number of elements to be operated on;  normally the same as the
          number of elements in the vectors.

     result
          The value of the greatest element in start_vec.

NOTES
     In C and Pascal, vec_$iamax16 searches a row vector; in FORTRAN, it
     searches a column vector.

     Vec_$iamax16, like all 16-bit integer routines, performs poorly when com-
     pared to the 32-bit integer routines.  Its use should be avoided wherever
     possible, especially on high-performance workstations.

SEE ALSO
     vec_$rmax, vec_$rmin, vec_$amin, vec_$amax_i, vec_$damax, vec_$damax_i,
     vec_$amax, vec_$iamax_i, vec_$iamax, vec_$iamax16_i.