NO FRAMES

CPXcopybasednorms

int CPXPUBLIC CPXcopybasednorms(CPXCENVptr env, CPXLPptr lp, const int * cstat, const int * rstat, const double * dnorm)
Definition file: cplex.h
Include files: cplex.h
Note

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

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

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

Note
The routine CPXcopybasednorms should be called only if the return values of CPXgetnumrows and CPXgetnumcols have not changed since the companion call to 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.

See Also:

Parameters:

env

The pointer to the ILOG CPLEX environment, as returned by CPXopenCPLEX.

lp

A pointer to the CPLEX LP problem object, as returned by CPXcreateprob.

cstat

An array containing the basis status of the columns in the constraint matrix returned by a call to CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXgetnumcols.

rstat

An array containing the basis status of the rows in the constraint matrix returned by a call to CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXgetnumrows.

dnorm

An array containing the dual steepest-edge norms returned by a call to CPXgetbasednorms. The length of the allocated array must be at least the value returned by CPXgetnumrows.

Returns:

The routine returns zero on success and nonzero if an error occurs.