vec_inorm() — Apollo

VEC_$INORM                        Domain/OS                         VEC_$INORM


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

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

     long int vec_$inorm(
          long int *start_vec,
          long int &length)

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

     function vec_$inorm(
          in start_vec: univ vec_$integer32_vector;
          in length: integer32): integer32;

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

           parameter (nvec = 10)

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

           norm = vec_$inorm(start_vec, length)

DESCRIPTION
     Vec_$inorm returns the squared norm (the sum of the squares of the ele-
     ments) of the vector start_vec.  It differs from vec_$norm in that the
     argument vector contains 32-bit integers.

     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.

NOTES
     When vec_$inorm 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.


SEE ALSO
     vec_$sum, vec_$asum, vec_$dot, vec_$norm_i, vec_$dnorm, vec_$dnorm_i,
     vec_$norm, vec_$inorm_i, vec_$inorm16, vec_$inorm16_i.
Museum
