7. исследование данных

ddd предоставляет несколько средств для исследования данных.

• самый быстрый способ исследования переменных -- навести указатель мыши на появление переменной в исходном тексте. значение показывается исходной строке: спустя секунду появляется всплывающее окно (называемое подсказкой для значения) со значением переменной. это полезно для быстрого просмотра нескольких простых значений.
• если вы хотите иметь возможность позже ссылаться на значения переменных, вы можете напечатать значение в консоли отладчика. это позволяет отображать и исследовать большие структуры данных.
• если вы хотите исследовать сложные структуры данных, вы можете графически отобразить их в окне данных. отображения остаются до тех пор, пока вы их не удалите; они обновляются при каждом останове программы. отображения полезны для больших, динамических структур.
• если вы хотите исследовать массивы численных значений, вы можете построить график в отдельном окне. график обновляется при каждом останове программы. это бывает полезно для больших численных массивов.
• при использовании gdb или dbx вы также можете исследовать содержимое памяти в нескольких форматах, независимо от типов данных вашей программы.

7.1 просмотр простых значений с помощью подсказок

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

подсказки для значений можно выключить через `edit => preferences => general => automatic display of variable values as popup tips'.

показ значений в строке состояния выключается через `edit => preferences => general => automatic display of variable values in the status line'.

эти настройки привязаны к следующим ресурсам:

ресурс: valuetips (класс tips)

включены ли подсказки для значений (`on', по умолчанию) или выключены (`off'). подсказки для значений влияют на производительность ddd и могут раздражать некоторых опытных пользователей.

ресурс: valuedocs (класс docs)

следует ли отображать значения переменных в строке состояния (`on', по умолчанию) или нет (`off').

7.2 печать простых значений в консоли отладчика

значение переменной можно также напечатать в консоли отладчика, что делает его доступным для будущих операций. чтобы напечатать значение какой-то переменной, выберите ее, щелкнув первой кнопкой мыши на ее имени. имя переменной будет скопировано в поле аргумента. если теперь щелкнуть на кнопке `print', значение напечатается в консоли отладчика. кроме того, значение показывается в строке состояния.

есть более быстрый вариант: вы можете просто нажать на имени переменной третью кнопку мыши и выбрать из всплывающего меню пункт `print'.

при использовании gdb кнопка `print' генерирует команду print, у которой есть еще несколько параметров. см. раздел `examining data' в debugging with gdb, о специфичных для gdb выражениях, переменных и выходных форматах.

7.3 отображение сложных значений в окне данных

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

7.3.1 основы отображения

в этом разделе рассказывается как создавать и удалять отображения и манипулировать ими. базовые операции:

• чтобы отобразить переменную из `()', щелкните на `display'.
• чтобы выделить отображение, щелкните на нем.
• чтобы удалить выделенное отображение, щелкните на `undisplay'.

7.3.1.1 создание единичных отображений

чтобы создать новое отображение, показывающее некую переменную, выберите эту переменную, щелкнув на ее имени первой кнопкой мыши. имя переменной будет скопировано в поле аргумента. если теперь щелкнуть на кнопке `display', в окне данных появится новое отображение. окно данных открывается автоматически, как только вы создаете отображение.

есть более короткий способ: вы можете просто нажать на имени переменной третью кнопку мыши и выбрать из всплывающего меню пункт `display'.

в качестве еще более быстрого способа, можно также дважды щелкнуть на имени переменной.

еще один способ: можно ввести выражение, которое нужно отобразить, в поле аргумента и нажать кнопку `display'.

и наконец: вы также можете набрать команду в подсказке отладчика:

graph display выражение [clustered] [at (x, y)] 
    [dependent on отображение] [[now or] when in область]

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

clustered

если задано, новое отображение создается в группе. см. раздел 7.3.1.8 группировка отображений, обсуждение этой темы.

at (x, y)

если это задано, новое отображение создается в позиции (x, y). иначе используется принимаемая по умолчанию.

dependent on отображение

если это задано, создается связка от отображения с указанным номером или именем. в противном случае связка не создается. см. раздел 7.3.4.1 отображение зависимых значений, для получения дополнительной информации.

when in область

now or when in область

если задано `when in', создание отображения откладывается до тех пор, пока выполнение не достигнет указанной области (это имя функции, как в выводе следа вызовов). если задано `now or when in', ddd сначала пытается создать отображение сразу. отображение откладывается, только если его создание неуспешно. если не задан суффикс `when in' или `now or when in', отображение создается сразу.

7.3.1.2 выбор отображения

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

вы можете выделить отображение, щелкнув на нем первой кнопкой мыши.

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

отдельные отображения можно также выделять, используя курсорные стрелки up, down, left и right.

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

если в процессе выделения нажата клавиша shift, существующее выделение расширяется.

двойной щелчок на заголовке отображения автоматически выделяет это отображение и все соединенные с ним.

7.3.1.3 показ и скрывание подробностей

составные значения (например, записи, структуры, классы и массивы) могут отображаться в развернутом виде, то есть со всеми подробностями, или скрыто, в виде `{...}'.

чтобы увидеть подробности составной величины, выберите эту величину, щелкнув на ее имени или значении первой кнопкой мыши и нажмите кнопку `show'. подробности показываются как для самой составной величины, так и для содержащихся в ней подструктур.

чтобы скрыть подробности составной величины, выберите эту величину, щелкнув на ее имени или значении первой кнопкой мыши и нажмите кнопку `hide'.

при нажатии и удержании первой кнопки мыши на кнопке `show/hide' всплывает меню с другими альтернативами:

show more ()

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

show just ()

показать подробности выделенной составной величины, но скрыть все подструктуры.

show all ()

показать все подробности выделенной составной величины и ее подструктур. этот пункт эквивалентен кнопке `show'.

hide ()

скрыть все подробности выделенной составной величины. этот пункт эквивалентен кнопке `hide'.

есть более быстрый способ: вы можете также нажать на составной величине третью кнопку мыши и выбрать нужный пункт меню.

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

если скрыты все подробности отображения, то такое отображение называется выключенным; на это указывает строка `(disabled)'.

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

graph disable display отображения...

выключает заданные отображения.

graph enable display отображения...

включает заданные отображения.

в этих командах отображения... -- это либо разделенный пробелами список номеров отображений, либо имя одного отображения. если вы задаете отображение по имени, затрагиваются все отображения с этим именем.

для отмены включения или выключения отображений используйте `edit => undo'.

7.3.1.4 поворот отображений

массивы, структуры и списки могут быть ориентированы горизонтально или вертикально. чтобы изменить ориентацию отображения, выделите его, а затем щелкните на кнопке `rotate'.

есть более быстрый способ: вы можете нажать на массиве третью кнопку мыши и выбрать из всплывающего меню пункт `rotate'.

если структура или список ориентированы горизонтально, ddd автоматически не показывает имена членов. это может быть удобно для экономии места.

последняя выбранная ориентация используется при создании новых отображений. если в последний раз вы повернули массив горизонтально, следующий массив будет также ориентирован горизонтально. эти установки сохраняются через `edit => save options'; они связаны с такими ресурсами:

ресурс: arrayorientation (класс orientation)

ориентация массивов. возможны значения `xmvertical' (по умолчанию) и `xmhorizontal'.

ресурс: showmembernames (класс showmembernames)

показывать имена членов структур или не показывать. по умолчанию `on'.

ресурс: structorientation (класс orientation)

ориентация структур. возможны значения `xmvertical' (по умолчанию) и `xmhorizontal'.

7.3.1.5 отображение локальных переменных

вы можете отобразить все локальных переменные сразу, выбрав `data => display local variables'. при использовании dbx, xdb, jdb или perl это отобразит все локальные переменные, включая аргументы текущей функции. при использовании gdb или pydb аргументы содержатся в отдельном отображении, которое активизируется через `data => display arguments'.

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

7.3.1.6 отображение состояния программы

вы можете создать отображение из вывода произвольной команды отладчика. если ввести

graph display `команда`

вывод команды превращается в отображение состояния, которое обновляется при каждом останове программы.

к примеру, команда

graph display `where`

создает отображение состояния с именем `where', которое показывает текущий след вызовов.

если вы используете gdb, ddd предоставляет панель, где вы можете выбрать полезные отображения состояния. нажмите `data => status displays' и подберите нужное отображение из списка.

для обновления отображений состояния при каждом останове требуется некоторое время; их лучше удалять, когда они больше не нужны.

7.3.1.7 обновление окна данных

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

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

вы можете обновить окно данных, выбрав `data => refresh displays'.

в качестве альтернативы, вы можете нажать третью кнопку мыши на фоне окна данных и выбрать пункт `refresh displays'.

ввод

graph refresh

в подсказке отладчика приводит к тому же результату.

7.3.1.8 группировка отображений

если вы исследуете несколько переменных одновременно, выделение для каждой из них отдельного отображения займет много места на экране. поэтому ddd поддерживает группы. группа объединяет несколько логических отображений данных в одно физическое отображение, сберегая экранное место.

есть два способа создания групп:

• вы можете создавать группы вручную. для этого нужно выделить группируемые отображения и выбрать `undisp => cluster ()'. для всех выделенных отображений создается группа. если выделена существующая группа, выделенные отображения будут сгруппированы в нее.
• вы можете создавать группы автоматически для всех независимых отображений данных, так что все новые отображения будут автоматически сгруппированы. это делается через `edit => preferences => data => cluster data displays'.

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

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

• можно разгруппировать отображения вручную, выделив группу и нажав `undisp => uncluster ()'.
• можно разгруппировать все текущие и будущие отображения, сняв установку `edit => preferences => data => cluster data displays'.

7.3.1.9 создание нескольких отображений

чтобы отобразить несколько последовательных объектов одного типа (часть массива или массив динамической длины), вы можете использовать в выражениях для отображения запись `от..до'.

от и до -- это числа, которые обозначают первое и последнее выражение из тех, что следует отобразить. таким образом,

graph display argv[0..9]

создает 10 новых отображений для `argv[0]', `argv[1]', ..., `argv[9]'. эти отображения автоматически группируются (см. раздел 7.3.1.8 группировка отображений), так что вы можете легко обращаться с этим набором, как с массивом.

запись `от..до' можно также применять несколько раз. например,

graph display 1..5 * 1..5

создает удобную маленькую таблицу умножения.

запись `от..до' создает несколько отображений; для их создания и обновления затрачивается некоторое время. если вы хотите отобразить только часть массива, более эффективным будет использование фрагментов массива. см. раздел 7.3.2.1 фрагменты массива, обсуждение этой темы.

7.3.1.10 редактирование всех отображений

вы можете просмотреть состояние всех отображений, выбрав `data => displays'. это вызывает редактор отображений.

редактор отображений показывает свойства каждого отображения с такими полями:

`num'

номер отображения.

`expression'

отображаемое выражение.

`state'

одно из

`enabled'

нормальное состояние.

`disabled'

выключено; все подробности скрыты. для включения используйте `show'.

`not active'

вне области видимости.

`deferred'

будет создано при достижении области видимости (см. раздел 7.3.1.1 создание единичных отображений).

`clustered'

часть группы (см. раздел 7.3.1.8 группировка отображений). для разгруппировки используйте `undisp => uncluster'.

`alias of отображение'

скрытый псевдоним для отображения (см. раздел 7.3.4.3 разделяемые структуры).

`scope'

область видимости, в которой было создано данное отображение. для отложенных отображений это область, в которой оно будет создано.

`address'

адрес отображаемого выражения. используется для раскрытия псевдонимов (см. раздел 7.3.4.3 разделяемые структуры).

7.3.1.11 удаление отображений

чтобы удалить одно отображение, выделите его и нажмите кнопку `undisp'. или вы можете нажать на этом отображении третью кнопку мыши и выбрать пункт меню `undisplay'.

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

чтобы удалить несколько отображений за один раз, используйте кнопку `undisp' в редакторе отображений (вызывается через `data => displays'). выберите любое число отображений и удалите их, нажав `undisp'.

или вы можете применить такую команду ddd:

graph undisplay отображения...

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

если вы используете объединенные окна, то при удалении последнего отображения из окна данных это окно автоматически закрывается. (вы можете изменить это через `edit => preferences => data => close data window when deleting last display'.)

если вы удалили отображение по ошибке, используйте `edit => undo', чтобы снова создать его.

наконец, вы можете также вырезать, копировать и вставлять отображения с помощью пунктов `cut', `copy' и `paste' из меню `edit'. буфер обмена хранит команды, используемые для создания отображений; `paste' вставляет команду в консоль отладчика. это позволяет вам сохранять отображения для будущего использования или копировать их между разными экземплярами ddd.

7.3.1.12 настройка отображений

вы можете использовать следующие ресурсы для управления внешним видом отображений:

ресурс: autoclosedatawindow (класс autoclose)

если это `on' (по умолчанию), а ddd работает в режиме с объединенными окнами, то при удалении последнего отображения окно данных автоматически закрывается. если это `off', окно данных остается даже после удаления последнего отображения.

ресурс: bumpdisplays (класс bumpdisplays)

если некоторое отображение d изменяет размер, и этот ресурс установлен в значение `on' (по умолчанию), ddd присваивает новые положения отображениям, находящимся ниже и правее d, так что расстояние между отображениями остается неизменным. если это `off', другие отображения не передвигаются.

ресурс: clusterdisplays (класс clusterdisplays)

если это `on', новые независимые отображения автоматически группируются. по умолчанию `off', то есть новые отображения не группируются.

ресурс: hideinactivedisplays (класс hideinactivedisplays)

если какое-то отображение выходит из области видимости, и значение этого ресурса равно `on' (по умолчанию), ddd удаляет его. если это `off', отображение просто становится выключенным.

ресурс: showbasedisplaytitles (класс showdisplaytitles)

следует ли придавать базовым (независимым) отображениям заголовки или нет. по умолчанию `on'.

ресурс: showdependentdisplaytitles (класс showdisplaytitles)

следует ли придавать зависимым отображениям заголовки или нет. по умолчанию `off'.

7.3.2 отображение массивов

в ddd есть специальные средства для обращения с массивами.

7.3.2.1 фрагменты массива

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

в ddd вы можете отображать фрагменты с помощью записи `от..до' (см. раздел 7.3.1.9 создание нескольких отображений). но это подразумевает, что вы заранее знаете значения от и до; кроме того, создавать несколько одиночных отображений неэффективно. если вы используете gdb, у вас есть другой способ.

при использовании gdb вы можете отображать последовательные объекты, ссылаясь на непрерывную область памяти как на искусственный массив с помощью бинарного оператора `@'. левая часть `@' должна быть первым элементом желаемого массива и самостоятельным объектом. правая часть -- это желаемая длина массива. результатом является значение-массив, чьи элементы принадлежат типу первого аргумента. первый элемент -- это на самом деле левый аргумент оператора; второй элемент состоит из байт памяти, непосредственно следующих после первого, и так далее.

вот пример. если в программе сказано

int *array = (int *) malloc (len * sizeof (int));

вы можете напечатать содержимое array с помощью

print array[0]@len

и отобразить его, введя команду

graph display array[0]@len

таким образом, общий вид отображения фрагмента массива такой:

graph display массив[первый]@число-элементов

где массив -- это имя отображаемого массива, первый -- это индекс первого элемента, а число-элементов -- это число отображаемых элементов.

левый операнд `@' должен находиться в памяти. значения-массивы, созданные таким методом при помощи оператора `@', ведут себя в отношении индексирования так же, как любые другие массивы, а при использовании в выражениях приводятся к типу указателей.

7.3.2.2 повторяющиеся значения

при использовании gdb значение массива, которое повторяется 10 и более раз, отображается только один раз. это значение показывается с добавленным постфиксом `<nx>', где n -- это число повторений. таким образом, отображение `0x0 <30x>' обозначает массив из 30 элементов, каждый из которых равен `0x0'. это значительно экономит экранное место, особенно в случае с однообразными массивами.

по умолчанию порог для повторяющихся элементов массива равен 10. вы можете изменить эго через `edit => gdb settings => threshold for repeated print elements'. если установить порог в значение 0, gdb (и ddd) будут отображать все элементы массива по отдельности. после изменения установок gdb не забывайте обновить окно данных с помощью `data => refresh displays'.

вы также можете настроить ddd для раздельного отображения элементов массивов:

ресурс: expandrepeatedvalues (класс expandrepeatedvalues)

gdb может печатать повторяющиеся элементы массива в форме `значение <repeated n times>'. если `expandrepeatedvalues' равен `on', ddd будет вместо этого отображать n экземпляров значения. если `expandrepeatedvalues' равен `off' (по умолчанию), ddd отображает значение, добавляя к нему `<nx>' для обозначения повторения.

7.3.2.3 массивы в виде таблиц

по умолчанию ddd располагает двумерные массивы в виде таблиц, так чтобы все элементы массива были выровнены относительно друг друга.(27) чтобы выключить это средство, снимите установку `edit => preferences => data => display two-dimensional arrays as tables'. она связана с таким ресурсом:

ресурс: align2darrays (класс align2darrays)

если `on' (по умолчанию), ddd размещает двумерные массивы в виде таблиц, так чтобы все элементы массива были выровнены относительно друг друга. если `off', ddd понимает двумерный массив как массив одномерных массивов, и выравнивает их по-отдельности.

7.3.3 присваивание переменных

во время работы программы вы можете изменять значения любых переменных.(28)

чтобы изменить значение переменной, введите ее имя в `()' --- например, выбрав отображение или появление переменной в исходном тексте программы. затем щелкните на кнопке `set'. в появившемся диалоговом окне вы можете отредактировать значение переменной; щелчок на кнопке `ok' или `apply' применяет ваше изменение и присваивает переменной новое значение.

чтобы изменить отображаемое значение, вы также можете выбрать пункт `set value' из всплывающего меню.

если вы сделали ошибку, можно применить `edit => undo' и снова присвоить переменной старое значение.

7.3.4 исследование структур

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

7.3.4.1 отображение зависимых значений

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

чтобы создать зависимое отображение, выделите начальное отображение или его часть и введите в поле аргумента `():' зависимое выражение. затем щелкните на кнопке `display'.

используя зависимые отображения, вы можете исследовать структуру, например, дерева, и расположить его в соответствии с вашим интуитивным пониманием дерева как структуры данных.

по умолчанию ddd не распознает разделяемые структуры данных (то есть объект, на который ссылаются несколько других объектов). см. раздел 7.3.4.3 разделяемые структуры, для получения подробной информации о том, как исследовать такие структуры.

7.3.4.2 получение значения по указателю

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

чтобы получить значение по указателю, выделите значение или имя начального указателя и щелкните на кнопке `disp *'. появится новое отображение, показывающее значение по этому указателю.

более быстрый способ: вы можете нажать на значении или имени начального указателя третью кнопку мыши и выбрать пункт меню `display *'.

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

функция `display *()' также доступна по нажатию и удержанию кнопки `display'.

7.3.4.3 разделяемые структуры

по умолчанию ddd не распознает разделяемые структуры данных -- то есть объект, на который ссылаются несколько других объектов. например, если два указателя `p1' и `p2' ссылаются на один и тот же объект `d', отображения `d', `*p1' и `*p2' будут различными, хотя они и обозначают один и тот же объект.

ddd предоставляет специальный режим, в котором такие ситуации детектируются. ddd замечает, когда два или более отображения расположены по одному физическому адресу, и если это так, объединяет все эти псевдонимы в одно отображение, оригинальное отображение данных. этот режим называется режимом детектирования псевдонимов; включается через `data => detect aliases'.

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

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

в каждой подсказке связки есть место для скрытого псевдонима; выделение подсказки эквивалентно выделению этого псевдонима. таким образом, вы можете легко удалять отображения-псевдонимы, просто выделяя подсказку и нажимая `undisp'.

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

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

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

• для детектирования псевдонимов необходимо, чтобы текущий язык программирования предоставлял средства для определения адреса произвольного объекта. на данный момент поддерживаются только си, си++ и java.
• некоторые подчиненные отладчики (например, sunos dbx) выдают некорректный вывод для адресных выражений. если есть указатель p, вы можете проверить правильность работы вашего подчиненного отладчика сравнив значения p и `&p' (если только p не ссылается на самом деле сам на себя). также можно посмотреть, какие адреса показывают для отображений данных в редакторе отображений.
• детектирование псевдонимов слегка замедляет работу ddd, поэтому по умолчанию оно выключено. возможно, его стоит включать только при необходимости -- к примеру, когда вы исследуете какую-то сложную структуру данных -- и выключать во время исследования передачи управления (то есть при пошаговом проходе программы). при переключении режимов ddd автоматически восстановит отображения и связки.

детектирование псевдонимов управляется следующими ресурсами:

ресурс: deletealiasdisplays (класс deletealiasdisplays)

если это `on' (по умолчанию), кнопка `undisplay ()' удаляет все псевдонимы выделенных отображений. если это `off', удаляются только сами выделенные отображения; псевдонимы остаются, и один из них становится видимым.

ресурс: detectaliases (класс detectaliases)

если `on', ddd пытается распознавать разделяемые структуры данных. по умолчанию `off', что означает, что разделяемые структуры не распознаются.

ресурс: typedaliases (класс typedaliases)

если `on' (по умолчанию), для распознавания разделяемых структур ddd требует структурной эквивалентности. если это `off', два отображения с одинаковым адресом считаются псевдонимами друг друга, независимо от их структуры.

7.3.4.4 быстрое создание отображений

в ddd есть быстрое меню часто используемых выражений для работы с отображениями. это меню активизируется нажатием и удержанием кнопки `display', или нажатием на некотором отображении третьей кнопки мыши и выбором `new display', или щелчком на отображении третьей кнопки мыши при нажатой клавише shift.

пункт быстрого меню `other' позволяет создавать новое отображение, которое расширяет быстрое меню.

в качестве примера предположим, что вы выделили отображение с именем `date_ptr'. если выбрать `display => other', появится диалоговое окно, позволяющее ввести новое отображаемое выражение -- к примеру, вы можете преобразовать отображение `date_ptr' в новое отображение `(char *)date_ptr'. если был активизирован переключатель `include in `new display' menu', быстрое меню теперь будет включать новый пункт `display (char *)()', который преобразует любое выделенное отображение отображение в `(char *)отображение'. такие быстрые операции могут сэкономить много времени при исследовании сложных структур данных.

вы можете отредактировать содержимое меню `new display', выбрав его пункт `edit menu'. появится редактор быстрых операций, содержащий все быстрые выражения, которые вы можете отредактировать по своему усмотрению. каждая строка содержит выражение для ровно одного пункта меню. если щелкнуть на `apply', в соответствии с этим текстом будет заново создано меню `new display'. если текст пуст, меню `new display' тоже будет пустым.

ddd также позволяет задавать отдельные метки для определенных пользователем кнопок. вы можете записать такую метку после выражения, отделив ее знаками `//'. эта возможность используется по умолчанию в меню `new display' для gdb, где у каждого преобразования есть своя метка:

/t ()	// convert to bin
/d ()	// convert to dec
/x ()	// convert to hex
/o ()	// convert to oct

если хотите, можете добавить свои преобразования. ddd поддерживает до двадцати пунктов в меню `new display'.

быстрое меню контролируется следующими ресурсами:

ресурс: dbxdisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для dbx.

если строка содержит разделитель метки(29), то строка до разделителя используется в качестве выражения, а строка после разделителя --- в качестве метки. иначе, меткой будет `display выражение'. при вызове строка `()' в выражении заменяется на имя текущего выделенного отображения.

ресурс: gdbdisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для gdb. смотрите описание ресурса `dbxdisplayshortcuts' выше.

ресурс: jdbdisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для jdb. смотрите описание ресурса `dbxdisplayshortcuts' выше.

ресурс: perldisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для perl. смотрите описание ресурса `dbxdisplayshortcuts' выше.

ресурс: pydbdisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для pydb. смотрите описание ресурса `dbxdisplayshortcuts' выше.

ресурс: xdbdisplayshortcuts (класс displayshortcuts)

разделяемый переводами строки список выражений для создания отображений, включаемых в меню `new display' для xdb. смотрите описание ресурса `dbxdisplayshortcuts' выше.

7.3.5 компоновка графа

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

7.3.5.1 перемещение отображений

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

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

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

7.3.5.2 прокрутка окна данных

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

чтобы перейти от полосок прокрутки к панели прокрутки, используйте `edit => startup => data scrolling' и выберите либо `panner', либо `scrollbars'.

эта установка привязана к следующему ресурсу:

ресурс: pannedgrapheditor (класс pannedgrapheditor)

управляющий элемент, применяемый для прокрутки графа.

• если это `on', используется панель прокрутки athena (вроде двумерной полоски прокрутки).
• если это `off' (по умолчанию), используются две полоски прокрутки motif.

см. раздел 2.1.2 ключи ddd, о ключах --scrolled-graph-editor и --panned-graph-editor.

7.3.5.3 выравнивание отображений

вы можете выровнять все отображения по ближайшим узлам сетки, выбрав `data => align on grid'. это бывает полезно, если вы хотите, чтобы все связки были строго горизонтальны или вертикальны.

если установить `edit => preferences => data => auto-align displays on nearest grid point', отображения выравниваются автоматически. когда эта установка включена, отображения можно перемещать только по сетке.

7.3.5.4 автоматическая компоновка

вы можете скомпоновать весь граф как дерево, выбрав `data => layout graph'.

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

чтобы включить более компактную компоновку, можно установить `edit => preferences => data => compact layout'. эта установка реализует альтернативный алгоритм компоновки, где потомки помещаются рядом со своими предками. этот алгоритм подходит только для гомогенных структур.

вы можете включить принудительную компоновку, выставив `edit => preferences => data => automatic layout'. если задействована автоматическая компоновка, граф компонуется после каждого изменения.

7.3.5.5 поворот графа

вы можете повернуть весь граф на 90 градусов по часовой стрелке, выбрав `data => rotate graph'.

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

7.3.6 печать графа

ddd позволяет распечатывать граф на postscript-принтерах или в файлы. это полезно для документирования состояний программы.

чтобы напечатать граф на postscript-принтере, выберите `file => print graph'. введите в поле `print command' команду печати. чтобы начать печать, нажмите кнопку `ok' или `apply'.

еще можно распечатать граф в файл. щелкните на кнопке `file' и введите в поле `file name' имя файла. чтобы создать файл, щелкните на кнопке `print'.

когда граф печатается в файл, возможны два формата:

• `postscript' -- подходит для включения графа в другой документ;
• `fig' -- подходит для последующей обработки с помощью графического редактора xfig или для преобразования в другие форматы (в том числе в @acronym{ibmgl}, tex, @acronym{pic}) с помощью программ transfig или fig2dev.

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

• если во время вызова диалога `print' были выделены какие-либо отображения, устанавливается параметр `selected only'. тогда ddd печатает только эти выделенные отображения.
• параметры `color', `orientation' и `paper size' имеют смысл только для postscript.

эти установки связаны с такими ресурсами:

ресурс: printcommand (класс printcommand)

команда для печати postscript-файла. обычно это `lp' или `lpr'.

ресурс: papersize (класс papersize)

размер бумаги, в формате `ширина x высота'. по умолчанию используется формат iso a4 или `210mm x 297mm'.

7.3.7 как создаются отображения

в этом разделе обсуждается, как ddd на самом деле создает отображения из данных.

7.3.7.1 обработка боксов

все данные, отображаемые в окне данных ddd, предоставляются подчиненным отладчиком. gdb, к примеру, предоставляет список отображений, содержащий символьные выражения, которые следует вычисляют т печатать на стандартный вывод при каждом останове программы. команда gdb `display tree' добавляет к списку отображений `tree' и заставляет gdb печатать значение `tree', например, в виде `tree = (tree *)0x20e98', при каждом останове программы. ddd обрабатывает этот вывод gdb и показывает его в окне данных.

каждый элемент списка отображений, в том виде, в каком он передается от подчиненного отладчика, считывается в ddd и переводится в бокс. боксы -- это такие прямоугольники с определенным содержимым, которые можно отображать в окне данных. различают атомарные и составные боксы. атомарный бокс содержит белый или черный пробел, линию или строку. составные боксы -- это горизонтальные или вертикальные группы других боксов. каждый бокс обладает размером и протяженностью, которые определяют его положение во внешнем пространстве.

составляя все большие и большие боксы ddd создает из структуры данных gdb узел графа, подобно тому, как системы набора текстов вроде tex строят из букв слова, а из абзацев страницы.

такие конструкции легко выражаются посредством функций, задающих зависимость бокса от других боксов. эти функции отображения могут задаваться пользователем, а потом интерпретироваться в ddd, с помощью функционального языка vsl, что означает visual structure language. пользователь может сам задавать vsl-функции, это оставляет большие пространство для расширений и настроек. vsl-функция отображения, которая помещает вокруг своего аргумента рамку, выглядит так:

// поместить рамку вокруг текста text
frame(text) = hrule() 
  | vrule() & text & vrule() 
  | hrule();

здесь hrule() и vrule() -- это примитивы, возвращающие, соответственно, горизонтальную и вертикальную линии. операторы `&' и `|' создают горизонтальное и вертикальное выравнивание своих аргументов.

vsl предоставляет базовые средства, такие как сопоставление с образцом и функции с переменным числом аргументов. функция halign(), к примеру, строит горизонтальное выравнивание для произвольного числа аргументов, которым соответствуют три точки (`...'):

// горизонтальное выравнивание
halign(x) = x;
halign(x, ...) = x & halign(...);

часто используемые функции, вроде halign(), собраны в стандартную библиотеку vsl.

7.3.7.2 построение боксов из данных

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

// атомарные значения
simple_value(value) = value;

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

// массив
array(...) = frame(halign(...));

когда gdb посылает ddd значение массива, вызывается vsl-функция `array()' с элементами этого массива в качестве значений. таким образом, выражение-массив gdb `{1, 2, 3}' вычисляется в vsl как

array(simple_value("1"), simple_value("2"), simple_value("3"))

что эквивалентно

"1" & "2" & "3"

составному боксу, содержащему три горизонтально выровненных строковых бокса. vsl-функция, которая используется в ddd на самом деле, также помещает между элементами разделители, и у нее есть вертикальный вариант.

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

{{"a", "b", "c"}, {"d", "e", "f"}}

представляющий массив строк размером 2 на 3, вычисляется в vsl как

array(array("a", "b", "c"), array("a", "b", "c"))

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

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

// член структуры-записи
struct_member (name, value) = 
  name & " = " & value;

функция отображения struct рисует саму запись с помощью функции valign().(30)

// структура-запись
struct(...) = frame(valign(...));

это простой пример; vsl-функция, которая на самом деле используется в ddd, еще пытается выровнять знаки равенства; кроме того, она гарантирует, что применяются разделители для правильного языка, что свернутые структуры отрисовываются правильно, и так далее.

7.3.7.3 настройка внешнего вида отображений

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

ресурс: vslbasedefs (класс vsldefs)

строка с дополнительными vsl-определениями, которые добавляются ко встроенной библиотеке vsl. этот ресурс добавляется перед ресурсом `vsldefs', который описан ниже; он устанавливается в файле ресурсов по умолчанию ddd. не изменяйте его.

ресурс: vsldefs (класс vsldefs)

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

общий шаблон для замены определения функции функция на новое определение нов_опр такой:

#pragma replace функция
function(аргументы...) = нов_опр;

часто используются такие vsl-функции:

color(бокс, цвет-текста [, цвет-фона])

устанавливает цвет-текста и цвет-фона заданного бокса.

display_color(бокс)

цвет для отображения данных. по умолчанию: `color(бокс, "black", "white")'

title_color(бокс)

цвет заголовка. по умолчанию: `color(бокс, "black")'

disabled_color(бокс)

цвет для выключенных боксов. по умолчанию: `color(бокс, "white", "grey50")'

simple_color(бокс)

цвет для простых значений. по умолчанию: `color(бокс, "black")'

pointer_color(бокс)

цвет для указателей. по умолчанию:`color(бокс, "blue4")'

struct_color(бокс)

цвет для структур. по умолчанию: `color(бокс, "black")'

array_color(бокс)

цвет для массивов. по умолчанию: `color(бокс, "blue4")'

reference_color(бокс)

цвет для ссылок. по умолчанию: `color(бокс, "blue4")'

changed_color(бокс)

цвет для измененных значений. по умолчанию: `color(бокс, "black", "#ffffcc")'

stdfontfamily()

используемое семейство шрифтов. одно из `family_times()', `family_courier()', `family_helvetica()', `family_new_century()' или `family_typewriter()' (по умолчанию).

stdfontsize()

размер шрифта (в пикселях). 0 (по умолчанию) говорит, что следует применять `stdfontpoints()'.

stdfontpoints()

размер шрифта (в десятых долях пункта). 0 говорит, что следует применять `stdfontsize()'. по умолчанию 90.

stdfontweight()

насыщенность шрифта. это либо `weight_medium()' (по умолчанию), либо `weight_bold()'.

чтобы установить цвет указателей в значение "red4", напишите

ddd*vsldefs: \
#pragma replace pointer_color\n\
pointer_color(box) = color(box, "red4");\n

чтобы установить размер шрифта равным 10.0 пунктов, используйте

ddd*vsldefs: \
#pragma replace stdfontsize\n\
#pragma replace stdfontpoints\n\
stdfontsize() = 0;\n
stdfontpoints() = 100;\n

чтобы по умолчанию использовался 12-пиксельный шрифт courier, напишите

ddd*vsldefs: \
#pragma replace stdfontsize\n\
#pragma replace stdfontfamily\n\
stdfontsize() = 12;\n\
stdfontfamily() = family_courier();\n

другие определения, которые вы можете перекрыть с помощью ресурса `vsldefs', смотрите в файле `ddd.vsl'.

ресурс: vsllibrary (класс vsllibrary)

какую библиотеку vsl следует использовать. `builtin' (по умолчанию) означает, что нужно применять встроенную библиотеку, а любое другое значение интерпретируется как имя файла.

ресурс: vslpath (класс vslpath)

разделенный двоеточиями список каталогов, где проводится поиск включаемых vsl-файлов. по умолчанию это `.', текущий каталог.

если дистрибутив исходников ddd у вас установлен в `/opt/src', вы можете использовать следующие установки, чтобы библиотека vsl считывалась из `/home/joe/ddd.vsl':

ddd*vsllibrary: /home/joe/ddd.vsl
ddd*vslpath:    .:/opt/src/ddd/ddd:/opt/src/ddd/vsllib

включаемые vsl-файлы, на которые ссылается `/home/joe/ddd.vsl', сначала ищутся в текущем каталоге `.', потом в `/opt/src/ddd/ddd/', а потом в `/opt/src/ddd/vsllib/'.

вместо того чтобы предоставлять еще одну библиотеку vsl, часто бывает проще задать какие-то незначительные изменения для встроенной библиотеки. подробности смотрите выше, в описании ресурса `vsldefs'.

7.4 построение графика значений

если вам нужно исследовать огромный объем числовых данных, рисунок часто может сказать больше, чем тысяча чисел. поэтому ddd позволяет вам рисовать числовые значения в виде двух- и трехмерных графиков.

7.4.1 построение графиков массивов

ddd может строить графики двух типов числовых значений:

• одномерные массивы. изображаются в двумерном пространстве x/y, где x обозначает индекс массива, а y --- значение элемента.
• двумерные массивы. изображаются в трехмерном пространстве x/y/z, где x и y обозначают индексы массивы, а z -- значение элемента.

чтобы построить график массива фиксированного размера, выделите его имя, щелкнув на нем первой кнопкой мыши. имя массива будет скопировано в поле аргумента. если щелкнуть на кнопке `plot', в окне данных появится новое отображение, а потом будет создано новое окно верхнего уровня, содержащее график значений.

для построения графика массива динамического размера вы должны использовать фрагмент массива (см. раздел 7.3.2.1 фрагменты массива). введите в поле аргумента

массив[первый]@число-элементов

где массив -- это имя отображаемого массива, первый -- это индекс первого элемента, а число-элементов -- это число отображаемых элементов. затем щелкните на `plot', чтобы начать построение графика.

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

graph plot выражение

она работает подобно `graph display выражение' (и принимает такие же аргументы; см. раздел 7.3.1.1 создание единичных отображений), но еще дополнительно показывает значение в окне графика.

каждый раз, когда во время выполнения программы значение изменяется, график обновляется по текущим значениям. окно графика остается активным до тех пор, пока вы не закроете его (через `file => close'), или пока не будет удалено соответствующее ему отображение.

7.4.2 изменение внешнего вида графика

на самом деле ddd не сам строит график. вместо этого он полагается на внешнюю программу gnuplot.

ddd добавляет к окну графика gnuplot полоску меню, которая позволяет вам изменять внешний вид графика:

• меню `view' переключает необязательные части графика, такие как рамки или сетку.
• меню `plot' изменяет стиль графика. параметр `3-d lines' полезен для построение графиков двумерных массивов.
• меню `scale' позволяет использовать логарифмические шкалы, а также включать и выключать засечки шкал.
• меню `contour' добавляет к трехмерным графикам линии контура.

при просмотре трехмерного графика можно менять точку наблюдения с помощью полосок прокрутки. горизонтальная полоска прокрутки поворачивает график вокруг оси z, то есть вправо или влево. вертикальная полоска прокрутки поворачивает вокруг оси y, то есть вверх или вниз.

вы также можете, если хотите, изменять размер окна графика.

7.4.3 построение графиков скалярных и составных значений

кроме графиков массивов, ddd может также строить графики скаляров (простых числовых величин). делается это так же, как для массивов --- вы выбираете числовую переменную, щелкаете на `plot', и появляется график. однако, построение графика скаляра не так интересно. график, не содержащий ничего кроме скаляра, просто отображает значение этого скаляра в виде константы y -- то есть горизонтальную прямую.

тогда зачем вообще беспокоиться о скалярах? ddd позволяет объединять на одном графике несколько значений. основная идея такова: если вы хотите построить график чего-то, что не является ни массивом, ни скаляром, ddd берет из этого чего-то все числовые значения, какие может найти и чертит их графики в одном окне. например, вы можете построить график всех локальных переменных, выбрав `data => display local variables' и нажав затем `plot'. при этом создается график, содержащий все числовые переменные, найденные среди локальных переменных. аналогично, вы можете получить график всех числовых членов какой-то структуры, выбрав ее и нажав `plot'.

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

1. отобразить массив и его индекс с помощью `display'.
2. сгруппировать два этих отображения: выделить их и нажать `undisp => cluster ()'.
3. построить график группы, нажав `plot'.

отображаемые вместе в массивами скаляры могут отрисовываться в виде либо горизонтальных, либо вертикальных линий. по умолчанию скаляры рисуются в виде горизонтальных линий. однако, если скаляр является индексом ранее начерченного массива, он показывается как вертикальная линия. вы можете изменить первоначальную ориентацию, выделив отображение скаляра и нажав `rotate'.

7.4.4 построение графика истории отображений

при каждом останове программы ddd записывает значения всех отображаемых переменных, чтобы вы могли "отменить" выполнение программы (см. раздел 6.8 "отмена" выполнения программы). для таких историй отображений тоже можно построить график. пункт меню `plot => plot history of ()' создает график, в котором показаны все записанные ранее значения выделенного отображения.

7.4.5 печать графиков

если вы хотите распечатать график, выберите `file => print plot'. появится диалог для печати графиков. так же, как для графов, у вас есть выбор между печатью на принтере или в файл, и вы можете установить нужные параметры.

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

• для создания `fig'-файлов требуется, чтобы в gnuplot был встроен соответствующий драйвер. в вашей программе gnuplot может не быть такого драйвера. в этом случае вам придется перекомпилировать gnuplot, включив в файл `term.h' строку `#define fig'.
• параметр `portrait' генерирует @acronym{eps}-файл, который можно вставлять в другие документы. параметр `landscape' велит ddd печатать график такого размера, какой задан параметром `paper size'; это полезно для печати на принтере. в режиме `portrait' параметр `paper size' игнорируется.
• в драйверах устройств gnuplot для postscript и x11 разные наборы цветов, поэтому цвета на распечатке могут отличаться от того, что отображается на экране.
• параметр `selected only' по умолчанию установлен, так что печатается только выделенный в данный момент график. (если вы выделите для печати несколько графиков, то на выводе они будут последовательно сцеплены в один, хотя вы, возможно, ожидали получить что-то другое.)

7.4.6 ввод команд для построения графика

с помощью `file => command' можно вводить команды gnuplot напрямую. каждая введенная в подсказку `gnuplot>' команда пересылается в gnuplot, а после нее выдается команда `replot', которая обновляет изображение. это полезно для выполнения в gnuplot более сложных задач.

вот простой пример. команда gnuplot

set xrange [xmin:xmax]

устанавливает диапазон отображения по горизонтали в значение xmin...xmax. чтобы построить график только элементов от 10 до 20, введите:

gnuplot> set xrange [10:20]

после ввода каждой команды ddd добавляет команду replot, поэтому график обновляется автоматически.

а вот более сложный пример. следующая последовательность команд gnuplot сохраняет график в формате tex:

gnuplot> set output "plot.tex" # устанавливает имя выходного файла
gnuplot> set term latex        # задает выходной формат
gnuplot> set term x11          # снова показывает первоначальное изображение

из-за неявной команды replot вывод автоматически записывается в файл `plot.tex' после команды set term latex.

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

диалог между ddd и gnuplot сохраняется в файле `~/.ddd/log' см. раздел 10.12.1 запись протокола). ключ ddd --trace печатает этот диалог на стандартный вывод.

7.4.7 экспорт графика

если вы хотите обработать данные графика с помощью какой-то внешней программы (отдельной программой gnuplot или программой xmgr, например), вы можете записать данные графика в файл, используя `file => save data as'. при этом появится диалоговое окно, позволяющее выбрать файл, в котором будут сохранены данные.

генерируемый файл начинается несколькими строками комментариев. затем идут сами данные в формате x/y или x/y/z. это тот же самый файл, какой обрабатывает gnuplot.

7.4.8 анимирование графиков

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

таким способом вы можете установить точку останова с "продолжением" в каком-то характерном месте внутри обрабатывающего массив алгоритма, и ddd будет отображать процесс графически. когда ваша программа остановится на самом деле, вы можете применить `undo' и `redo', чтобы снова отобразить и исследовать предыдущие ее состояния. см. раздел 6.8 "отмена" выполнения программы, для дополнительной информации.

7.4.9 настройка графиков

вы можете указать, как вызывается программа gnuplot, и настроить некоторые базовые установки.

7.4.9.1 вызов gnuplot

с помощью `edit => preferences => helpers => plot' вы можете указать, как вызывается программа gnuplot. это привязано к такому ресурсу:

ресурс: plotcommand (класс plotcommand)

имя исполняемого файла gnuplot. по умолчанию это `gnuplot' с несколькими ключами, задающими цвета и начальную геометрию.

с помощью `edit => preferences => helpers => plot window' вы можете указать, следует ли использовать для графика окно gnuplot (`external') или окно ddd (`builtin'). это привязано к такому ресурсу:

ресурс: plottermtype (класс plottermtype)

тип терминала gnuplot. может принимать одно из двух значений:

• если это `x11', ddd "поглощает" внешнее выходное окно gnuplot в своем собственном интерфейсе. некоторые программы для управления окнами, в частности mwm, плохо справляются с методами поглощения.
• если установить этот ресурс равным `xlib' (по умолчанию), то ddd предоставляет встроенное окно графика. в этом режиме графики строятся нормально с любым оконным менеджером, но они возможности настройки меньше (ресурсы gnuplot не воспринимаются).

можно и дальше управлять взаимодействием с внешним окном графика:

ресурс: plotwindowclass (класс plotwindowclass)

класс выходного окна gnuplot. при запуске gnuplot ddd ожидает появления окна с этим классом и интегрирует его в свой пользовательский интерфейс (если только `plottermtype' не равен `xlib'; смотрите выше). по умолчанию `gnuplot'.

ресурс: plotwindowdelay (класс windowdelay)

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

7.4.9.2 установки gnuplot

чтобы изменить установки gnuplot, используйте такие ресурсы:

ресурс: plotinitcommands (класс plotinitcommands)

команды, которые ddd посылает программе gnuplot первым делом. по умолчанию они такие:

set parametric
set urange [0:1]
set vrange [0:1]
set trange [0:1]

установка `parametric' необходима, чтобы gnuplot понимал генерируемые ddd файлы данных. команды, задающие диапазоны, используются для построения графиков скаляров.

дополнительные команды смотрите в документации по gnuplot.

ресурс: plot2dsettings (класс plotsettings)

дополнительные начальные установки для двумерных графиков. по умолчанию `set noborder'. вы можете изменять эти установки по желанию.

ресурс: plot3dsettings (класс plotsettings)

дополнительные начальные установки для трехмерных графиков. по умолчанию `set border'. вы можете изменять эти установки по желанию.

7.5 исследование памяти

при использовании gdb или dbx вы можете просматривать содержимое памяти в нескольких форматах, независимо от типов данных вашей программы. пункт меню `data => memory' выводит панель, где вы можете выбрать нужный формат.

в этой панели вы можете ввести

• счетчик повторов, десятичное целое, указывающее, какой объем памяти следует показывать
• формат отображения -- одно из

  `octal'

  печатать в виде восьмеричного целого.

  `hex'

  считать биты значения целым числом и печатать это число в шестнадцатеричной форме.

  `decimal'

  печатать в виде знакового десятичного целого.

  `unsigned'

  печатать в виде беззнакового десятичного целого.

  `binary'

  печатать в виде двоичного целого.

  `float'

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

  `address'

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

  `instruction'

  печатать в виде машинной инструкции. в этом формате размер единицы измерения игнорируется.

  `char'

  считать целым числом и печатать в виде знаковой константы.

  `string'

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

• единица измерения -- одно из

  `bytes'

  байты.

  `halfwords'

  полуслова (два байта).

  `words'

  слова (четыре байта).

  `giants'

  гигантские слова (восемь байт).

• адрес -- начальный адрес. значение этого выражения не обязано быть указателем (хотя может); оно всегда интерпретируется как целочисленный адрес байта памяти.

есть два способа исследования значений:

• вы можете сбросить содержимое памяти в консоль отладчика (с помощью `print'). если повторить результирующую команду `x', нажав в консоли return (см. раздел 10.1.2 история команд), будет показана следующая область памяти.
• также можно отобразить дамп памяти в окне данных (с помощью `display'). если вы решили отобразить значения, они будут автоматически обновляться при каждом останове программы.