sgthr (3p)

Name

sgthr - Gathers specified elements from y into x.

Synopsis

SUBROUTINE SGTHR(NZ, Y, X, INDX)

REAL Y(*), X(*)
INTEGER NZ
INTEGER INDX(*)

SUBROUTINE SGTHR_64(NZ, Y, X, INDX)

REAL Y(*), X(*)
INTEGER*8 NZ
INTEGER*8 INDX(*)


F95 INTERFACE
SUBROUTINE GTHR(NZ, Y, X, INDX)

REAL, DIMENSION(:) :: Y, X
INTEGER :: NZ
INTEGER, DIMENSION(:) :: INDX

SUBROUTINE GTHR_64(NZ, Y, X, INDX)

REAL, DIMENSION(:) :: Y, X
INTEGER(8) :: NZ
INTEGER(8), DIMENSION(:) :: INDX





C INTERFACE
#include <sunperf.h>

void sgthr (const int nz, const float* y, float* x, const int* indx);

void sgthr_64 (const long nz, const float* y, float* x, const long*
indx);

Description

Oracle Solaris Studio Performance Library                            sgthr(3P)



NAME
       sgthr - Gathers specified elements from y into x.

SYNOPSIS
        SUBROUTINE SGTHR(NZ, Y, X, INDX)

        REAL Y(*), X(*)
        INTEGER NZ
        INTEGER INDX(*)

        SUBROUTINE SGTHR_64(NZ, Y, X, INDX)

        REAL Y(*), X(*)
        INTEGER*8 NZ
        INTEGER*8 INDX(*)


   F95 INTERFACE
        SUBROUTINE GTHR(NZ, Y, X, INDX)

        REAL, DIMENSION(:) :: Y, X
        INTEGER :: NZ
        INTEGER, DIMENSION(:) :: INDX

        SUBROUTINE GTHR_64(NZ, Y, X, INDX)

        REAL, DIMENSION(:) :: Y, X
        INTEGER(8) :: NZ
        INTEGER(8), DIMENSION(:) :: INDX





   C INTERFACE
       #include <sunperf.h>

       void sgthr (const int nz, const float* y, float* x, const int* indx);

       void sgthr_64 (const long nz, const float* y, float* x, const long*
                 indx);




PURPOSE
       SGTHR - Gathers the specified elements from a vector y in full storage
       form into a vector x in compressed form.  Only the elements of y whose
       indices are listed in indx are referenced.

        do i = 1, n
          x(i) = y(indx(i))
        enddo


ARGUMENTS
       NZ (input) - INTEGER
               Number of elements in the compressed form.  Unchanged on exit.

       Y (input)
               Vector in full storage form.  Unchanged on exit.

       X (output)
               Vector in compressed form.  Contains elements of y whose
               indices are listed in indx on exit.

       INDX (input) - INTEGER
               Vector containing the indices of the compressed form.  It is
               assumed that the elements in INDX are distinct and greater than
               zero.  Unchanged on exit.



3rd Berkeley Distribution         7 Nov 2015                         sgthr(3P)