public methods for user interface dialogs
SCIP_DIALOG* SCIPdialoghdlrGetRoot | ( | SCIP_DIALOGHDLR * | dialoghdlr | ) |
returns the root dialog of the dialog handler
dialoghdlr | dialog handler |
Definition at line 427 of file dialog.c.
References SCIP_Dialoghdlr::rootdialog.
Referenced by dialogExecMenu(), SCIP_DECL_DIALOGEXEC(), SCIPaddDialogEntry(), and SCIPgetRootDialog().
void SCIPdialoghdlrClearBuffer | ( | SCIP_DIALOGHDLR * | dialoghdlr | ) |
clears the input command buffer of the dialog handler
dialoghdlr | dialog handler |
Definition at line 437 of file dialog.c.
References SCIP_Dialoghdlr::buffer, and SCIP_Dialoghdlr::bufferpos.
Referenced by dialogExecMenu(), SCIP_DECL_DIALOGEXEC(), SCIPdialoghdlrCreate(), SCIPdialoghdlrExec(), SCIPdialoghdlrGetLine(), SCIPdialoghdlrGetWord(), and writeProblem().
SCIP_Bool SCIPdialoghdlrIsBufferEmpty | ( | SCIP_DIALOGHDLR * | dialoghdlr | ) |
returns TRUE iff input command buffer is empty
dialoghdlr | dialog handler |
Definition at line 448 of file dialog.c.
References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, and SCIP_Dialoghdlr::buffersize.
Referenced by SCIP_DECL_DIALOGEXEC(), SCIPdialoghdlrGetLine(), and SCIPdialoghdlrGetWord().
SCIP_RETCODE SCIPdialoghdlrGetLine | ( | SCIP_DIALOGHDLR * | dialoghdlr, |
SCIP_DIALOG * | dialog, | ||
const char * | prompt, | ||
char ** | inputline, | ||
SCIP_Bool * | endoffile | ||
) |
returns the next line in the handler's command buffer; if the buffer is empty, displays the given prompt or the current dialog's path and asks the user for further input; the user must not free or modify the returned string
dialoghdlr | dialog handler |
dialog | current dialog |
prompt | prompt to display, or NULL to display the current dialog's path |
inputline | pointer to store the complete line in the handler's command buffer |
endoffile | pointer to store whether the end of the input file was reached |
Definition at line 461 of file dialog.c.
References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, FALSE, readInputLine(), SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPdialogGetPath(), SCIPdialoghdlrAddHistory(), SCIPdialoghdlrClearBuffer(), SCIPdialoghdlrIsBufferEmpty(), SCIPsnprintf(), and TRUE.
Referenced by SCIP_DECL_DIALOGEXEC().
SCIP_RETCODE SCIPdialoghdlrGetWord | ( | SCIP_DIALOGHDLR * | dialoghdlr, |
SCIP_DIALOG * | dialog, | ||
const char * | prompt, | ||
char ** | inputword, | ||
SCIP_Bool * | endoffile | ||
) |
returns the next word in the handler's command buffer; if the buffer is empty, displays the given prompt or the current dialog's path and asks the user for further input; the user must not free or modify the returned string
dialoghdlr | dialog handler |
dialog | current dialog |
prompt | prompt to display, or NULL to display the current dialog's path |
inputword | pointer to store the next word in the handler's command buffer |
endoffile | pointer to store whether the end of the input file was reached |
Definition at line 538 of file dialog.c.
References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, FALSE, readInputLine(), SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPdebugMessage, SCIPdialogGetPath(), SCIPdialoghdlrAddHistory(), SCIPdialoghdlrClearBuffer(), SCIPdialoghdlrIsBufferEmpty(), and SCIPsnprintf().
Referenced by dialogExecMenu(), SCIP_DECL_DIALOGEXEC(), and writeProblem().
SCIP_RETCODE SCIPdialoghdlrAddInputLine | ( | SCIP_DIALOGHDLR * | dialoghdlr, |
const char * | inputline | ||
) |
adds a single line of input to the dialog handler which is treated as if the user entered the command line
dialoghdlr | dialog handler |
inputline | input line to add |
Definition at line 689 of file dialog.c.
References BMSallocMemory, BMSduplicateMemoryArray, BMSfreeMemory, SCIP_Linelist::inputline, SCIP_Dialoghdlr::inputlistptr, SCIP_Linelist::nextline, SCIP_ALLOC, SCIP_ALLOC_TERMINATE, and SCIP_OKAY.
Referenced by SCIPaddDialogInputLine().
SCIP_RETCODE SCIPdialoghdlrAddHistory | ( | SCIP_DIALOGHDLR * | dialoghdlr, |
SCIP_DIALOG * | dialog, | ||
const char * | command, | ||
SCIP_Bool | escapecommand | ||
) |
adds a command to the command history of the dialog handler; if a dialog is given, the command is preceeded by the dialog's command path; if no command is given, only the path to the dialog is added to the command history
dialoghdlr | dialog handler |
dialog | current dialog, or NULL |
command | command string to add to the command history, or NULL |
escapecommand | should special characters in command be prefixed by an escape char? |
Definition at line 718 of file dialog.c.
References addHistory(), getHistoryLength(), SCIP_Dialog::name, SCIP_Dialoghdlr::nprotectedhistelems, SCIP_Dialog::parent, removeHistory(), SCIP_Dialoghdlr::rootdialog, SCIP_Bool, SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPescapeString(), and SCIPsnprintf().
Referenced by SCIP_DECL_DIALOGEXEC(), SCIPaddDialogHistoryLine(), SCIPdialoghdlrGetLine(), SCIPdialoghdlrGetWord(), and writeProblem().
SCIP_Bool SCIPdialogHasEntry | ( | SCIP_DIALOG * | dialog, |
const char * | entryname | ||
) |
returns TRUE iff a dialog entry matching exactly the given name is existing in the given dialog
dialog | dialog |
entryname | name of the dialog entry to find |
Definition at line 988 of file dialog.c.
References FALSE, SCIPdialogGetName(), SCIPdialogGetNSubdialogs(), SCIPdialogGetSubdialogs(), and TRUE.
Referenced by addFixParamDialog(), addSetParamDialog(), createCountDialog(), createEmphasisSubmenu(), SCIPdialogAddEntry(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), and SCIPincludeObjDialog().
int SCIPdialogFindEntry | ( | SCIP_DIALOG * | dialog, |
const char * | entryname, | ||
SCIP_DIALOG ** | subdialog | ||
) |
searches the dialog for entries corresponding to the given name; If a complete match is found, the entry is returned as "subdialog" and the return value is 1. If no dialog entry completely matches the given "entryname", the number of entries with names beginning with "entryname" is returned. If this number is 1, the single match is returned as "subdialog". Otherwise, "subdialog" is set to NULL.
dialog | dialog |
entryname | name of the dialog entry to find |
subdialog | pointer to store the found dialog entry |
Definition at line 1021 of file dialog.c.
References SCIPdialogGetName(), SCIPdialogGetNSubdialogs(), and SCIPdialogGetSubdialogs().
Referenced by addFixParamDialog(), addSetParamDialog(), createCountDialog(), createEmphasisSubmenu(), dialogExecMenu(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), and SCIPincludeDialogDefaultSet().
SCIP_RETCODE SCIPdialogDisplayMenu | ( | SCIP_DIALOG * | dialog, |
SCIP * | scip | ||
) |
displays the dialog's menu
dialog | dialog |
scip | SCIP data structure |
Definition at line 1065 of file dialog.c.
References SCIP_Dialog::nsubdialogs, SCIP_CALL, SCIP_OKAY, SCIPdialogDisplayMenuEntry(), SCIPdialogIsSubmenu(), SCIPdialogMessage(), and SCIP_Dialog::subdialogs.
Referenced by SCIP_DECL_DIALOGEXEC().
SCIP_RETCODE SCIPdialogDisplayMenuEntry | ( | SCIP_DIALOG * | dialog, |
SCIP * | scip | ||
) |
displays the entry for the dialog in it's parent's menu
dialog | dialog |
scip | SCIP data structure |
Definition at line 1099 of file dialog.c.
References SCIP_Dialog::desc, SCIP_Dialog::issubmenu, SCIP_Dialog::name, SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPdialogMessage(), and SCIPsnprintf().
Referenced by SCIPdialogDisplayCompletions(), and SCIPdialogDisplayMenu().
SCIP_RETCODE SCIPdialogDisplayCompletions | ( | SCIP_DIALOG * | dialog, |
SCIP * | scip, | ||
const char * | entryname | ||
) |
displays all dialog entries with names starting with the given "entryname"
dialog | dialog |
scip | SCIP data structure |
entryname | name of the dialog entry to find |
Definition at line 1133 of file dialog.c.
References SCIP_CALL, SCIP_OKAY, SCIPdialogDisplayMenuEntry(), SCIPdialogGetName(), SCIPdialogGetNSubdialogs(), and SCIPdialogGetSubdialogs().
Referenced by dialogExecMenu().
void SCIPdialogGetPath | ( | SCIP_DIALOG * | dialog, |
const char | sepchar, | ||
char * | path | ||
) |
gets the name of the current path in the dialog tree, separated by the given character
dialog | dialog |
sepchar | separation character to insert in path |
path | string buffer to store the path |
Definition at line 1164 of file dialog.c.
References SCIP_Dialog::name, SCIP_Dialog::parent, SCIP_MAXSTRLEN, and SCIPsnprintf().
Referenced by SCIPdialoghdlrGetLine(), and SCIPdialoghdlrGetWord().
const char* SCIPdialogGetName | ( | SCIP_DIALOG * | dialog | ) |
gets the command name of the dialog
dialog | dialog |
Definition at line 1188 of file dialog.c.
References SCIP_Dialog::name.
Referenced by SCIP_DECL_SORTPTRCOMP(), SCIPdialogAddEntry(), SCIPdialogCopyInclude(), SCIPdialogDisplayCompletions(), SCIPdialogFindEntry(), and SCIPdialogHasEntry().
const char* SCIPdialogGetDesc | ( | SCIP_DIALOG * | dialog | ) |
gets the description of the dialog
dialog | dialog |
Definition at line 1198 of file dialog.c.
References SCIP_Dialog::desc.
SCIP_Bool SCIPdialogIsSubmenu | ( | SCIP_DIALOG * | dialog | ) |
returns whether the dialog is a sub menu
dialog | dialog |
Definition at line 1208 of file dialog.c.
References SCIP_Dialog::issubmenu.
Referenced by SCIPdialogDisplayMenu().
SCIP_DIALOG* SCIPdialogGetParent | ( | SCIP_DIALOG * | dialog | ) |
gets the parent dialog of the given dialog
dialog | dialog |
Definition at line 1218 of file dialog.c.
References SCIP_Dialog::parent.
Referenced by dialogExecMenu(), and SCIP_DECL_DIALOGEXEC().
SCIP_DIALOG** SCIPdialogGetSubdialogs | ( | SCIP_DIALOG * | dialog | ) |
gets the array of sub-dialogs associated with the given dialog
dialog | dialog |
Definition at line 1228 of file dialog.c.
References SCIP_Dialog::subdialogs.
Referenced by SCIPdialogDisplayCompletions(), SCIPdialogFindEntry(), and SCIPdialogHasEntry().
int SCIPdialogGetNSubdialogs | ( | SCIP_DIALOG * | dialog | ) |
gets the number of sub-dialogs associated with the given dialog
dialog | dialog |
Definition at line 1238 of file dialog.c.
References SCIP_Dialog::nsubdialogs.
Referenced by SCIPdialogDisplayCompletions(), SCIPdialogFindEntry(), and SCIPdialogHasEntry().
SCIP_DIALOGDATA* SCIPdialogGetData | ( | SCIP_DIALOG * | dialog | ) |
gets the user defined data associated with the given dialog
dialog | dialog |
Definition at line 1248 of file dialog.c.
References SCIP_Dialog::dialogdata.
Referenced by SCIP_DECL_DIALOGCOPY(), SCIP_DECL_DIALOGDESC(), SCIP_DECL_DIALOGEXEC(), and SCIP_DECL_DIALOGFREE().
void SCIPdialogSetData | ( | SCIP_DIALOG * | dialog, |
SCIP_DIALOGDATA * | dialogdata | ||
) |
sets user data of dialog; user has to free old data in advance!
dialog | dialog |
dialogdata | new dialog user data |
Definition at line 1258 of file dialog.c.
References SCIP_Dialog::dialogdata.
Referenced by SCIP_DECL_DIALOGFREE().
SCIP_RETCODE SCIPdialogWriteHistory | ( | const char * | filename | ) |
writes command history to specified filename
filename | file name for (over)writing history |
Definition at line 1269 of file dialog.c.
References writeHistory().
Referenced by SCIP_DECL_DIALOGEXEC().
SCIP_RETCODE SCIPincludeDialog | ( | SCIP * | scip, |
SCIP_DIALOG ** | dialog, | ||
SCIP_DECL_DIALOGCOPY((*dialogcopy)) | , | ||
SCIP_DECL_DIALOGEXEC((*dialogexec)) | , | ||
SCIP_DECL_DIALOGDESC((*dialogdesc)) | , | ||
SCIP_DECL_DIALOGFREE((*dialogfree)) | , | ||
const char * | name, | ||
const char * | desc, | ||
SCIP_Bool | issubmenu, | ||
SCIP_DIALOGDATA * | dialogdata | ||
) |
creates and includes dialog
scip | SCIP data structure |
dialog | pointer to store the dialog |
name | name of dialog: command name appearing in parent's dialog menu |
desc | description of dialog used if description output method is NULL |
issubmenu | is the dialog a submenu? |
dialogdata | user defined dialog data |
Definition at line 9715 of file scip.c.
References SCIP_CALL, SCIP_INVALIDDATA, SCIP_OKAY, SCIPdialogCreate(), SCIPerrorMessage, SCIPexistsDialog(), SCIPsetIncludeDialog(), and Scip::set.
Referenced by addFixParamDialog(), addSetParamDialog(), createCountDialog(), createEmphasisSubmenu(), SCIPcreateRootDialog(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), and SCIPincludeObjDialog().
SCIP_Bool SCIPexistsDialog | ( | SCIP * | scip, |
SCIP_DIALOG * | dialog | ||
) |
returns if the dialog already exists
returns if the dialog already exists
scip | SCIP data structure |
dialog | dialog |
Definition at line 9748 of file scip.c.
References SCIPsetExistsDialog(), and Scip::set.
Referenced by SCIPincludeDialog().
SCIP_RETCODE SCIPcaptureDialog | ( | SCIP * | scip, |
SCIP_DIALOG * | dialog | ||
) |
captures a dialog
scip | SCIP data structure |
dialog | dialog |
Definition at line 9763 of file scip.c.
References SCIP_OKAY, and SCIPdialogCapture().
SCIP_RETCODE SCIPreleaseDialog | ( | SCIP * | scip, |
SCIP_DIALOG ** | dialog | ||
) |
releases a dialog
scip | SCIP data structure |
dialog | pointer to the dialog |
Definition at line 9780 of file scip.c.
References SCIP_CALL, SCIP_OKAY, and SCIPdialogRelease().
Referenced by addFixParamDialog(), addSetParamDialog(), createCountDialog(), createEmphasisSubmenu(), SCIPcreateRootDialog(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), and SCIPincludeObjDialog().
SCIP_RETCODE SCIPsetRootDialog | ( | SCIP * | scip, |
SCIP_DIALOG * | dialog | ||
) |
makes given dialog the root dialog of SCIP's interactive user shell; captures dialog and releases former root dialog
scip | SCIP data structure |
dialog | dialog to be the root |
Definition at line 9797 of file scip.c.
References Scip::dialoghdlr, SCIP_CALL, SCIP_OKAY, and SCIPdialoghdlrSetRoot().
Referenced by SCIPcreateRootDialog().
SCIP_DIALOG* SCIPgetRootDialog | ( | SCIP * | scip | ) |
returns the root dialog of SCIP's interactive user shell
scip | SCIP data structure |
Definition at line 9813 of file scip.c.
References Scip::dialoghdlr, and SCIPdialoghdlrGetRoot().
Referenced by createCountDialog(), SCIPcreateRootDialog(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), and SCIPincludeObjDialog().
SCIP_RETCODE SCIPaddDialogEntry | ( | SCIP * | scip, |
SCIP_DIALOG * | dialog, | ||
SCIP_DIALOG * | subdialog | ||
) |
adds a sub dialog to the given dialog as menu entry and captures it
scip | SCIP data structure |
dialog | dialog to extend, or NULL for root dialog |
subdialog | subdialog to add as menu entry in dialog |
Definition at line 9827 of file scip.c.
References Scip::dialoghdlr, SCIP_CALL, SCIP_OKAY, SCIPdialogAddEntry(), SCIPdialoghdlrGetRoot(), and Scip::set.
Referenced by addFixParamDialog(), addSetParamDialog(), createCountDialog(), createEmphasisSubmenu(), SCIPincludeConshdlrSuperindicator(), SCIPincludeDialogDefault(), SCIPincludeDialogDefaultFix(), SCIPincludeDialogDefaultSet(), and SCIPincludeObjDialog().
SCIP_RETCODE SCIPaddDialogInputLine | ( | SCIP * | scip, |
const char * | inputline | ||
) |
adds a single line of input which is treated as if the user entered the command line
scip | SCIP data structure |
inputline | input line to add |
Definition at line 9848 of file scip.c.
References Scip::dialoghdlr, SCIP_CALL, SCIP_OKAY, and SCIPdialoghdlrAddInputLine().
Referenced by SCIPprocessShellArguments().
SCIP_RETCODE SCIPaddDialogHistoryLine | ( | SCIP * | scip, |
const char * | inputline | ||
) |
adds a single line of input to the command history which can be accessed with the cursor keys
scip | SCIP data structure |
inputline | input line to add |
Definition at line 9865 of file scip.c.
References Scip::dialoghdlr, FALSE, SCIP_CALL, SCIP_OKAY, and SCIPdialoghdlrAddHistory().
SCIP_RETCODE SCIPstartInteraction | ( | SCIP * | scip | ) |
starts interactive mode of SCIP by executing the root dialog
scip
is in one of the following stages:
See SCIP_STAGE for a complete list of all possible solving stages.
scip | SCIP data structure |
Definition at line 9898 of file scip.c.
References checkStage(), Scip::dialoghdlr, FALSE, SCIP_CALL, SCIP_OKAY, SCIPdialoghdlrExec(), SCIPincludeDialogDefault(), Scip::set, and TRUE.
Referenced by interactive(), and SCIPprocessShellArguments().