CPXXcopybasednorms and CPXcopybasednorms

The routine CPXXcopybasednorms/CPXcopybasednorms works in conjunction with the routine CPXXgetbasednorms/CPXgetbasednorms.

int  CPXXcopybasednorms( CPXCENVptr env, CPXLPptr lp, int const * cstat, int const * rstat, double const * dnorm )

int  CPXcopybasednorms( CPXCENVptr env, CPXLPptr lp, int const * cstat, int const * rstat, double const * dnorm )

Description

Warning:

This is an advanced routine. Advanced routines typically demand a thorough understanding of the algorithms used by CPLEX. Thus they incur a higher risk of incorrect behavior in your application, behavior that can be difficult to debug. Therefore, the team encourages you to consider carefully whether you can accomplish the same task by means of other Callable Library routines instead.

The routine CPXXcopybasednorms/CPXcopybasednorms works in conjunction with the routine CPXXgetbasednorms/CPXgetbasednorms. CPXXcopybasednorms/CPXcopybasednorms copies the values in the arrays cstat, rstat, and dnorm, as returned by CPXXgetbasednorms/CPXgetbasednorms, into a specified problem object.

Each of the arrays cstat, rstat, and dnorm must be non NULL. Only data returned by CPXXgetbasednorms/CPXgetbasednorms should be copied by CPXXcopybasednorms/CPXcopybasednorms. (Other details of cstat, rstat, and dnorm are not documented.)

Important: The routine CPXXcopybasednorms/CPXcopybasednorms should be called only if the return values of CPXXgetnumrows/CPXgetnumrows and CPXXgetnumcols/CPXgetnumcols have not changed since the companion call to CPXXgetbasednorms/CPXgetbasednorms. If either of these values has increased since that companion call, a memory violation may occur. If one of those values has decreased, the call will be safe, but its meaning will be undefined.

Arguments

env
The pointer to the CPLEX environment, as returned by CPXXopenCPLEX/CPXopenCPLEX.
lp
A pointer to the CPLEX LP problem object, as returned by CPXXcreateprob/CPXcreateprob.
cstat
An array containing the basis status of the columns in the constraint matrix returned by a call to CPXXgetbasednorms/CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXXgetnumcols/CPXgetnumcols.
rstat
An array containing the basis status of the rows in the constraint matrix returned by a call to CPXXgetbasednorms/CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXXgetnumrows/CPXgetnumrows.
dnorm
An array containing the dual steepest-edge norms returned by a call to CPXXgetbasednorms/CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXXgetnumrows/CPXgetnumrows.

Return

The routine returns 0 (zero) if successful and nonzero if an error occurs.