FindBISON

Найти исполняемый файл bison и предоставить макрос для генерации пользовательских правил построения.

Модуль определяет следующие переменные:

BISON_EXECUTABLE

путь к программе bison

BISON_VERSION

версия bison

BISON_FOUND

"Истина" (True), если программа найдена

Минимально необходимая версия bison может быть указана с использованием стандартного синтаксиса CMake, например, find_package(BISON 2.1.3).

Если bison найден, модуль определяет макрос:

BISON_TARGET(<Name> <YaccInput> <CodeOutput>
             [COMPILE_FLAGS <flags>]
             [DEFINES_FILE <file>]
             [VERBOSE [<file>]]
             [REPORT_FILE <file>]
             )

который создаст пользовательское правило для генерации парсера. <YaccInput> — путь к файлу yacc. <CodeOutput> — имя исходного файла, сгенерированного bison. Также будет сгенерирован заголовочный файл, содержащий список токенов.

Параметры:

COMPILE_FLAGS <flags>

Укажите флаги, которые нужно добавить в командную строку bison.

DEFINES_FILE <file>

Добавлена в версии 3.4.

Укажите заголовочный файл <file> по умолчанию, который должен быть сгенерирован bison.

VERBOSE [<file>]

Укажите bison создать отчётный файл грамматики и парсера.

Устарело начиная с версии 3.7: Если <file> задан, он указывает путь к файлу отчёта. [<file>] оставлен для обратной совместимости этого модуля. Используйте VERBOSE REPORT_FILE <file>.

REPORT_FILE <file>

Добавлена в версии 3.7.

Укажите нестандартный отчётный файл <file>, если он генерируется.

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

BISON_<Name>_DEFINED

True указывает, что макрос успешно выполнен

BISON_<Name>_INPUT

Входной исходный файл, алиас для <YaccInput>

BISON_<Name>_OUTPUT_SOURCE

Исходный файл, сгенерированный bison

BISON_<Name>_OUTPUT_HEADER

Заголовочный файл, сгенерированный bison

BISON_<Name>_OUTPUTS

Все файлы, сгенерированные bison, включая исходный файл, заголовочный файл и отчёт

BISON_<Name>_COMPILE_FLAGS

Флаги, использованные в командной строке bison

Пример использования:

find_package(BISON)
BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp
             DEFINES_FILE ${CMAKE_CURRENT_BINARY_DIR}/parser.h)
add_executable(Foo main.cpp ${BISON_MyParser_OUTPUTS})