CPXgetrowname

int CPXPUBLIC CPXgetrowname(CPXCENVptr env, CPXCLPptr lp, char ** name, char * namestore, int storespace, int * surplus_p, int begin, int end)

Definition file: cplex.h

Include files: cplex.h

The routine CPXgetrowname is used to access a range of row names or, equivalently, the constraint names of a CPLEX problem object. The beginning and end of the range, along with the length of the array in which the row names are to be returned, must be specified.

Note

If the value of storespace is 0, then the negative of the value of *surplus_p returned indicates the total number of characters needed for the array namestore.

Example

 status = CPXgetrowname (env, lp, cur_rowname, cur_rownamestore,
                         cur_storespace, &surplus, 0,
                         cur_numrows-1);

Parameters:

env	A pointer to the CPLEX environment as returned by `CPXopenCPLEX`.
lp	A pointer to a CPLEX problem object as returned by `CPXcreateprob`.
name	An array of pointers to the row names stored in the array `namestore`. This array must be of length at least (`end` - `begin+ 1`). The pointer to the name of row `i` is returned in `name[i-begin]`.
namestore	An array of characters where the specified row names are to be returned. May be NULL if `storespace` is 0.
storespace	An integer indicating the length of the array `namestore`. May be 0.
surplus_p	A pointer to an integer to contain the difference between `storespace` and the total amount of memory required to store the requested names. A nonnegative value of `surplus_p` indicates that `storespace` was sufficient. A negative value indicates that it was insufficient and that the routine could not complete its task. In that case, `CPXgetrowname` returns the value `CPXERR_NEGATIVE_SURPLUS`, and the negative value of the variable `surplus_p` indicates the amount of insufficient space in the array `namestore`.
begin	An integer indicating the beginning of the range of row names to be returned.
end	An integer indicating the end of the range of row names to be returned.

Returns:

The routine returns zero on success and nonzero if an error occurs. The value CPXERR_NEGATIVE_SURPLUS indicates that insufficient space was available in the namestore array to hold the names.