3.7 Параметры управления форматированием сообщений диагностики

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

-fmessage-length=n

Попытаться отформатировать сообщения об ошибках так, чтобы они помещались на строках примерно в n символов. Если n равно нулю, то перенос строки не выполняется; каждое сообщение об ошибке отображается на одной строке. По умолчанию для всех передних частей языка.

-fdiagnostics-show-location=once

Значимо только в режиме переноса строк. Указывает программе отображения сообщений диагностики выводить информацию о расположении источника один раз; то есть, если сообщение слишком длинное для одной строки и должно быть перенесено на несколько строк, информация о расположении источника не будет выводиться (в качестве префикса) снова и снова на последующих строках. Это поведение по умолчанию.

-fdiagnostics-show-location=every-line

Значимо только в режиме переноса строк. Указывает программе отображения сообщений диагностики выводить одну и ту же информацию о расположении источника (в качестве префикса) для каждой физической строки, полученной при переносе сообщения, которое слишком длинное для одной строки.

-fdiagnostics-color[=WHEN]

-fno-diagnostics-color

Использовать цвет в сообщениях диагностики. WHEN может принимать значения ‘never’, ‘always’ или ‘auto’. По умолчанию зависит от конфигурации компилятора, может принимать любые из указанных значений WHEN или также ‘never’, если переменная среды GCC_COLORS не присутствует в среде, и ‘auto’ в противном случае. ‘auto’ означает использование цвета только тогда, когда стандартный вывод ошибки является терминалом. Формы -fdiagnostics-color и -fno-diagnostics-color являются псевдонимами для -fdiagnostics-color=always и -fdiagnostics-color=never соответственно.

Цвета определяются переменной среды GCC_COLORS. Ее значение представляет собой список способностей и подстрок Select Graphic Rendition (SGR), разделенных двоеточиями. Команды SGR интерпретируются терминалом или эмулятором терминала. (См. раздел документации вашего текстового терминала для допустимых значений и их значений как атрибутов символов.) Эти значения подстрок являются целыми числами в десятичном представлении и могут быть соединены точками с запятой. Общие значения для объединения включают ‘1’ для полужирного шрифта, ‘4’ для подчеркивания, ‘5’ для мигания, ‘7’ для инверсии, ‘39’ для стандартного цвета переднего плана, ‘30’ до ‘37’ для цветов переднего плана, ‘90’ до ‘97’ для цветов переднего плана в 16-цветном режиме, ‘38;5;0’ до ‘38;5;255’ для цветов переднего плана в 88-цветном и 256-цветном режимах, ‘49’ для стандартного цвета фона, ‘40’ до ‘47’ для цветов фона, ‘100’ до ‘107’ для цветов фона в 16-цветном режиме и ‘48;5;0’ до ‘48;5;255’ для цветов фона в 88-цветном и 256-цветном режимах.

Значение по умолчанию GCC_COLORS равно

error=01;31:warning=01;35:note=01;36:caret=01;32:locus=01:quote=01

где ‘01;31’ — полужирный красный, ‘01;35’ — полужирный пурпурный, ‘01;36’ — полужирный синий, ‘01;32’ — полужирный зелёный и ‘01’ — полужирный. Установка GCC_COLORS в пустую строку отключает цвета. Поддерживаемые возможности следующие.

error=

Подстрока SGR для ошибки: маркеры.

warning=

Подстрока SGR для предупреждения: маркеры.

note=

Подстрока SGR для заметки: маркеры.

caret=

Подстрока SGR для строки указателя.

locus=

Подстрока SGR для информации о расположении, ‘file:line’ или ‘file:line:column’ и т.д.

quote=

Подстрока SGR для информации, напечатанной в кавычках.

-fno-diagnostics-show-option

По умолчанию каждое выводимое сообщение диагностики включает текст, указывающий параметр командной строки, который напрямую управляет диагностикой (если такой параметр известен механизму диагностики). Указание флага -fno-diagnostics-show-option подавляет это поведение.

-fno-diagnostics-show-caret

По умолчанию каждое выводимое сообщение диагностики включает исходную строку и символ «^» для указания столбца. Этот параметр подавляет эту информацию. Строка исходного кода усекается до n символов, если задан параметр -fmessage-length=n. При выводе на терминал ширина ограничивается шириной, заданной переменной среды COLUMNS, или, если она не установлена, шириной терминала.

Далее: Параметры предупреждений, Предыдущее: Параметры диалектов Objective-C и Objective-C++, Вернуться к: Вызов GCC [Оглавление][Индекс]