Detailed Description

methods for user interface dialog

Author: Tobias Achterberg

Definition in file dialog.c.

#include <assert.h>
#include <string.h>
#include <ctype.h>
#include "scip/scip.h"
#include "scip/def.h"
#include "blockmemshell/memory.h"
#include "scip/set.h"
#include "scip/pub_misc.h"
#include "scip/dialog.h"
#include "scip/struct_dialog.h"

Go to the source code of this file.

Functions
static SCIP_RETCODE	readLine (SCIP_DIALOGHDLR dialoghdlr, const char prompt, SCIP_Bool *endoffile)

static SCIP_RETCODE	addHistory (const char *s)

static int	getHistoryLength (void)

static SCIP_RETCODE	removeHistory (int pos)

static void	linelistFree (SCIP_LINELIST **linelist)

static void	linelistFreeAll (SCIP_LINELIST **linelist)

static SCIP_RETCODE	readInputLine (SCIP_DIALOGHDLR dialoghdlr, const char prompt, SCIP_Bool *endoffile)

SCIP_RETCODE	SCIPdialogCopyInclude (SCIP_DIALOG dialog, SCIP_SET set)

SCIP_RETCODE	SCIPdialoghdlrCreate (SCIP_SET set, SCIP_DIALOGHDLR *dialoghdlr)

SCIP_RETCODE	SCIPdialoghdlrFree (SCIP scip, SCIP_DIALOGHDLR *dialoghdlr)

SCIP_RETCODE	SCIPdialoghdlrExec (SCIP_DIALOGHDLR dialoghdlr, SCIP_SET set)

SCIP_RETCODE	SCIPdialoghdlrSetRoot (SCIP scip, SCIP_DIALOGHDLR dialoghdlr, SCIP_DIALOG *dialog)

SCIP_DIALOG *	SCIPdialoghdlrGetRoot (SCIP_DIALOGHDLR *dialoghdlr)

void	SCIPdialoghdlrClearBuffer (SCIP_DIALOGHDLR *dialoghdlr)

SCIP_Bool	SCIPdialoghdlrIsBufferEmpty (SCIP_DIALOGHDLR *dialoghdlr)

SCIP_RETCODE	SCIPdialoghdlrGetWord (SCIP_DIALOGHDLR dialoghdlr, SCIP_DIALOG dialog, const char prompt, char inputword, SCIP_Bool endoffile)

SCIP_RETCODE	SCIPdialoghdlrAddInputLine (SCIP_DIALOGHDLR dialoghdlr, const char inputline)

SCIP_RETCODE	SCIPdialoghdlrAddHistory (SCIP_DIALOGHDLR dialoghdlr, SCIP_DIALOG dialog, const char *command, SCIP_Bool escapecommand)

static SCIP_RETCODE	ensureSubdialogMem (SCIP_DIALOG dialog, SCIP_SET set, int num)

SCIP_RETCODE	SCIPdialogCreate (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)

static SCIP_RETCODE	dialogFree (SCIP scip, SCIP_DIALOG *dialog)

void	SCIPdialogCapture (SCIP_DIALOG *dialog)

SCIP_RETCODE	SCIPdialogRelease (SCIP scip, SCIP_DIALOG *dialog)

SCIP_RETCODE	SCIPdialogExec (SCIP_DIALOG dialog, SCIP_SET set, SCIP_DIALOGHDLR dialoghdlr, SCIP_DIALOG *nextdialog)

static	SCIP_DECL_SORTPTRCOMP (dialogComp)

SCIP_RETCODE	SCIPdialogAddEntry (SCIP_DIALOG dialog, SCIP_SET set, SCIP_DIALOG *subdialog)

SCIP_Bool	SCIPdialogHasEntry (SCIP_DIALOG dialog, const char entryname)

int	SCIPdialogFindEntry (SCIP_DIALOG dialog, const char entryname, SCIP_DIALOG **subdialog)

SCIP_RETCODE	SCIPdialogDisplayMenu (SCIP_DIALOG dialog, SCIP scip)

SCIP_RETCODE	SCIPdialogDisplayMenuEntry (SCIP_DIALOG dialog, SCIP scip)

SCIP_RETCODE	SCIPdialogDisplayCompletions (SCIP_DIALOG dialog, SCIP scip, const char *entryname)

void	SCIPdialogGetPath (SCIP_DIALOG dialog, const char sepchar, char path)

const char *	SCIPdialogGetName (SCIP_DIALOG *dialog)

const char *	SCIPdialogGetDesc (SCIP_DIALOG *dialog)

SCIP_Bool	SCIPdialogIsSubmenu (SCIP_DIALOG *dialog)

SCIP_DIALOG *	SCIPdialogGetParent (SCIP_DIALOG *dialog)

SCIP_DIALOG **	SCIPdialogGetSubdialogs (SCIP_DIALOG *dialog)

int	SCIPdialogGetNSubdialogs (SCIP_DIALOG *dialog)

SCIP_DIALOGDATA *	SCIPdialogGetData (SCIP_DIALOG *dialog)

void	SCIPdialogSetData (SCIP_DIALOG dialog, SCIP_DIALOGDATA dialogdata)

Function Documentation

static SCIP_RETCODE readLine	(	SCIP_DIALOGHDLR *	dialoghdlr,
		const char *	prompt,
		SCIP_Bool *	endoffile
	)

static

reads a line of input from stdin

Parameters

dialoghdlr	dialog handler
prompt	prompt to display
endoffile	pointer to store whether the end of the input file was reached

Definition at line 134 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, FALSE, NULL, SCIP_OKAY, and TRUE.

Referenced by readInputLine().

static SCIP_RETCODE addHistory ( const char * s )

static

puts the given string on the command history

Parameters

s	string to add to the command history

Definition at line 179 of file dialog.c.

References SCIP_OKAY.

Referenced by SCIPdialoghdlrAddHistory().

static int getHistoryLength ( void )

static

returns the current length of the history list

Definition at line 189 of file dialog.c.

Referenced by SCIPdialoghdlrAddHistory().

static SCIP_RETCODE removeHistory ( int pos )

static

removes a single element from the history list

Parameters

pos	list position of history entry to remove

Definition at line 198 of file dialog.c.

References SCIP_OKAY.

Referenced by SCIPdialoghdlrAddHistory().

static void linelistFree ( SCIP_LINELIST ** linelist )

static

frees a single linelist entry, but not its successors

Parameters

linelist pointer to line list

Definition at line 210 of file dialog.c.

References BMSfreeMemory, BMSfreeMemoryArray, and NULL.

Referenced by linelistFreeAll(), and readInputLine().

static void linelistFreeAll ( SCIP_LINELIST ** linelist )

static

frees a linelist entry and all of its successors

Parameters

linelist pointer to line list

Definition at line 222 of file dialog.c.

References linelistFree(), SCIP_Linelist::nextline, and NULL.

Referenced by SCIPdialoghdlrFree().

static SCIP_RETCODE readInputLine	(	SCIP_DIALOGHDLR *	dialoghdlr,
		const char *	prompt,
		SCIP_Bool *	endoffile
	)

static

reads a line of input from stdin or from the stored input lines in the input list

Parameters

dialoghdlr	dialog handler
prompt	prompt to display
endoffile	pointer to store whether the end of the input file was reached

Definition at line 240 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, FALSE, SCIP_Linelist::inputline, SCIP_Dialoghdlr::inputlist, SCIP_Dialoghdlr::inputlistptr, linelistFree(), SCIP_Linelist::nextline, NULL, readLine(), SCIP_CALL, and SCIP_OKAY.

Referenced by SCIPdialoghdlrGetWord().

SCIP_RETCODE SCIPdialogCopyInclude	(	SCIP_DIALOG *	dialog,
		SCIP_SET *	set
	)

copies the given dialog to a new scip

Parameters

dialog	dialog
set	SCIP_SET of SCIP to copy to

Definition at line 289 of file dialog.c.

References NULL, SCIP_CALL, SCIP_OKAY, SCIPdebugMessage, and SCIPdialogGetName().

Referenced by SCIPsetCopyPlugins().

SCIP_RETCODE SCIPdialoghdlrCreate	(	SCIP_SET *	set,
		SCIP_DIALOGHDLR **	dialoghdlr
	)

creates a dialog handler

Parameters

set	global SCIP settings
dialoghdlr	pointer to store dialog handler

Definition at line 307 of file dialog.c.

References BMSallocMemory, BMSallocMemoryArray, NULL, SCIP_ALLOC, SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPdialoghdlrClearBuffer(), SCIPsetIncludeExternalCode(), and SCIPsnprintf().

Referenced by SCIPcreate().

SCIP_RETCODE SCIPdialoghdlrFree	(	SCIP *	scip,
		SCIP_DIALOGHDLR **	dialoghdlr
	)

frees a dialog handler and it's dialog tree

Parameters

scip	SCIP data structure
dialoghdlr	pointer to dialog handler

Definition at line 337 of file dialog.c.

References BMSfreeMemory, BMSfreeMemoryArray, linelistFreeAll(), NULL, SCIP_CALL, SCIP_OKAY, and SCIPdialoghdlrSetRoot().

Referenced by SCIPfree().

SCIP_RETCODE SCIPdialoghdlrExec	(	SCIP_DIALOGHDLR *	dialoghdlr,
		SCIP_SET *	set
	)

executes the root dialog of the dialog handler

Parameters

dialoghdlr	dialog handler
set	global SCIP settings

Definition at line 353 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, NULL, SCIP_Dialoghdlr::rootdialog, SCIP_CALL, SCIP_OKAY, SCIPdialogExec(), and SCIPdialoghdlrClearBuffer().

Referenced by SCIPstartInteraction().

SCIP_RETCODE SCIPdialoghdlrSetRoot	(	SCIP *	scip,
		SCIP_DIALOGHDLR *	dialoghdlr,
		SCIP_DIALOG *	dialog
	)

makes given dialog the root dialog of dialog handler; captures dialog and releases former root dialog

Parameters

scip	SCIP data structure
dialoghdlr	dialog handler
dialog	dialog to be the root

Definition at line 381 of file dialog.c.

References NULL, SCIP_Dialoghdlr::rootdialog, SCIP_CALL, SCIP_OKAY, SCIPdialogCapture(), and SCIPdialogRelease().

Referenced by SCIPdialoghdlrFree(), and SCIPsetRootDialog().

SCIP_DIALOG* SCIPdialoghdlrGetRoot ( SCIP_DIALOGHDLR * dialoghdlr )

returns the root dialog of the dialog handler

Parameters

dialoghdlr dialog handler

Definition at line 404 of file dialog.c.

References NULL, and 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

Parameters

dialoghdlr dialog handler

Definition at line 414 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, and NULL.

Referenced by dialogExecMenu(), SCIP_DECL_DIALOGEXEC(), SCIPdialoghdlrCreate(), SCIPdialoghdlrExec(), SCIPdialoghdlrGetWord(), and writeProblem().

SCIP_Bool SCIPdialoghdlrIsBufferEmpty ( SCIP_DIALOGHDLR * dialoghdlr )

returns TRUE iff input command buffer is empty

Parameters

dialoghdlr dialog handler

Definition at line 425 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, and NULL.

Referenced by SCIP_DECL_DIALOGEXEC(), and SCIPdialoghdlrGetWord().

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

Parameters

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 438 of file dialog.c.

References SCIP_Dialoghdlr::buffer, SCIP_Dialoghdlr::bufferpos, SCIP_Dialoghdlr::buffersize, FALSE, NULL, 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

Parameters

dialoghdlr	dialog handler
inputline	input line to add

Definition at line 589 of file dialog.c.

References BMSallocMemory, BMSduplicateMemoryArray, SCIP_Linelist::inputline, SCIP_Dialoghdlr::inputlistptr, SCIP_Linelist::nextline, NULL, SCIP_ALLOC, 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

Parameters

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 613 of file dialog.c.

References addHistory(), getHistoryLength(), SCIP_Dialog::name, SCIP_Dialoghdlr::nprotectedhistelems, NULL, SCIP_Dialog::parent, removeHistory(), SCIP_Dialoghdlr::rootdialog, SCIP_Bool, SCIP_CALL, SCIP_MAXSTRLEN, SCIP_OKAY, SCIPescapeString(), and SCIPsnprintf().

Referenced by SCIP_DECL_DIALOGEXEC(), SCIPaddDialogHistoryLine(), SCIPdialoghdlrGetWord(), and writeProblem().

static SCIP_RETCODE ensureSubdialogMem	(	SCIP_DIALOG *	dialog,
		SCIP_SET *	set,
		int	num
	)

static

ensures, that sub-dialogs array can store at least the given number of sub-dialogs

Parameters

dialog	dialog
set	global SCIP settings
num	minimal storage size for sub-dialogs

Definition at line 690 of file dialog.c.

References BMSreallocMemoryArray, NULL, SCIP_ALLOC, SCIP_OKAY, SCIPsetCalcMemGrowSize(), SCIP_Dialog::subdialogs, and SCIP_Dialog::subdialogssize.

Referenced by SCIPdialogAddEntry().

SCIP_RETCODE SCIPdialogCreate	(	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 captures a user interface dialog

Parameters

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 sub-menu?
dialogdata	user defined dialog data

Definition at line 712 of file dialog.c.

References BMSallocMemory, BMSduplicateMemoryArray, NULL, SCIP_ALLOC, SCIP_OKAY, and SCIPdialogCapture().

Referenced by SCIPincludeDialog().

static SCIP_RETCODE dialogFree	(	SCIP *	scip,
		SCIP_DIALOG **	dialog
	)

static

frees dialog and all of its sub-dialogs

Parameters

scip	SCIP data structure
dialog	pointer to dialog

Definition at line 757 of file dialog.c.

References BMSfreeMemory, BMSfreeMemoryArrayNull, NULL, SCIP_CALL, SCIP_OKAY, and SCIPdialogRelease().

Referenced by SCIPdialogRelease().

void SCIPdialogCapture ( SCIP_DIALOG * dialog )

captures a dialog

Parameters

dialog dialog

Definition at line 789 of file dialog.c.

References NULL, and SCIP_Dialog::nuses.

Referenced by SCIPcaptureDialog(), SCIPdialogAddEntry(), SCIPdialogCreate(), and SCIPdialoghdlrSetRoot().

SCIP_RETCODE SCIPdialogRelease	(	SCIP *	scip,
		SCIP_DIALOG **	dialog
	)

releases a dialog

Parameters

scip	SCIP data structure
dialog	pointer to dialog

Definition at line 799 of file dialog.c.

References dialogFree(), NULL, SCIP_CALL, and SCIP_OKAY.

Referenced by dialogFree(), SCIPdialoghdlrSetRoot(), and SCIPreleaseDialog().

SCIP_RETCODE SCIPdialogExec	(	SCIP_DIALOG *	dialog,
		SCIP_SET *	set,
		SCIP_DIALOGHDLR *	dialoghdlr,
		SCIP_DIALOG **	nextdialog
	)

executes dialog

Parameters

dialog	dialog
set	global SCIP settings
dialoghdlr	dialog handler
nextdialog	pointer to store the next dialog to process

Definition at line 816 of file dialog.c.

References NULL, SCIP_CALL, and SCIP_OKAY.

Referenced by SCIPdialoghdlrExec().

static SCIP_DECL_SORTPTRCOMP ( dialogComp )

static

comparison method for sorting dialogs w.r.t. to their name

Definition at line 835 of file dialog.c.

References SCIPdialogGetName().

SCIP_RETCODE SCIPdialogAddEntry	(	SCIP_DIALOG *	dialog,
		SCIP_SET *	set,
		SCIP_DIALOG *	subdialog
	)

adds a sub-dialog to the given dialog as menu entry and captures the sub-dialog

Parameters

dialog	dialog
set	global SCIP settings
subdialog	sub-dialog to add as menu entry in dialog

Definition at line 841 of file dialog.c.

References ensureSubdialogMem(), SCIP_Dialog::nsubdialogs, NULL, SCIP_Dialog::parent, SCIP_CALL, SCIP_INVALIDDATA, SCIP_OKAY, SCIPdialogCapture(), SCIPdialogGetName(), SCIPdialogHasEntry(), SCIPerrorMessage, SCIPsortedvecInsertPtr(), and SCIP_Dialog::subdialogs.

Referenced by SCIPaddDialogEntry().

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

Parameters

dialog	dialog
entryname	name of the dialog entry to find

Definition at line 872 of file dialog.c.

References FALSE, NULL, 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.

Parameters