Code blocks

Translation for trunk

Translated

Untranslated

Создание проекта

Для создания проекта необходимо перейти в меню File -> New -> Project…. Либо сразу нажать на кнопку Create a new project на стартовой странице.

В появившемся окне выбираем необходимый тип проекта. Здесь мы видим, что Code::Blocks имеет большое количество шаблонов проектов. В нашем случае это Console application (консольное приложение).

В следующем окне выбираем используемый язык программирования. Выбираем C++ и нажимаем на кнопку Next.

Далее в поле Project Title вписываем название проекта. В нашем случае это Test. Тут же указываем расположение проекта на диске (поле Folder to create project in). В указанной нами папке Code::Blocks автоматически создаст папку с ранее указанным названием проекта. Указав имя папки и имя файла, нажимаем на кнопку Next.

В следующем окне выбираем компилятор, а также сценарии сборки. По умолчанию выбран GNU GCC Compiler, который мы и будем использовать. Сценарии сборки позволяют получить несколько версий одного приложения. По умолчанию предполагается два сценария: Debug (используется при отладке) и Release (сценарий компиляции готового приложения). Хотя бы один из сценариев должен быть выбран. Если выбраны оба сценария, то в дальнейшем можно будет переключаться между ними.

Жмём Finish и получаем минимальную программу, так называемый Hello World!

Нажмимаем F9 для компиляции и запуска программы и получаем следующее окно.

Обратите внимание на кнопки на панели инструментов, предназначенные для запуска и компиляции программы

Первая слева кнопка (с желтой шестеренкой) запускает только компиляцию программы, вторая (с зеленым треугольником) запускает
на исполнение последний скомпилированный файл программы, третья (с зеленым треугольником и желтой шестеренкой) — сначала
запускает компиляцию программы, а затем запускает полученный exe-файл программы. Частой ошибкой является использование кнопки запуска (с зеленым треугольником) для компиляции и запуска программы.
В этом случае внесенные в исходный код изменения не будут влиять на поведение программы, поскольку программа не была перекомпилирована.

Если открытый для редактирования файл был изменен, то на его вкладке слева от имени появится звездочка как на рисунке ниже.
Для сохранения программ, как и во многих других приложениях достаточно нажать сочетание клавиш Ctrl+S.
Расположение (путь) и имя отрытого в данный момент файла отображается в строке состояния, в левой нижней части окна.

Если ваши программы имеют небольшой объем и состоят только из одного файла, то лучше создавать не проект, а просто новый файл (File -> New -> Empty file).
Связано это с тем, что если у вас несколько проектов, то Code::Blocks будет компилировать и запускать только активный проект. Определить какой проект у вас активен в текущий момент
можно по состоянию окна Management, в котором показываются все открытые проекты и файлы. Если одновремено открыто несколько проектов, то название активного будет выделено полужирным шрифтом.
Если окно отсутствует, то открыть его можно через меню View -> Manager.

Для переключения между проектами необходимо навести указатель мыши, на тот проект, который вы необходимо
сделать активным и затем дважды кликнуть левой кнопкой мыши на названии проекта либо кликнуть один раз правой кнопкой мыши и в появившемся контекстном меню выбрать пункт Activate project.
В этом же меню доступны другие действия с проектом (в том числе добавление в проект новых файлов).

Частой ошибкой является редактирование файлов одного проекта, а запуск и тестирование другого проекта. Также если у вас открыт проект и просто отдельный файл программы, то Code::Blocks будет компилировать и запускать только активный проект.
Поэтому в учебных целях, когда весь проект зачастую состоит из одного файла желательно создавать не проекты, а отдельные .cpp файлы.

Other Plugins

• abbreviations: Applied patch to fix abbreviations target is missing in some project files (thanks stahta01)
• abbreviations: Fixed bug in with non-alpha-numeric character abbreviations (thanks BlueHazzard)
• cb_share_config: Added simple “export all” functionality for easy backup of all config stubs to a backup folder
• cbp2make: Added (further improved) cbp2make by mirai-computing due to project seems dead otherwise
• CodeStat: Fix assert in the progress update (thanks blauzahn)
• cscope: Fix hang of cscope when given a missing file (ticket #448 Robert Morin)
• help: allow to search for keywords also on CPlusPlus.com
• DoxyBlocks: Clean up the UI a bit
• DoxyBlocks: Filter out comment strings in the parameter documentation (thanks Yves De Muyter)
• HexEditor: Change the label of the OK button to Find
• HexEditor: Limit vertical resizing of the search dialog
• HexEditor: Fix text misalignment when selecting numbers in the editor
• IncrementalSearch: wx3 compatibility-fix
• ProjectImporter: Better handling for more recent VC workspaces / project files (patch by unknown person)
• SourceExporter/NassiShneiderman: Make sure only one File -> Export menu is created no matter which plugin is created first
• SourceExporter: Fix undefined behaviour
• ThreadSearch: Add option to disable/enable the autosizing of log columns (fixes #324, thanks Sergey Bezgodov)
• ThreadSearch: Fix infinite filesystem traversal when there are cyclic symlinks present
• todo: Display count of list item (ticket #452 Sergey Bezgodov)
• todolist plugin: some code improvements by frithjofh
• Valgrind: Quote the path to the xml file if needed — makes the plugin work when the project is located in a path with spaces

Debug

Menu Path
Function
Keyboard Shortcut
Debug > Start / Continue
Run current project in debugger
F8
Debug > Stop debugger
Stop current debugging session
Shift-F8
Debug > Run to cursor
Run program until it reaches the current line
F4
Debug > Next line
Execute the next line of code
F7
Debug > Step into
Execute the next line of code, but step inside functions
Shift-F7
Debug > Step out
Continue execution until the current frame exits
Ctrl-F7
Debug > Next instruction
Execute the next assembly instruction
Alt-F7
Debug > Step into instruction
Execute the next assembly instruction, if it is a function call step into it
Alt-Shift-F7
Debug > Toggle breakpoint
Toggle breakpoint in current line
F5

Misc (targeting wx3)

• Fix assert when loading files and the global enconding setting is set to default (ticket #305)
• Fix assert when closing the application during long compilation
• Memory dump window has wrong proportion on windows (ticket #557, thanks bluehazzard)
• Fix assert when executing Build -> Errors -> Next error and there is no error in the list
• Fix the highlight language button in the status bar
• Fix assert when pressing the auto-detect button in the compiler settings
• Always disable symbol browser in such builds to prevent crashes (ticket #225)
• Fix compilation with latest wx master (thanks blauzahn)
• Fix assert on startup in IncrementalSearch (ticket #405, thanks bluehazzard)
• Fix assert due to the same labeled property added to the wxSmith’s property grid for wxStdDialogButtonSizer
• Fix some alignment asserts reported for some of the dialogs
• Fix assert when calling wxSetWorkingDirectory with an empty path
• Fix two asserts in the AVR wizard
• Fix lots of asserts when batch building (there are some left though)
• Fix assert when the current target uses “No compiler” (fixes ticket #315)
• Fix asserts when wizard icons are no 32×32 pixels big (fixes ticket #314)
• Fix an assert in ToDo plugin (thanks blauzahn)
• Fix assert when deleting a compiler
• Fix assert when the search mask in the Find/Replace dialog is empty (fix formatting of the code around)
• Fix the ValueTooltip autosizing. It was disabled for wx29, but should work in all wx3.0, because my patch should be in them

Summary, for download

Download the full changelog here: http://sourceforge.net/projects/codeblocks/files/Binaries/17.12/changelog

Не хватает нужных компонентов (компилятора, отладчика, библиотек)

Нужно понимать, что CodeBlocks — это просто каркас для подключения различных инструментов. Если вы просто скачаете пустой CodeBlocks с официального сайта и попытаетесь писать и отлаживать программу, то у вас ничего не получится. CodeBlocks не сможет запустить ни комплятор, ни отладчик. Все это нужно скачивать и устанавливать отдельно.

Но тут будет новая проблема — проблема выбора. CodeBlocks поддерживает все существующие компиляторы Си, какой выбрать? То же относится к любому другому инструментарию: отладчикам, профайлерам, плагинам и т.д.

Именно поэтому я и сделал сборку Си-экспресс, чтобы можно было сразу распаковать и работать. Все нужные компоненты уже установлены. Если вы точно знаете, что вам нужен другой компонент, то просто найдите и замените его на тот, который вам нужен.

Решение: Скачайте сборку Си-экспресс.

Install Instructions

• Nightly Build (frequently updated: 22 May 2010)
  • Those are the 3 things we need to install and start up a nigthly build. All 3 of them are available in their own zip file, zipped by using the free and excellent 7-zip (www.7-zip.org). Just get your copy of 7-zip for unzipping.
  • Final steps :
    • unzip the CB nightly in some directory
    • unzip both dll’s : requirement : they need to be in your PATH, most easiest is to unzip both of them into the same directory where you unzipped the nightly, so they reside next to the codeblocks.exe .
  • By performing these simple steps you nightly is ready to roll.

• Build from source

• • There is a detailed description on the codeblocks wiki related to your os

Installation instructions / Howto for Debian/Ubuntu/Mint

Download and install Debian package for D compiler ] (32bit) or ] (64bit).

Then, i.e. after installing dmd2, install the «codeblocks» debian package (No download necessary; it’s in the standard repositories, so «sudo apt-get install codeblocks» will do fine).

Start code:blocks and go to «Settings»->»Compiler».

• • Click «Compiler Settings» and change the sub-tab to «Other options». Then enter «-m32» in the edit field (or «-m64» if you are running on amd64 (x86_64). If you are unsure, enter «uname -p» in a terminal to find out)
  • Next, click on the «Linker Settings» tab and add «phobos2» into the «link libraries» (Do not change/edit/delete the «m» and «pthread» entries and do not enter libphobos2 or similar as suggested by some online resources but simply «phobos2»).
  • Next, click on the «Search directories» tab and then on «Compiler» and add the two entries «/usr/include/dmd/druntime/import» and «/usr/include/dmd/phobos».
  • Next, click the «Linker» sub tab and add or edit «/usr/lib/i386-linux-gnu» (or «/usr/lib/x86_64-linux-gnu» for the 64bit version).
  • Next, click on the «Toolchain executables» tab and enter or change the «Compilers installation directory» to «/usr».
  • Finally, adapt the edit field under «Program files» for «Linker for dynamic libs» to your needs, typically to «gcc -m32 -lrt» (again, replace «-m32» with «-m64» for a 64bit version).

That’s it. Now, you can create a D project and it should compile/link fine. 😉

Usage¶

This section discusses how to use different syntax highlighting features with Pygments – the default highlighter – so they don’t apply when using a JavaScript syntax highlighter.

Specifying the language

Code blocks must be enclosed with two separate lines containing three backticks. To add code highlighting to those blocks, add the language short name directly after the opening block. See the list of available lexers to find the short name for a given language.

Example:

Result:

Adding annotations

Source · Experimental · Insiders only

Annotations offer a comfortable and friendly way to attach explanations to arbitrary sections of code blocks by adding simple markers within block/inline comments that refer to items of a list following the code block, i.e. , , etc. Material for MkDocs detaches the list from the flow of the document, injects the content of each list item into a tooltip, and links each list marker to the corresponding tooltip.

In order to opt-in to annotation support, a slightly different syntax is required – just add the respective language short code and the class, after the three backticks. Alternatively, if you want to enable annotations globally, add the following to :

Note that annotations can be placed anywhere in a code block where a comment for the language can be placed, which for JavaScript is and , for Yaml , etc.

Example:

Result:

1. Annotations can contain arbitrary content which is shown when the marker is focussed, including any kind of formatting, links, admonitions, details, and even diagrams:

   Tip: You can use Tab to navigate annotations.

2. Annotations can be placed anywhere in a code block were a comment for the underlying language can be placed.

   Python JavaScript Lua

   We’re working on a solution for languages without comments, which will be available shortly.

3. Of course, this can be combined with , highlighting and all other code block related features.

Annotations require syntax highlighting with – they’re currently not compatible with other JavaScript-based syntax highlighters. Support may be added later on.

Adding line numbers

Line numbers can be added to a code block by using the option directly after the short name, whereas represents the starting line number. A code block can start from a line number other than , which allows splitting large code blocks for readability.

Example:

Result:

1
2
3
4
5

Highlighting specific lines

Specific lines can be highlighted by passing the line numbers to the argument placed right after the language short name. Note that line counts start at , regardless of the starting line number specified as part of .

Example:

Result:

Line ranges can also be used for conveniently specifying multiple lines.

Example:

Result:

Highlighting inline code blocks

When is enabled, inline code blocks can be highlighted by prefixing them with a shebang-like sequence, i.e. , directly followed by the language short name.

Example:

Result:

The function is used to generate a sequence of numbers.

Adding keyboard keys

When is enabled, keyboard keys can be rendered with a simple syntax. Consult the Python Markdown Extensions documentation to learn about all available key codes.

Example:

Result:

Ctrl+Alt+Del

Embedding external files

Also known as transcludes or file transclusion in MultiMarkdown.

When is enabled, content from other files can be embedded, which is especially useful to reference and embed the contents of source files directly into your project documentation.

Example:

Result:

Note that is not limited to code blocks, but can be used anywhere from a document to move repeating content to separate files, which is also explained in the official documentation.

Misc

• Support for new lexers: BibTeX, Coffee, IHex, JavaScript, Proty, Windows-Registry files, SREC, TeHEX
• Editor: Add menu commands for searching the selected text without opening the find-replace dialog
• Editor: Mark editor tabs of read-only files with an icon
• New tool: CbLauncher to launch C::B under Windows using modified application path’s variables (for experts)
• New version of crash handler (exchndl): More resiliency against truncated PE files and log message when loading symbols
• New command line option –user-data-dir= to specify an alternative directory for user settings and user installed plugins
• ‘Add file(s)’ doesn’t account for all generated files for all target’s compilers
• Assign CRTL+P to the “Print” command by default
• Save notebook layout in project- and workspace-layout files (and load it from there)
• Save tab-layout of the files belonging to the project in a project-layout file; save all tabs in a workspace-layout file
• Better multi monitor support for non windows system
• Introduce new API’s to SDK for convenience
• Scripting: Expose several new API’s
• Add versioning to project and workspace layout files
• Re-organised editor settings to make the grouping more logical
• Removed obsolete google code search, added StackOverflow and CodeProject search
• File properties: Count statistics language independantly
• SmartIndent: Handle (some) smart indentation for embedded languages (PHP, JavaScript, etc) within HTML
• Fixed plugin installation errors under Windows
• Make the check for externally modified files configurable, useful for slow network shares
• Ignore VCS (SVN, GIT, Mercurial…) folders when recursively adding files
• Avoid conflicts in portable mode
• Allow to clean a single object file within a project tree from project manager
• Updated C++ lexer keywords for more correctness
• Linux: Use standard-conform paths for config- and data-folders
• Support for Windows 10
• Many UI improvements
• Many other bug-fixes and improvements

Summary, for download

Download the short (this) changelog here: http://sourceforge.net/projects/codeblocks/files/Binaries/16.01/changelog

Download the full changelog here: http://sourceforge.net/projects/codeblocks/files/Binaries/16.01/changelog_full

Debugger

• Fix issue with watches window column auto-sizing
• Better auto-sizing in the CPU registers dialog
• Fix infinite loop when parsing watches generated by Python pretty printers
• Fix parsing gdb locals/arguments when the values contain escaped double and single quotes
• Add support for executing additional shell commands when using GDB
• Add flag to enable/disable loading of .gdbinit
• Expand macros in the additional GDB commands
• Improve logging, while trying to interrupt the debuggee
• Try to detect when the terminal couldn’t be started and print an error instead of entering annoying loop
• Determine console pid from ps-command, returns either the same as we have now (e.g. xterm) or the pid of the sleep-command and works therefore also with newer gnome-terminals

Examples

There’s nothing like learning by example! Here are a few contrived examples of things you can accomplish
with code blocks.

HTTP

The object (representing the HTTP user agent belonging to the currently running bot) has methods for all of the
common HTTP methods (GET, POST, etc).

Response Validation

Validators (similar to the Validation Rules that you can use with ordinary
HTTP steps) call a JavaScript function to examine the response and return true if it’s valid, or false if it’s not.

Validator functions can be normal JavaScript functions or the newer ES2016+ arrow functions.

You can specify multiple validator functions for a single response.

Response Capturing

Often, the server will send you some data that you need to save and use later in your script.

In code blocks, you can capture these from the response and store them using a validator function. Note that we use
the for capturing too; there is no separate property
for Capturing Rules as there is with ordinary HTTP steps.

Simply call anywhere in your code block to set a bot-scoped variable. These special
variables are available for the bot’s entire iteration of the Loadster script, unlike ordinary JavaScript variables
which are scoped to the individual code block and may not be available to subsequent steps.

Looping and conditionals can be done with all the usual JavaScript language constructs. This trivial example shows
looping with a loop, the modulus function, an statement, and setting and getting special bot
variables with variable interpolation of .

Code-Completion

• Fix crash when showing the call tip
• Fix doxygen spelling in the settings panel
• Make the size of toolbar controls configurable in the settings (ticket #303)
• Fix an issue that Code Completion list got hidden after shown up
• Fix assert on generate ctor implementation
• Fix possible inconsistency caused by bad usage of cbAssert — the expression must not have side effects, because in some builds they might not be executed
• Fix default colours for code call tips (thanks darmar)
• Send proper events for ‘Autoselect single match’
• Automatically test for doxygen document. (thanks White-Tiger)
• Fix a bug that we have forget adding the doxygen documents for macro
• Fix a endless loop crash bug when parsing C99 designated initializer
• Fix ticket #278 and ticket #393 (thanks White-Tiger)
• Fix ticket #351
• Try to fix issue #14 for real this time (high memory consumption due to recursive symbolic links)
• show an error to the user if expression could not be resolved
• Fix a parsing std namespace bug.