Улучшение удобочитаемости кода

Расположение с отступом кода

Расположение с отступом кода делает операторы чтения, такие как while легче циклы. Установить и применить делающие отступ настройки к коду в Редакторе:

  1. На вкладке «Главная страница (Home)» в разделе «Конфигурация (Environment)» нажмите «Настройки (Preferences)».

    Диалоговое окно Preferences открывается.

  2. Выберите MATLAB> Editor/Debugger> Language.

  3. Выберите машинный язык из Language выпадающий список.

  4. В разделе Indenting выберите или очистите Apply smart indenting while typing, в зависимости от того, хотите ли вы делать отступ примененный автоматически при печати. Умное расположение с отступом всегда применяется автоматически в Live Editor.

    Если вы очищаете эту опцию, можно вручную применить расположение с отступом путем выбора линий в Редакторе, чтобы сделать отступ, щелчок правой кнопкой и затем выбор Smart Indent из контекстного меню.

  5. Выполнить одно из следующих действий:

    • Если вы выбрали какой-либо язык кроме MATLAB на шаге 2, нажмите OK.

    • Если вы выбрали MATLAB на шаге 2, выберите Function indenting format, и затем нажмите OK. Функциональные форматы отступа:

      • Classic — Редактор выравнивает функциональный код с объявлением функции.

      • Indent nested functions — Редактор располагает функциональный код с отступом во вложенной функции.

      • Indent all functions — Редактор располагает функциональный код с отступом и для основных и для вложенных функций.

    Это изображение иллюстрирует форматы расположения с отступом функции.

Примечание

Делающие отступ настройки не поддержаны для TLC, VHDL или Verilog.

Независимо от того, применяете ли вы расположение с отступом автоматически или вручную, можно переместить выбранные линии далее налево или направо путем выполнения одного из следующих действий:

  • На вкладке Editor, в разделе Edit, нажатии кнопки, или. Для live скриптов и функций, эта функциональность доступна на вкладке Live Editor в разделе Code.

  • Нажатие клавиши Tab или ключа Shift+Tab, соответственно.

    Это работает по-другому, если вы выбираете Редактор/Отладчик настройка Tab клавише TAB Emacs-стиля умное расположение с отступом — когда вы располагаете курсор в любую линию или выбираете группу линий и нажимаете Tab, отступ линий согласно умным методам расположения с отступом.

Текстовый предельный индикатор правой стороны

По умолчанию светло-серая вертикальная линия (правило) появляется в столбце 75 в Редакторе, указывая, где линия превышает 75 символов. Можно установить этот текстовый предельный индикатор на другое значение, которое полезно, например, если вы хотите просмотреть код в другом текстовом редакторе, который имеет различный предел ширины линии. Текстовый предельный индикатор правой стороны не поддержан в Live Editor или в MATLAB® Online™.

Скрыть, или изменить внешний вид вертикальной линии:

  1. На вкладке «Главная страница (Home)» в разделе «Конфигурация (Environment)» нажмите «Настройки (Preferences)».

    Диалоговое окно Preferences открывается.

  2. Выберите MATLAB> Editor/Debugger> Display.

  3. Настройте настройки в разделе Right-hand text limit.

Примечание

Этот предел является визуальной подсказкой только и не препятствует тому, чтобы текст превысил предел. Чтобы перенести текст комментария в заданном номере столбца автоматически, настройте настройки в разделе Comment formatting под MATLAB> Editor/Debugger> Language в диалоговом окне Preferences.

Сворачивание кода - расширяет и сворачивает построения кода

Сворачивание кода является способностью расширить и свернуть определенный MATLAB, программируя построения. Это улучшает удобочитаемость, когда файл содержит многочисленные функции или другие блоки кода, которые вы хотите скрыть, когда вы в настоящее время не работаете с той частью файла. MATLAB программируя построения включает:

  • Секции кода для выполнения и публикации кода

  • Код класса

  • for и parfor блоки

  • Функция и справка класса

  • Функциональный код

Чтобы видеть целый список построений, выберите Editor/Debugger> Code Folding в диалоговом окне Preferences.

Чтобы расширить или свернуть код, щелкните плюс или знак "минус", который появляется слева от построения в Редакторе. Вы также используете Ctrl+Shift+. (period) и горячие клавиши Ctrl+. (period), или используете кнопки сворачивания кода во вкладке View.

Чтобы расширить или свернуть весь код в файле, установите свой курсор где угодно в файле, щелкните правой кнопкой, и затем выберите Code Folding > Expand All или Code Folding > Fold All из контекстного меню. Также можно использовать Ctrl+Shift+, (comma) и горячие клавиши Ctrl+, (comma) или кнопки сворачивания кода во вкладке View.

Примечание

Сворачивание кода не поддержано в Live Editor

Просмотр свернутого кода в подсказке

Можно просмотреть код, который в настоящее время свернут путем расположения указателя по его замещающему знаку. Код появляется в подсказке. Просмотр свернутого кода в подсказке не поддержан в MATLAB Online.

Следующее изображение показывает подсказку, которая появляется, когда вы помещаете указатель по замещающему знаку на линии 23 из lenghtofline.m когда for цикл свернут.

Печать файлов со свернутым кодом

Если вы распечатываете файл с одним или несколькими свернутыми построениями, те построения расширены в печатной версии файла.

Код, Сворачивающий Поведение для Функций, которые Не Имеют Никакого Явного Оператора end

Если вы включаете код, сворачивающийся для функций, и функция в вашем коде не заканчивается явным end оператор, вы видите следующее поведение:

  • Если линия, содержащая только, комментирует, появляется в конце такой функции, то Редактор не включает ту линию при сворачивании функции. Это вызвано тем, что MATLAB не включает конечный пробел и комментарии в функциональном определении, которое не имеет никакого явного end оператор. В MATLAB Online Редактор действительно включает линию при сворачивании функции.

    Код, Сворачивающийся Enabled для Функционального Кода Только, иллюстрирует это поведение. Линия 13 исключена из сгиба для foo функция.

  • Если сгиб для секции кода перекрывает функциональный код, то Редактор не показывает сгиб для перекрывающегося раздела.

    Три фигуры, которые следуют, иллюстрируют это поведение. Первые две фигуры, Код, Сворачивающийся Enabled для Функционального Кода Только и Кода, Сворачивающегося Enabled для Разделов Только, иллюстрируют, как сворачивание кода появляется, когда вы включаете его для функционального кода только и затем разделяете только, соответственно. Последняя фигура, Код, Сворачивающийся Enabled и для Функций и для Разделов, иллюстрирует эффекты, когда сворачивание кода включено для обоих. Поскольку сгиб для раздела 3 (линии 11–13) перекрывает сгиб для функционального foo (линии 4–12), Редактор не отображает сгиб для раздела 3.

Код, сворачивающийся Enabled для функционального кода только

Код, сворачивающийся Enabled для разделов только

Код, сворачивающийся Enabled и для функций и для разделов

Рефакторинг кода — Автоматически преобразует выбранный код в функцию

В Live Editor можно повредить большие live скрипты или функции в мелкие кусочки путем автоматического преобразования выбранных областей кода в функции или локальные функции. Это называется кодом refactoring.

Осуществлять рефакторинг выбранную область кода:

  1. Выберите одну или несколько строк кода.

  2. На вкладке Live Editor, в разделе Code, нажимают Refactor и выбор из доступных параметров.

  3. Введите имя для новой функции. MATLAB создает функцию с выбранным кодом и заменяет оригинальный код на вызов недавно эмпирическая функция.

Рефакторинг также доступен в Редакторе в MATLAB Online. Чтобы осуществить рефакторинг выбранную область кода в MATLAB Online Редактор, на вкладке Editor, в разделе Edit, нажимают кнопку рефакторинга кода. Затем выберите из доступных параметров.

Для просмотра документации необходимо авторизоваться на сайте