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

    The Copy a Vector routine copies n elements of the vector x to
    the vector y.

    Format

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

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

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

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

      Use BLAS1$VSCOPY for single-precision real operations.
      Use BLAS1$VDCOPY for double-precision real (D or G) operations.

      Use BLAS1$VCCOPY for single-precision complex operations.
      Use BLAS1$VZCOPY for double-precision complex (D or G)
      operations.

1 - Returns

    None.

2 - Arguments

 n

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

    Number of elements in vector x to be copied. The n argument is
    the address of a signed longword integer containing the number of
    elements in vector x. If n is less than or equal to 0, then y is
    unchanged.

 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$VSCOPY       F-floating real
    BLAS1$VDCOPY       D-floating or G-floating real
    BLAS1$VCCOPY       F-floating complex
    BLAS1$VZCOPY       D-floating or G-floating complex

 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 or equal to 0, then x is
    referenced forward in array x; that is, xi 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, xi 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:       write only
    mechanism:    by reference, array reference

    Array that receives the copied elements. All elements of array y
    receive the copied elements 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$VSCOPY       F-floating real
    BLAS1$VDCOPY       D-floating or G-floating real
    BLAS1$VCCOPY       F-floating complex
    BLAS1$VZCOPY       D-floating or G-floating complex

    If n is less than or equal to 0, then y is unchanged. If incx
    is equal to 0, then each yi is set to x1. If incy is equal to
    0, then yi is set to the last referenced element of x. If any
    element of x shares a memory location with an element of y, the
    results are unpredictable.

 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

    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