6.25 psb_sp_getrow — Extract row(s) from a sparse matrix

call psb_sp_getrow(row, a, nz, ia, ja, val, info, &
              & append, nzin, lrw)

Type:

Asynchronous.

On Entry

row

The (first) row to be extracted.
Scope:local
Type:required
Intent: in.
Specified as: an integer > 0.

a

the matrix from which to get rows.
Scope:local
Type:required
Intent: in.
Specified as: a structured data of type psb_Tspmat_type.

append

Whether to append or overwrite existing output.
Scope:local
Type:optional
Intent: in.
Specified as: a logical value default: false (overwrite).

nzin

Input size to be appended to.
Scope:local
Type:optional
Intent: in.
Specified as: an integer > 0. When append is true, specifies how many entries in the output vectors are already filled.

lrw

The last row to be extracted.
Scope:local
Type:optional
Intent: in.
Specified as: an integer > 0, default: row.

On Return

nz

the number of elements returned by this call.
Scope:local.
Type:required.
Intent: out.
Returned as: an integer scalar.

ia

the row indices.
Scope:local.
Type:required.
Intent: inout.
Specified as: an integer array with the ALLOCATABLE attribute.

ja

the column indices of the elements to be inserted.
Scope:local.
Type:required.
Intent: inout.
Specified as: an integer array with the ALLOCATABLE attribute.

val

the elements to be inserted.
Scope:local.
Type:required.
Intent: inout.
Specified as: a real array with the ALLOCATABLE attribute.

info

Error code.
Scope: local
Type: required
Intent: out.
An integer value; 0 means no error has been detected.

Notes

1. The output nz is always the size of the output generated by the current call; thus, if append=.true., the total output size will be nzin + nz, with the newly extracted coefficients stored in entries nzin+1:nzin+nz of the array arguments;
2. When append=.true. the output arrays are reallocated as necessary;
3. The row and column indices are returned in the local numbering scheme; if the global numbering is desired, the user may employ the psb_loc_to_glob routine on the output.