Difference between revisions of "Code::Blocks command line arguments"
From Code::Blocks
BlueHazzard (talk | contribs) (Update after (after [r13245]) add user variable command line arguments) |
|||
| Line 28: | Line 28: | ||
{| border="1" cellpadding="3" cellspacing="0" style="border: 1px solid gray; border-collapse: collapse;" | {| border="1" cellpadding="3" cellspacing="0" style="border: 1px solid gray; border-collapse: collapse;" | ||
| − | + | |+ | |
|- style="background: #ececec; border: 1px solid gray" | |- style="background: #ececec; border: 1px solid gray" | ||
| − | ! Argument | + | ! |
| + | ! Argument | ||
! Function | ! Function | ||
|- | |- | ||
| − | |||
|- | |- | ||
| − | | ''<filename>'' | + | |Windows |
| + | |Linux, Unix, MacOS | ||
| + | | | ||
| + | |- | ||
| + | | | ||
| + | |''<filename>'' | ||
| Specifies the project *.cbp filename or workspace *.workspace filename. For instance ''<filename>'' may be ''c:\some\where\a\project.cbp''. Place this argument at end of command line, just before output redirection if any. | | Specifies the project *.cbp filename or workspace *.workspace filename. For instance ''<filename>'' may be ''c:\some\where\a\project.cbp''. Place this argument at end of command line, just before output redirection if any. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--file='''''<filename>[:line]'' | + | | |
| + | |'''--file='''''<filename>[:line]'' | ||
| Open file in Code::Blocks and optionally jump to a specific line. | | Open file in Code::Blocks and optionally jump to a specific line. | ||
|- | |- | ||
|- | |- | ||
| − | | '''/h''', ''' | + | |'''/h''', '''/?''' |
| + | |'''--help''', '''--?''' | ||
| Shows a help message about the command line arguments. | | Shows a help message about the command line arguments. | ||
|- | |- | ||
|- | |- | ||
| − | | '''/na''' | + | |'''/na''' |
| + | |'''--no-check-associations''' | ||
| Don't perform any file association checks (Windows only). | | Don't perform any file association checks (Windows only). | ||
|- | |- | ||
|- | |- | ||
| − | | '''/nd''' | + | |'''/nd''' |
| + | |'''--no-dde''' | ||
| Don't start a [http://en.wikipedia.org/wiki/Dynamic_Data_Exchange DDE] server (Windows only). | | Don't start a [http://en.wikipedia.org/wiki/Dynamic_Data_Exchange DDE] server (Windows only). | ||
|- | |- | ||
|- | |- | ||
| − | | '''/ns''' | + | |'''/ns''' |
| + | |'''--no-splash-screen''' | ||
| Hides the splash screen when the application is loading. | | Hides the splash screen when the application is loading. | ||
|- | |- | ||
|- | |- | ||
| − | | '''/d''' | + | |'''/d''' |
| + | |'''--debug-log''' | ||
| Display application's debug log. | | Display application's debug log. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--prefix='''''<str>'' | + | | |
| + | |'''--prefix='''''<str>'' | ||
| Sets the shared data directory prefix. | | Sets the shared data directory prefix. | ||
|- | |- | ||
|- | |- | ||
| − | | '''/p''' | + | |'''/p''' |
| + | |'''--personality='''''<str>'', '''--profile='''''<str>'' | ||
| Sets the [[Personalities|personality]] to use. You can use ''ask'' as the parameter to list available personalities. | | Sets the [[Personalities|personality]] to use. You can use ''ask'' as the parameter to list available personalities. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--rebuild''' | + | | |
| + | |'''--rebuild''' | ||
| Clean and build the project / workspace. | | Clean and build the project / workspace. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--build''' | + | | |
| + | |'''--build''' | ||
| Build the project / workspace. | | Build the project / workspace. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--target='''''<str>'' | + | | |
| + | |'''--target='''''<str>'' | ||
| Sets target for batch build. For example --target="Release". | | Sets target for batch build. For example --target="Release". | ||
|- | |- | ||
|- | |- | ||
| − | | '''--no-batch-window-close''' | + | | |
| + | |'''--no-batch-window-close''' | ||
| Keeps the batch log window visible after the batch build has completed. | | Keeps the batch log window visible after the batch build has completed. | ||
|- | |- | ||
|- | |- | ||
| − | | '''--batch-build-notify''' | + | | |
| + | |'''--batch-build-notify''' | ||
| Shows a message after the batch build has completed. | | Shows a message after the batch build has completed. | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--user-data-dir=<path>''' | ||
| specify an alternative directory for user settings and user installed plugins | | specify an alternative directory for user settings and user installed plugins | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--script=<str>''' | ||
| specify a script file to run after loading | | specify a script file to run after loading | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--target=<str>''' | ||
| the target for the batch build | | the target for the batch build | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--clean''' | ||
| clean the project/workspace | | clean the project/workspace | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--rebuild''' | ||
| clean and then build the project/workspace | | clean and then build the project/workspace | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--build''' | ||
| just build the project/workspace | | just build the project/workspace | ||
|- | |- | ||
|- | |- | ||
| − | | | + | | |
| + | |'''--verbose''' | ||
| Enable logging of c::b errors | | Enable logging of c::b errors | ||
|- | |- | ||
| + | | | ||
|'''-S''' setName | |'''-S''' setName | ||
|Set <nowiki>''</nowiki>setName<nowiki>''</nowiki> to current active set for global variables (after [r13245]) | |Set <nowiki>''</nowiki>setName<nowiki>''</nowiki> to current active set for global variables (after [r13245]) | ||
|- | |- | ||
| + | | | ||
|'''-D''' <set>.uservar.mem=val | |'''-D''' <set>.uservar.mem=val | ||
|Set the member ''mem'' of uservariable ''uservar'' in set to value ''val''. This overrides the current set value (after [r13245]) | |Set the member ''mem'' of uservariable ''uservar'' in set to value ''val''. This overrides the current set value (after [r13245]) | ||
| Line 146: | Line 173: | ||
|- | |- | ||
| − | | '''>''' ''<build log file>'' | + | | |
| + | |'''>''' ''<build log file>'' | ||
| Placed in the very last position of command line, this may be used to redirect standard output to log file, this is not a codeblock option as such, but just a DOS/*nix shell usual standard output redirection | | Placed in the very last position of command line, this may be used to redirect standard output to log file, this is not a codeblock option as such, but just a DOS/*nix shell usual standard output redirection | ||
|- | |- | ||
|} | |} | ||
Revision as of 21:29, 13 November 2023
Using command line arguments
Windows
- Find the Code::Blocks shortcut in the Desktop or Start menu.
- Right click on the icon and select Properties.
- Select the Shortcut tab.
- Append the command line arguments you want to use to the end of the Target text (behind the quote mark).
- Run Code::Blocks by using the shortcut you edited.
Example
"C:\Program Files\CodeBlocks\codeblocks.exe" /na /nd
*nix
- Launch a terminal client, such as XTerm, Gnome Terminal or Konsole.
- Type "codeblocks" and then append the command line arguments you want to use.
Note: Code::Blocks can not run on a real console, X11 must be running and you must use a graphical terminal emulator.
Example
codeblocks --no-splash-screen --debug-log
Command line arguments
| Argument | Function | |
|---|---|---|
| Windows | Linux, Unix, MacOS | |
| <filename> | Specifies the project *.cbp filename or workspace *.workspace filename. For instance <filename> may be c:\some\where\a\project.cbp. Place this argument at end of command line, just before output redirection if any. | |
| --file=<filename>[:line] | Open file in Code::Blocks and optionally jump to a specific line. | |
| /h, /? | --help, --? | Shows a help message about the command line arguments. |
| /na | --no-check-associations | Don't perform any file association checks (Windows only). |
| /nd | --no-dde | Don't start a DDE server (Windows only). |
| /ns | --no-splash-screen | Hides the splash screen when the application is loading. |
| /d | --debug-log | Display application's debug log. |
| --prefix=<str> | Sets the shared data directory prefix. | |
| /p | --personality=<str>, --profile=<str> | Sets the personality to use. You can use ask as the parameter to list available personalities. |
| --rebuild | Clean and build the project / workspace. | |
| --build | Build the project / workspace. | |
| --target=<str> | Sets target for batch build. For example --target="Release". | |
| --no-batch-window-close | Keeps the batch log window visible after the batch build has completed. | |
| --batch-build-notify | Shows a message after the batch build has completed. | |
| --user-data-dir=<path> | specify an alternative directory for user settings and user installed plugins | |
| --script=<str> | specify a script file to run after loading | |
| --target=<str> | the target for the batch build | |
| --clean | clean the project/workspace | |
| --rebuild | clean and then build the project/workspace | |
| --build | just build the project/workspace | |
| --verbose | Enable logging of c::b errors | |
| -S setName | Set ''setName'' to current active set for global variables (after [r13245]) | |
| -D <set>.uservar.mem=val | Set the member mem of uservariable uservar in set to value val. This overrides the current set value (after [r13245]) | |
| > <build log file> | Placed in the very last position of command line, this may be used to redirect standard output to log file, this is not a codeblock option as such, but just a DOS/*nix shell usual standard output redirection |
