VEC_$INORM16                      Domain/OS                       VEC_$INORM16


NAME
     vec_$inorm16 - squared norm (sum the squares of the elements) a 16-bit
     integer vector

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

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

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

     function vec_$inorm16(
          in start_vec: univ vec_$integer16_vector;
          in length: integer32): integer16;

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

           parameter (nvec = 10)

           integer*2 start_vec(nvec), norm
           integer*4 length

           norm = vec_$inorm16(start_vec, length)

DESCRIPTION
     Vec_$inorm16 returns the squared norm (the sum of the squares of the ele-
     ments) of the vector start_vec.

     start_vec
          The vector whose squared norm you want.

     length
          The number of elements to be operated on;  normally the same as the
          number of elements in the vector.  It differs from vec_$norm in that
          the argument vector contains 16-bit integers.

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

     As in all the vec_$ calls,  the result array must not overlap any of the
     input arrays; the result array may be identical to an input, but must not
     contain any subset  of it.   Because of pipelining, using overlapping
     input and output arrays may cause incorrect results.

     Vec_$inorm16, 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_$asum, vec_$dot, vec_$norm_i, vec_$dnorm, vec_$dnorm_i,
     vec_$norm, vec_$inorm_i, vec_$norm, vec_$inorm16_i.