ncl_cpmviw (3) - Linux Manuals

ncl_cpmviw: Moves the contents of an old integer workspace to a new one.

NAME

CPMVIW - Moves the contents of an old integer workspace to a new one.

SYNOPSIS

CALL CPMVIW (IWKO, IWKN, LWKN)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_cpback (int *iwko, int *iwkn, int *lwkn)

DESCRIPTION

The arguments define the old and new integer workspaces.

IWKO

(an input array of type INTEGER, dimensioned as specified in the last call to CPRECT, CPSPS1, CPSPS2, or CPMVIW) is the old integer workspace array.

IWKN

(an output array of type INTEGER, dimensioned LWKN) is the new integer workspace array.

LWKN

(an input expression of type INTEGER) specifies the length of IWKN.

C-BINDING DESCRIPTION

The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

When, in the execution of a CONPACK routine, the amount of space left in the integer workspace array is found to be insufficient, if the internal parameter 'WSO' has the value 3, the error-handling routine SETER is called with an appropriate error message. If, in addition, the user has turned recovery mode on, execution continues and, eventually, control is returned to the user. At that point, the user should detect the fact that an error has occurred. If he/she chooses to try to recover from the error, CPMVIW may be of use: it may be called to move everything from the current integer workspace to a new (and presumably bigger) one, after which it may be possible to resume execution.

EXAMPLES

None, at present.

ACCESS

To use CPMVIW or c_cpmviw, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

MESSAGES

See the conpack man page for a description of all Conpack error messages and/or informational messages.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.