VMS Help RTL Routines, MTH$, BLAS1$VxDOTx  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Obtain the Inner Product of Two Vectors routine returns the
    dot product of two n-element vectors, x and y.

    Format

      BLAS1$VSDOT  n ,x ,incx ,y ,incy

      BLAS1$VDDOT  n ,x ,incx ,y ,incy

      BLAS1$VGDOT  n ,x ,incx ,y ,incy

      BLAS1$VCDOTU  n ,x ,incx ,y ,incy

      BLAS1$VCDOTC  n ,x ,incx ,y ,incy

      BLAS1$VZDOTU  n ,x ,incx ,y ,incy

      BLAS1$VWDOTU  n ,x ,incx ,y ,incy

      BLAS1$VZDOTC  n ,x ,incx ,y ,incy

      BLAS1$VWDOTC  n ,x ,incx ,y ,incy

      Use BLAS1$VSDOT to obtain the inner product of two single-
      precision real vectors.

      Use BLAS1$VDDOT to obtain the inner product of two double-
      precision (D-floating) real vectors. Use BLAS1$VGDOT to obtain
      the inner product of two double-precision (G-floating) real
      vectors.

      Use BLAS1$VCDOTU to obtain the inner product of two single-
      precision complex vectors (unconjugated).

      Use BLAS1$VCDOTC to obtain the inner product of two single-
      precision complex vectors (conjugated).

      Use BLAS1$VZDOTU to obtain the inner product of two double-
      precision (D-floating) complex vectors (unconjugated). Use
      BLAS1$VWDOTU to obtain the inner product of two double-
      precision (G-floating) complex vectors (unconjugated).

      Use BLAS1$VZDOTC to obtain the inner product of two double-
      precision (D-floating) complex vectors (conjugated). Use
      BLAS1$VWDOTC to obtain the inner product of two double-
      precision (G-floating) complex vectors (conjugated).

1 - Returns

    OpenVMS usage:floating_point or complex_number
    type:         F_floating, D_floating, G_floating real or
                  F_floating, D_floating, G_floating complex
    access:       write only
    mechanism:    by value

    The function value, called dotpr, is the dot product of two n-
    element vectors, x and y. Specify the same data type for dotpr
    and the argument x.

2 - Arguments

 n

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Number of elements in vector x. The n argument is the address of
    a signed longword integer containing the number of elements. If
    you specify a value for n that is less than or equal to 0, then
    the value of dotpr is 0.0.

 x

    OpenVMS usage:floating_point or complex_number
    type:         F_floating, D_floating, G_floating real or
                  F_floating, D_floating, G_floating complex
    access:       read only
    mechanism:    by reference, array reference

    Array containing the elements to be accessed. All elements of
    array x are accessed only if the increment argument of x, called
    incx, is 1. The x argument is the address of a floating-point or
    floating-point complex number that is this array. This argument
    is an array of length at least:

    1+(n-1)*|incx|

    where:

    n   =  number of vector elements specified in n
    incx=  increment argument for the array x specified in incx

    Specify the data type as follows:

    Routine            Data Type for x

    BLAS1$VSDOT        F-floating real
    BLAS1$VDDOT        D-floating real
    BLAS1$VGDOT        G-floating real
    BLAS1$VCDOTU and   F-floating complex
    BLAS1$VCDOTC
    BLAS1$VZDOTU and   D-floating complex
    BLAS1$VZDOTC
    BLAS1$VWDOTU and   G-floating complex
    BLAS1$VWDOTC

 incx

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Increment argument for the array x. The incx argument is the
    address of a signed longword integer containing the increment
    argument. If incx is greater than 0, then x is referenced forward
    in array x; that is, x[i] is referenced in:

    x(1+(i-1)*incx)

    where:

    x   =  array specified in x
    i   =  element of the vector x
    incx=  increment argument for the array x specified in incx

    If incx is less than 0, then x is referenced backward in array x;
    that is, x[i] is referenced in:

    x(1+(n-i)*|incx|)

    where:

    x   =  array specified in x
    n   =  number of vector elements specified in n
    i   =  element of the vector x
    incx=  increment argument for the array x specified in incx

 y

    OpenVMS usage:floating_point or complex_number
    type:         F_floating, D_floating, G_floating real or
                  F_floating, D_floating, G_floating complex
    access:       read only
    mechanism:    by reference, array reference

    Array containing the elements to be accessed. All elements of
    array y are accessed only if the increment argument of y, called
    incy, is 1. The y argument is the address of a floating-point or
    floating-point complex number that is this array. This argument
    is an array of length at least:

    1+(n-1)*|incy|

    where:

    n   =  number of vector elements specified in n
    incy=  increment argument for the array y specified in incy

    Specify the data type as follows:

    Routine            Data Type for y

    BLAS1$VSDOT        F-floating real
    BLAS1$VDDOT        D-floating real
    BLAS1$VGDOT        G-floating real
    BLAS1$VCDOTU and   F-floating complex
    BLAS1$VCDOTC
    BLAS1$VZDOTU and   D-floating complex
    BLAS1$VZDOTC
    BLAS1$VWDOTU and   G-floating complex
    BLAS1$VWDOTC

 incy

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Increment argument for the array y. The incy argument is the
    address of a signed longword integer containing the increment
    argument. If incy is greater than or equal to 0, then y is
    referenced forward in array y; that is, y[i] is referenced in:

    y(1+(i-1)*incy)

    where:

    y   =  array specified in y
    i   =  element of the vector y
    incy=  increment argument for the array y specified in incy

    If incy is less than 0, then y is referenced backward in array y;
    that is, y[i] is referenced in:

    y(1+(n-i)*|incy|)

    where:

    y   =  array specified in y
    n   =  number of vector elements specified in n
    i   =  element of the vector y
    incy=  increment argument for the array y specified in incy