Ада-95. Компилятор GNAT

       

Атрибуты


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

Существуют две категории атрибутов: простые атрибуты и ассоциативные массивы.

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

Ниже перечислены атрибуты проектов (все они являются простыми атрибутами):

Имя атрибута

Значение



Source_Files   список строк 
 Source_Dirs   список строк 
 Source_List_File   строка
 Object_Dir   строка
 Exec_Dir   строка
 Main   список строк 
 Languages   список строк 
 Library_Dir   строка
 Library_Name   строка
 Library_Kind   строка
 Library_Elaboration   строка
 Library_Version   строка

Ниже перечислены атрибуты пакета Naming:

Имя атрибута

Категория

Индекс

Значение

 Specification_Suffix   ассоциативный массив   имя языка   строка 
 Implementation_Suffix   ассоциативный массив   имя языка   строка 
 Separate_Suffix   простой атрибут   -   строка 
 Casing   простой атрибут   -   строка 
 Dot_Replacement   простой атрибут   -   строка 
 Specification   ассоциативный массив   имя модуля Ады   строка 
 Implementation   ассоциативный массив   имя модуля Ады   строка 
 Specification_Exceptions   ассоциативный массив   имя языка   список строк 
 Implementation_Exceptions   ассоциативный массив   имя языка   список строк 
<


Ниже перечислены атрибуты пакетов Builder, Compiler, Binder, Linker, Cross_Reference и Finder

(см. также "Опции и Файлы проектов")

Имя атрибута

Категория

Индекс

Значение

 Default_Switches   ассоциативный массив   имя языка   список строк 
 Switches   ассоциативный массив   имя файла   список строк 
Дополнительно, пакет Builder обладает однострочными атрибутами Local_Configuration_Pragmas и Global_Configuration_Pragmas; атрибуты пакета Glide не документированы и предназначены для внутреннего использования.

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

Подобно описаниям переменных, какое-либо описание атрибута определяет новое значение атрибута.

Ниже показаны примеры простых описаний атрибутов:

for Object_Dir use "objects"; for Source_Dirs use ("units", "test/drivers");

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

Ссылки (обращения) к атрибутам могут быть использованы в выражениях. Общая форма такого обращения имеет вид:

entity'attribute

Где "entity" является сущностью для которой определен атрибут "attribute". Для атрибутов, которые принадлежат к категории ассоциативных массивов, после имени атрибута необходимо в скобках указать строковый литерал, который используется в качестве индекса. Для наглядности, продемонстрируем несколько примеров:

project'Object_Dir

Naming'Dot_Replacement

Imported_Project'Source_Dirs

Imported_Project.Naming'Casing

Builder'Default_Switches ("Ada")

Сущностью "entity" может являться:



  • project, для какого-либо атрибута текущего проекта
  • имя существующего в текущем проекте пакета
  • имя какого-либо импортируемого проекта
  • имя какого-либо проекта-предка (расширяемого текущим проектом)
  • имя какого-либо импортируемого/проекта-предка, сопровождаемое точкой и, затем, именем пакета

    Например:

    project Prj is

    for Source_Dirs use project'Source_Dirs & "units"; for Source_Dirs use project'Source_Dirs & "test/drivers" end Prj;

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

    После первого описания, атрибут Source_Dirs является списком строк, который содержит один элемент ("units"), а после второго описания - два элемента ("units" и "test/drivers").

    Следует заметить, что показанный выше пример приведен только в качестве демонстрации. На приктике, файл проекта, как правило, будет содержать только одно описание атрибута:

    for Source_Dirs use ("units", "test/drivers");


    Содержание раздела