Try our new documentation site (beta).

C Parameter Examples

The C interface defines a symbolic constant for each parameter. The symbolic constant name is prefixed by GRB_type_PAR_, where type is either INT, DBL, or STR. This is followed by the capitalized parameter name. For example, the symbolic constant for the integer Threads parameter (found in C header file gurobi_c.h) is:

#define GRB_INT_PAR_THREADS "Threads"

The routine you use to modify a parameter value depends on the type of the parameter. For a double-valued parameter, you would use GRBsetdblparam.

Recall that each model gets its own copy of the environment when it is created. Parameter changes to the original environment therefore have no effect on existing models. You'll need to use GRBgetenv to retrieve the environment associated with a particular model if you want to change a parameter for that model.

To set the TimeLimit parameter for a model, you'd do:

  error = GRBsetdblparam(GRBgetenv(model), GRB_DBL_PAR_TIMELIMIT, 100.0);

If you'd prefer to use a string for the parameter name, you can also do:

  error = GRBsetdblparam(GRBgetenv(model), "TimeLimit", 100.0);
The case of the string is ignored, as are underscores. Thus, TimeLimit and TIME_LIMIT are equivalent.

Use GRBgetdblparam to query the current value of a (double) parameter:

  double currentvalue;
  error = GRBgetdblparam(modelenv, "TimeLimit", &currentvalue);

Try Gurobi for Free

Choose the evaluation license that fits you best, and start working with our Expert Team for technical guidance and support.

Evaluation License
Get a free, full-featured license of the Gurobi Optimizer to experience the performance, support, benchmarking and tuning services we provide as part of our product offering.
Academic License
Gurobi supports the teaching and use of optimization within academic institutions. We offer free, full-featured copies of Gurobi for use in class, and for research.
Cloud Trial

Request free trial hours, so you can see how quickly and easily a model can be solved on the cloud.