vec_iasum16() — Apollo Domain/OS SR10.4.1

VEC_$IASUM16                      Domain/OS                       VEC_$IASUM16


NAME
     vec_$iasum16 - sum the absolute value of the elements of a 16-bit integer
     vector

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

     long int vec_$iasum16(
          short int *vector,
          long int &length)

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

     function vec_$iasum16(
          in vector: univ vec_$integer16_vector;
          in length: integer32): integer32;

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

           parameter (nvec = 10)

           integer*2 vector(nvec), sum
           integer*4 length

           sum = vec_$iasum16(vector, length)

DESCRIPTION
     Vec_$iasum16 adds together the absolute value of length elements of the
     16-bit integer array vector and returns the sum.

     vector
          The vector to be summed.

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

NOTES
     When vec_$iasum16 is used to operate on matrixes in C and Pascal, vector
     is a row vector; in FORTRAN, it is a column vector.

     Vec_$iasum16, 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_$sum, vec_$norm, vec_$dot, vec_$asum, vec_$asum_i, vec_$dasum,
     vec_$dasum_i, vec_$iasum, vec_$iasum_i, vec_$iasum16_i.
Museum
