CPXgetqconstrname

int CPXPUBLIC CPXgetqconstrname(CPXCENVptr env, CPXCLPptr lp, char * buf_str, int bufspace, int * surplus_p, int which)

Definition file: cplex.h

Include files: cplex.h

The routine CPXgetqconstrname is used to access the name of a specified quadratic constraint of a CPLEX problem object.

Note

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

Example

 status = CPXgetqconstrname (env, lp, qname, lenqname,
                             &surplus, 5);

Parameters:

env	A pointer to the CPLEX environment as returned by `CPXopenCPLEX`.
lp	A pointer to a CPLEX problem object as returned by `CPXcreateprob`.
buf_str	A pointer to a buffer of size `bufspace`. May be NULL if `bufspace` is 0.
bufspace	An integer indicating the length of the array `buf_str`. May be 0.
surplus_p	A pointer to an integer to contain the difference between `bufspace` and the amount of memory required to store the quadratic cosntraint name. A nonnegative value of `surplus_p` indicates that the length of the array `buf_str` was sufficient. A negative value indicates that the length of the array was insufficient and that the routine could not complete its task. In this case, `CPXgetqconstrname` returns the value `CPXERR_NEGATIVE_SURPLUS`, and the negative value of the variable `surplus_p` indicates the amount of insufficient space in the array `buf_str`.
which	An integer indicating the index of the quadratic constraint for which the name is 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 buf_str array to hold the quadratic constraint name.