CPXgetobjname

The routine CPXgetobjname accesses the name of the objective row 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 = CPXgetobjname (env, lp, cur_objname, lenname,
                         &surplus);

A pointer to the CPLEX environment as returned by CPXopenCPLEX.

A pointer to a CPLEX problem object as returned by CPXcreateprob.

A pointer to a buffer of size bufspace. May be NULL if bufspace is 0.

An integer indicating the length of the array buf_str. May be 0.

A pointer to an integer to contain the difference between bufspace and the amount of memory required to store the objective row 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, CPXgetobjname 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.

The routine returns zero if successful 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 objective name.

CPXgetobjname

Parameters:

Returns:

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 objective row 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, `CPXgetobjname` 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`.