Scripting commands

Scripting is no good if all you can do is use the scripting language's builtin commands only. The host application (Code::Blocks) needs to expose parts of its internals to scripts, so scripts can use and control the host.

Code::Blocks has exposed a very large chunk of its SDK to scripts. This makes scripting in Code::Blocks nearly as powerful as native code (C++).

In this page all the exported constants, functions and classes are documented as a quick reference. For detailed documentation on each function/class, refer to the Code::Blocks SDK documentation.

NOTE: please remember that Squirrel is typeless. Data types mentioned below are only used for documentation purposes.

Global functions

Return value	Name	Arguments	Remarks
void	Log	wxString	logs to debug log
int	Message	wxString,wxString,int
void	ShowMessage	wxString
void	ShowWarning	wxString
void	ShowError	wxString
void	ShowInfo	wxString
wxString	ReplaceMacros	wxString,bool
ProjectManager*	GetProjectManager
EditorManager*	GetEditorManager
ConfigManager*	GetConfigManager
CompilerFactory*	GetCompilerFactory
bool	IsNull	void*
wxString	_T	const char*	basically this is the wxString constructor

ConfigManager

Return value	Name	Arguments	Remarks
int	Read	int,int
bool	Read	bool,bool
float	Read	float,float
wxString	Read	wxString,wxString
void	Write	int,int
void	Write	bool,bool
void	Write	float,float
void	Write	wxString,wxString[,bool]

ProjectManager

Return value	Name	Arguments	Remarks
wxString	GetDefaultPath
void	SetDefaultPath	wxString
cbProject*	GetActiveProject
void	SetProject	cbProject*
bool	LoadWorkspace	wxString
bool	SaveWorkspace
bool	SaveWorkspaceAs	wxString
bool	CloseWorkspace
cbProject*	IsOpen	wxString
cbProject*	LoadProject	wxString,bool
bool	SaveProject	cbProject*
bool	SaveProjectAs	cbProject*
bool	SaveActiveProject
bool	SaveActiveProjectAs
bool	SaveAllProjects
bool	CloseProject	cbProject*,bool,bool
bool	CloseActiveProject	bool
bool	CloseAllProjects	bool
cbProject*	NewProject	wxString
int	AddFileToProject	wxString,cbProject*,int
int	AskForBuildTargetIndex	cbProject*
void	RebuildTree

EditorManager

Return value	Name	Arguments	Remarks
void	Configure
cbEditor*	New	wxString
cbEditor*	Open	wxString
cbEditor*	IsBuiltinOpen	wxString
cbEditor*	GetBuiltinEditor	int
cbEditor*	GetBuiltinActiveEditor
EditorBase*	GetActiveEditor
void	ActivateNext
void	ActivatePrevious
bool	SwapActiveHeaderSource
bool	CloseActive	bool
bool	Close	int,bool
bool	CloseAll	bool
bool	Save	int
bool	SaveActive
bool	SaveAs	int
bool	SaveActiveAs
bool	SaveAll
int	ShowFindDialog	bool,bool

UserVariableManager

Return value	Name	Arguments	Remarks
bool	Exists	wxString

IO namespace

Return value	Name	Arguments	Remarks
bool	DirectoryExists	wxString
wxString	SelectDirectory	wxString,wxString,bool
bool	FileExists	wxString
wxString	SelectFile	wxString,wxString,wxString

CompilerFactory

Return value	Name	Arguments	Remarks
bool	IsValidCompilerID	wxString
int	GetCompilerIndex	wxString
wxString	GetDefaultCompilerID

wxString

Return value	Name	Arguments	Remarks
bool	operator+
bool	operator<
bool	operator<=
bool	operator>=
bool	operator>
int	Find	wxString
bool	Matches	wxString
void	AddChar	char
char	GetChar	int
bool	IsEmpty
int	Length
int	length		same as Length()
int	len		same as Length()
int	size		same as Length()
wxString	Lower
wxString	LowerCase		same as Lower()
void	MakeLower
wxString	Upper
wxString	UpperCase		same as Upper()
void	MakeUpper
wxString	Mid	int,int
void	Remove	int,int
void	RemoveLast
int	Replace	wxString,wxString[,bool]
wxString	Right	int
wxString	AfterFirst	char
wxString	AfterLast	char
wxString	BeforeFirst	char
wxString	BeforeLast	char

wxArrayString

Return value	Name	Arguments	Remarks
void	Add	wxString
void	Clear
int	GetCount
wxString	Item	int

ProjectFile

Return value	Name	Arguments	Remarks
void	AddBuildTarget	wxString
void	RenameBuildTarget	wxString,wxString
void	RemoveBuildTarget	wxString
wxString	GetBaseName
wxString	GetObjName
void	SetObjName	wxString
cbProject*	GetParentProject
wxString	relativeFilename		(variable)
wxString	relativeToCommonTopLevelPath		(variable)
bool	compile		(variable)
bool	link		(variable)
int	weight		(variable)
wxString	compilerVar		(variable)

CompileOptionsBase

Return value	Name	Arguments	Remarks
void	SetLinkerOptions	wxArrayString
void	SetLinkLibs	wxArrayString
void	SetCompilerOptions	wxArrayString
void	SetIncludeDirs	wxArrayString
void	SetResourceIncludeDirs	wxArrayString
void	SetLibDirs	wxArrayString
void	SetCommandsBeforeBuild	wxArrayString
void	SetCommandsAfterBuild	wxArrayString
wxArrayString	GetLinkerOptions
wxArrayString	GetLinkLibs
wxArrayString	GetCompilerOptions
wxArrayString	GetIncludeDirs
wxArrayString	GetResourceIncludeDirs
wxArrayString	GetLibDirs
wxArrayString	GetCommandsBeforeBuild
wxArrayString	GetCommandsAfterBuild
bool	GetModified
void	SetModified	bool
void	AddLinkerOption	wxString
void	AddLinkLib	wxString
void	AddCompilerOption	wxString
void	AddIncludeDir	wxString
void	AddResourceIncludeDir	wxString
void	AddLibDir	wxString
void	AddCommandsBeforeBuild	wxString
void	AddCommandsAfterBuild	wxString
void	RemoveLinkerOption	wxString
void	RemoveLinkLib	wxString
void	RemoveCompilerOption	wxString
void	RemoveIncludeDir	wxString
void	RemoveResourceIncludeDir	wxString
void	RemoveLibDir	wxString
void	RemoveCommandsBeforeBuild	wxString
void	RemoveCommandsAfterBuild	wxString
bool	GetAlwaysRunPostBuildSteps
void	SetAlwaysRunPostBuildSteps	bool
bool	SetVar	wxString,wxString,bool
wxString	GetVar	wxString
bool	UnsetVar	wxString
void	UnsetAllVars

CompileTargetBase

Extends CompileOptionsBase.

Return value	Name	Arguments	Remarks
wxString	GetFilename
wxString	GetTitle
void	SetTitle	wxString
void	SetOutputFilename	wxString
void	SetWorkingDir	wxString
void	SetObjectOutput	wxString
void	SetDepsOutput	wxString
OptionsRelation	GetOptionRelation	OptionsRelationType
void	SetOptionRelation	OptionsRelationType,OptionsRelation
wxString	GetWorkingDir
wxString	GetObjectOutput
wxString	GetDepsOutput
wxString	GetOutputFilename
wxString	SuggestOutputFilename
wxString	GetExecutableFilename
wxString	GetDynamicLibFilename
wxString	GetDynamicLibDefFilename
wxString	GetStaticLibFilename
wxString	GetBasePath
void	SetTargetType	TargetType
TargetType	GetTargetType
wxString	GetExecutionParameters
void	SetExecutionParameters	wxString
wxString	GetHostApplication
void	SetHostApplication	wxString
void	SetCompilerID	wxString
wxString	GetCompilerID

ProjectBuildTarget

Extends CompileTargetBase.

Return value	Name	Arguments	Remarks
cbProject*	GetParentProject
wxString	GetFullTitle
wxString	GetExternalDeps
void	SetExternalDeps	wxString
void	SetAdditionalOutputFiles	wxString
wxString	GetAdditionalOutputFiles
bool	GetIncludeInTargetAll
void	SetIncludeInTargetAll	bool
bool	GetCreateDefFile
void	SetCreateDefFile	bool
bool	GetCreateStaticLib
void	SetCreateStaticLib	bool
bool	GetUseConsoleRunner
void	SetUseConsoleRunner	bool

cbProject

Extends CompileTargetBase.

Return value	Name	Arguments	Remarks
bool	GetModified
void	SetModified	bool
wxString	GetMakefile
void	SetMakefile	wxString
bool	IsMakefileCustom
void	SetMakefileCustom	bool
bool	CloseAllFiles	bool
bool	SaveAllFiles
bool	Save
bool	SaveLayout
bool	LoadLayout
bool	ShowOptions
wxString	GetCommonTopLevelPath
int	GetFilesCount
ProjectFile*	GetFile	int
ProjectFile*	GetFileByFilename	wxString,bool,bool
bool	RemoveFile	int
ProjectFile*	AddFile	int,wxString,bool,bool,int
int	GetBuildTargetsCount
ProjectBuildTarget*	GetBuildTarget	int
ProjectBuildTarget*	AddBuildTarget	wxString
bool	RenameBuildTarget	int,wxString
ProjectBuildTarget*	DuplicateBuildTarget	int,wxString
bool	RemoveBuildTarget	int
bool	ExportTargetAsProject	int
void	SetActiveBuildTarget	int
int	GetActiveBuildTarget
int	SelectTarget	int,bool
ProjectBuildTarget*	GetCurrentlyCompilingTarget
void	SetCurrentlyCompilingTarget	ProjectBuildTarget*
PCHMode	GetModeForPCH
void	SetModeForPCH	PCHMode

EditorBase

Return value	Name	Arguments	Remarks
wxString	GetFilename
void	SetFilename	wxString
wxString	GetShortName
bool	GetModified
void	SetModified	bool
wxString	GetTitle
void	SetTitle	wxString
void	Activate
bool	Close
bool	Save
bool	IsBuiltinEditor
bool	ThereAreOthers
void	GotoLine	int,bool
void	ToggleBreakpoint	int,bool
bool	HasBreakpoint	int
void	GotoNextBreakpoint
void	GotoPreviousBreakpoint
void	ToggleBookmark	int,bool
bool	HasBookmark	int
void	GotoNextBookmark
void	GotoPreviousBookmark
void	Undo
void	Redo
void	Cut
void	Copy
void	Paste
bool	CanUndo
bool	CanRedo
bool	CanPaste
bool	HasSelection

cbEditor

Extends EditorBase.

Return value	Name	Arguments	Remarks
void	SetEditorTitle	wxString
ProjectFile*	GetProjectFile
bool	SaveAs
void	FoldAll
void	UnfoldAll
void	ToggleAllFolds
void	FoldBlockFromLine	int
void	UnfoldBlockFromLine	int
void	ToggleFoldBlockFromLine	int
int	GetLineIndentInSpaces	int
wxString	GetLineIndentString	int
void	Touch
bool	Reload	bool
void	Print	bool,PrintColourMode,bool
void	AutoComplete
bool	AddBreakpoint	int,bool
bool	RemoveBreakpoint	int,bool
void	SetText	wxString	this is not present in cbEditor; included to help scripts edit text
wxString	GetText		this is not present in cbEditor; included to help scripts edit text

Constants

Constant	Type	Remarks
PLATFORM	int	this defines the platform Code::Blocks is currently running on. It is equal to only one of the following PLATFORM_* constants
PLATFORM_MSW	int	All Windows platforms
PLATFORM_GTK	int	All GTK platforms (e.g. linux, *bsd, solaris)
PLATFORM_UNKNOWN	int	Unknown platform. Please inform us if PLATFORM == PLATFORM_UNKNOWN so we can make this platform known too ;)
Message dialog flags
wxOK	int	Flag for Message() 's third argument (flags).
wxYES_NO	int	-"-
wxCANCEL	int	-"-
wxICON_QUESTION	int	-"-
wxICON_INFORMATION	int	-"-
wxICON_WARNING	int	-"-
wxICON_ERROR	int	-"-
Message dialog return values
wxID_OK	int
wxID_YES	int
wxID_NO	int
wxID_CANCEL	int
enum OptionsRelationType
ortCompilerOptions	enum
ortLinkerOptions	enum
ortIncludeDirs	enum
ortLibDirs	enum
ortResDirs	enum
enum OptionsRelation
orUseParentOptionsOnly	enum
orUseTargetOptionsOnly	enum
orPrependToParentOptions	enum
orAppendToParentOptions	enum
enum TargetType
ttExecutable	enum
ttConsoleOnly	enum
ttStaticLib	enum
ttDynamicLib	enum
ttCommandsOnly	enum
enum MakeCommand
mcClean	enum
mcDistClean	enum
mcBuild	enum
mcCompileFile	enum
enum PCHMode
pchSourceDir	enum
pchObjectDir	enum
pchSourceFile	enum
enum PrintScope
psSelection	enum
psActiveEditor	enum
psAllOpenEditors	enum
enum PrintColourMode
pcmBlackAndWhite	enum
pcmColourOnWhite	enum
pcmInvertColours	enum
pcmAsIs	enum
enum cbWizardPlugin::OutputType
wizProject	enum
wizTarget	enum
wizFiles	enum
wizCustom	enum
wxFILE_SEP_PATH	wxString	path separator. "\" for windows, "/" for all other platforms
File extensions (e.g. "cbp")
EXT_WORKSPACE	wxString
EXT_CODEBLOCKS	wxString
EXT_DEVCPP	wxString
EXT_MSVC6	wxString
EXT_MSVC6_WORKSPACE	wxString
EXT_MSVC7	wxString
EXT_MSVC7_WORKSPACE	wxString
EXT_D	wxString
EXT_F	wxString
EXT_F77	wxString
EXT_F95	wxString
EXT_CPP	wxString
EXT_C	wxString
EXT_CC	wxString
EXT_CXX	wxString
EXT_HPP	wxString
EXT_H	wxString
EXT_HH	wxString
EXT_HXX	wxString
EXT_OBJECT	wxString
EXT_XRCRESOURCE	wxString
EXT_STATICLIB	wxString
EXT_DYNAMICLIB	wxString
EXT_EXECUTABLE	wxString
EXT_RESOURCE	wxString
EXT_RESOURCEBIN	wxString
File extensions with leading dot (e.g. ".cbp")
DOT_EXT_WORKSPACE	wxString
DOT_EXT_CODEBLOCKS	wxString
DOT_EXT_DEVCPP	wxString
DOT_EXT_MSVC6	wxString
DOT_EXT_MSVC6_WORKSPACE	wxString
DOT_EXT_MSVC7	wxString
DOT_EXT_MSVC7_WORKSPACE	wxString
DOT_EXT_D	wxString
DOT_EXT_F	wxString
DOT_EXT_F77	wxString
DOT_EXT_F95	wxString
DOT_EXT_CPP	wxString
DOT_EXT_C	wxString
DOT_EXT_CC	wxString
DOT_EXT_CXX	wxString
DOT_EXT_HPP	wxString
DOT_EXT_H	wxString
DOT_EXT_HH	wxString
DOT_EXT_HXX	wxString
DOT_EXT_OBJECT	wxString
DOT_EXT_XRCRESOURCE	wxString
DOT_EXT_STATICLIB	wxString
DOT_EXT_DYNAMICLIB	wxString
DOT_EXT_EXECUTABLE	wxString
DOT_EXT_RESOURCE	wxString
DOT_EXT_RESOURCEBIN	wxString

Back to scripting index.