common_solver_option.h

#pragma once

#include <ostream>

namespace drake {
namespace solvers {
/**
 * Some options can be applied to not one solver, but many solvers (for example,
 * many solvers support printing out the progress in each iteration).
 * CommonSolverOption contain the names of these supported options.
 * The user can use these options as "key" in SolverOption::SetOption().
 */
enum class CommonSolverOption {
  /** Many solvers support printing the progress of each iteration to a file.
   * The user can call SolverOptions::SetOption(kPrintFileName, file_name) where
   * file_name is a string. If the user doesn't want to print to a file, then
   * use SolverOptions::SetOption(kPrintFileName, ""), where the empty string ""
   * indicates no print.
   */
  kPrintFileName,
  /** Many solvers support printing the progress of each iteration to the
   * console, the user can call SolverOptions::SetOption(kPrintToConsole, 1) to
   * turn on printing to the console, or
   * SolverOptions::SetOption(kPrintToConsole, 0) to turn off printing to the
   * console.
   */
  kPrintToConsole,
};

std::ostream& operator<<(std::ostream& os,
                         CommonSolverOption common_solver_option);
}  // namespace solvers
}  // namespace drake