Используйте вспомогательные функции отладки

 

Типичной методикой, применимой во многих случаях, является использование набора значений флагов; когда флаг установлен (т.е. равен true), имеет место определенный факт или применяется определенное условие. Обычно это осуществляется при помощи именованных констант и битовых операторов С. (Использование битовых флагов и операторы работы с битами мы обсуждали во врезке к разделу 8.3.1 «Стиль POSIX: и».)

Например, главная структура данных называется. У нее большое количество полей, последнее из которых является набором значений флагов. Из файла:

 

 

Причина для использования значений флагов заключается в том, что они значительно экономят пространство данных. Если бы структура для каждого флага использовала отдельное поле, потребовалось бы 12 байтов вместо 2, используемых. Текущий размер (на Intel x86) 32 байта. Добавление лишних 10 байтов увеличило бы ее до 42 байтов. Поскольку может потенциально выделять сотни и тысячи (или даже миллионы) [170], сохранение незначительного размера является важным.

Что это должно делать с отладкой? Разве мы не рекомендовали только что использовать для именованных констант? Ну, в случае объединяемых побитовыми ИЛИ значений не помогают, поскольку они больше не являются индивидуально распознаваемыми!

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

 

ЗАМЕЧАНИЕ. Необычность этих функций отладки заключается в том, что код приложения никогда их не вызывает. Они существуют лишь для того, чтобы их можно было вызывать из отладчика. Такие функции всегда должны быть откомпилированы с кодом, даже без окружающих, чтобы их можно было использовать. не предпринимая никаких дополнительных шагов. Увеличение (обычно минимальное) размера кода оправдывается экономией времени разработчика

 

Сначала мы покажем вам, как мы это делали первоначально. Вот (сокращенная версия) из ранней версии (3.0.6):

 

(Номера строк даны относительно начала функции.) Результатом является строка, что‑ то наподобие "". Каждый флаг тестируется отдельно, и если он присутствует, действие каждый раз одно и то же: проверка того, что он не в начале буфера и что можно добавить символ '', скопировать строку на место и обновить указатель. Сходные функции существовали для форматирования и отображения других видов флагов в программе.

Этот код является повторяющимся и склонным к ошибкам, и для 3.1 мы смогли упростить и обобщить его. Вот как делает это сейчас. Начиная с этого определения в:

 

Эту структуру можно использовать для представления любого набора флагов с соответствующими строковыми значениями. Каждая отдельная группа флагов имеет соответствующую функцию, которая возвращает печатное представление флагов, которые установлены в настоящее время. Из:

 

 определяет массив сопоставлений флагов со строками. По соглашению, значение флага 0 означает конец массива. Код вызывает для осуществления работы («общий флаг в строку»). является процедурой общего назначения, которая преобразует значение флага в строку. Из:

 

 

(Номера строк приведены относительно начала функции, а не файла.) Как и в предыдущей версии, идея заключалась в заполнении статического буфера строковыми значениями, такими, как "", и возвращении адреса этого буфера. Мы вскоре обсудим причины использования статического буфера; сначала давайте исследуем код.

Указатель отслеживает положение следующего пустого слота в буфере, тогда как отслеживает количество оставшегося места; это уберегает нас от переполнения буфера.

Основную часть функции составляет цикл (строка 12), проходящий через массив значений флагов. Когда флаг найден (строка 13), код вычисляет, сколько места требуется строке (строка 18) и проверяет, осталось ли столько места (строки 19–20).

Тест '' для первого значения флага завершается неудачей, возвращая 0. Для последующих флагов тест дает значение 1. Это говорит нам, что между значениями должен быть вставлен разделительный символ ''. Добавляя результат (1 или 0) к длине строки, мы получаем правильное значение. Тот же тест с той же целью проводится в строке 22 для проверки строк 23 и 24, которые вставляют символ ''.

В заключение строки 26–29 копируют значение строки, выверяют количество оставшегося места и обновляют указатель. Строка 33 возвращает адрес буфера, который содержит печатное представление строки.

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

Более того, статический буфер по определению является буфером фиксированного размера. Что случилось с принципом GNU «никаких произвольных ограничений»?

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

На практике фиксированный размер также не является проблемой; мы знаем, что размер достаточен для представления всех флагов, которые мы используем. Тем не менее, поскольку мы опытные и знаем, что вещи могут измениться, в есть код, предохраняющий себя от переполнения буфера. (Переменная и код в строках 18–20.)

В качестве отступления, использование спорно. Эта константа должна использоваться исключительно для буферов ввода/вывода, но часто она используется также для общих строковых буферов. Такой код лучше убрать, определив явные константы, такие, как, и использовав в строке 11 ''.

Вот сокращенный сеанс GDB, показывающий использование:

Gdb gawk

 

 

break do_print

 

run 'BEGIN { print "hello, world" }'

 

print *tree

 

 

print flags2str(tree‑>flags)

 

Next

 

print *t[i]

 

print flags2str(t[i]‑>flags)

 

Надеемся, вы согласитесь, что настоящий механизм общего назначения значительно более элегантный и более простой в использовании, чем первоначальный.

Тщательное проектирование и использование массивов структур часто может заменить или слить воедино повторяющийся код.