rule DEPENDS ( targets1 * : targets2 * )

Построена прямая зависимость: каждая из мишеней1 зависит от каждой из мишеней2. Как правило, цели1 будут перестроены, если цели2 сами перестроены или являются более новыми, чем цели1.

rule INCLUDES ( targets1 * : targets2 * )

Построение зависимости между братьями и сестрами: делает любую цель, которая зависит от любой из мишеней1, также зависимой от каждой из мишеней2. Это отражает зависимости, которые возникают, когда один исходный файл включает в себя другой: объект, построенный из исходного файла, зависит как от исходного, так и от включенного исходного файла, но два исходных файла не зависят друг от друга. Например:

DEPENDS foo.o : foo.c ;
INCLUDES foo.c : foo.h ;

"foo.o" зависит от "foo.c" и "foo.h" в этом примере.

rule ALWAYS ( targets * )

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

rule LEAVES ( targets * )

Делает каждую из мишеней зависящей только от ее листовых источников, а не от каких-либо промежуточных целей. Это делает его невосприимчивым к обновлению зависимостей, поскольку «листовые» зависимости — это те, которые не имеют собственных зависимостей и не обновляют действия. Это позволяет обновлять цель только при изменении исходных файлов.

rule NOCARE ( targets * )

Причин b2 игнорировать цели , которые не могут быть найдены и не имеют обновлений действий для их построения. Обычно для таких целей b2 выдает предупреждение, а затем пропускает другие цели, которые зависят от этих недостающих целей. HdrRule в Jambase использует NOCARE на именах файлов заголовка, найденных во время сканирования файлов заголовка, чтобы дать b2 знать, что включенные файлы могут не существовать. Например, если #include находится в пределах #ifdef, включенный файл может фактически не находиться вокруг.

	Warning
	Для целей с действиями построения: если их действия построения выходят с ненулевым кодом возврата, зависимые цели все равно будут построены.

rule NOTFILE ( targets * )

Отметки targets как псевдоцели, а не реальные файлы. Временная метка не проверяется, и поэтому действия по такой цели выполняются только при обновлении зависимостей цели или если цель также отмечена ВСЕГДА. По умолчанию b2 цель « все » является псевдоцелью. В Jambase NOTFILE используется для определения нескольких дополнительных удобных псевдоцелей.

rule NOUPDATE ( targets * )

Вызывает игнорирование временных меток на -мишенях. Это имеет два эффекта: во-первых, после создания цели она никогда не будет обновляться; во-вторых, ручное обновление цели не приведет к обновлению других целей. Например, в Jambase это правило применяется к каталогам по правилу MkDir, потому что MkDir заботится только о том, что целевой каталог существует, а не когда он последний раз обновлялся.

rule TEMPORARY ( targets * )

Марки -мишени - временные, позволяющие удалять их после обновления других целей, зависящих от них. Если отсутствует цель TEMPORARY, b2 использует временную метку родителя цели. Jambase использует TEMPORARY для маркировки объектных файлов, которые архивируются в библиотеке после их создания, так что они могут быть удалены после их архивирования.

rule FAIL_EXPECTED ( targets * )

Для обработки целей, действия по сборке которых, как ожидается, не сработают (например, при правильном тестировании этих утверждений или проверке типа компиляции), Boost Jam предоставляет правило FAIL_EXPECTED в том же стиле, что и NOCARE, и т. д. Во время обновления цели обратный код действий по сборке для аргументов FAIL_EXPECTED перевернут: если он не сработает, построение зависимых целей продолжается так, как если бы он преуспел. Если это удастся, зависимые цели будут пропущены.

rule RMOLD ( targets * )

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

rule ISFILE ( targets * )

ISFILE обозначает цели, необходимые для файлов. Это меняет способ поиска цели b2 таким образом, что он игнорирует совпадения для элементов файловой системы, которые не являются файлами, такими как каталоги. Это позволяет избежать совпадения #include "исключение", если в пути поиска заголовка имеется каталог с именем исключения.

	Warning
	В настоящее время это не полностью реализовано.

rule ECHO ( args * )

Отключает сообщение args в stdout.

rule EXIT ( message * : result-value ? )

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

"Echo", "echo", "Exit" и "exit" принимаются в качестве псевдонимов для ECHO и EXIT, поскольку трудно сказать, что это встроенные правила, а не часть языка, как "include".

Правило GLOB глобулирует имя файла.

rule GLOB ( directories * : patterns * : downcase-opt ? )

Использование тех же карточек, что и для шаблонов в заявлении переключателя. Он используется в качестве аргумента для вызова правила внутри «=[]=». Например: "FILES = [GLOB dir1 dir2 : *.c *.h ]" устанавливает FILES в список файлов источника C и заголовков в dir1 и dir2. Полученные имена файлов являются полными именами путей, включая каталог, но шаблон применяется только к имени файла без каталога.

Если предоставляется downcase-opt, имена файлов преобразуются во все нижние регистры перед сопоставлением с шаблоном; вы можете использовать это для выполнения бесчувственного сопоставления с использованием шаблонов нижних регистров. Возвращенные пути все равно будут иметь смешанный случай, если ОС их поставит. В Windows NT, Cygwin и OpenVMS имена файлов всегда уменьшаются перед сопоставлением.

Правило GLOB_ARCHIVE позволяет называть имена членов архива объектов.

rule GLOB_ARCHIVE ( archives * : member-patterns * : downcase-opt ? : symbol-patterns ? )

Подобно GLOB, это правило используется для сопоставления имен файлов-членов в архиве (библиотека статических объектов). Список успешно подобранных членов возвращается или не возвращается. Полученные имена участников квалифицируются с именем пути содержащего архива в виде archive-path(member-name). Узоры участников предназначены только для сопоставления имени участника; когда не указаны дикие карты - предполагается точное совпадение. Имена членов, как правило, соответствуют именам файлов объектов и, как таковые, являются специфичными для платформы - использование суффикса объекта, определенного платформой, в соответствующих шаблонах может обеспечить переносимость.

Если предоставляется downcase-opt, имена участников преобразуются во все нижние регистры перед сопоставлением с шаблоном; вы можете использовать это для выполнения нечувствительного к регистру сопоставления с использованием шаблонов нижних регистров. Возвращенные пути все равно будут иметь смешанный случай, если ОС их поставит. В Windows NT, Cygwin и OpenVMS имена файлов всегда понижаются перед сопоставлением.

Кроме того, участники могут быть сопоставлены с шаблонами символов / функций на поддерживаемых платформах (в настоящее время только OpenVMS). В этом случае члены, содержащие соответствующие символы, возвращаются. Узоры символов и символов применяются в качестве условий ИЛИ, причем шаблоны членов имеют приоритет. На неподдерживаемых платформах нуль возвращается, когда указаны какие-либо шаблоны символов.

Правило MATCH соответствует шаблону.

rule MATCH ( regexps + : list * )

Соответствует регулярным выражениям в стиле egrep(1) regexps против строк в list. Результатом является список соответствия () подвыражений для каждой строки в списке и для каждого регулярного выражения в regexps.

rule BACKTRACE ( )

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

rule UPDATE ( targets * )

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

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

local previous-updates = [ UPDATE ] ;
UPDATE $(previous-updates) a-new-target ;

rule W32_GETREG ( path : data ? )

Это касается только платформы Win32. Он читает реестр Windows. path - это местоположение информации, а data - это имя значения, которое мы хотим получить. Если опущены data, возвращается значение по умолчанию path. Значение path должно соответствовать формату пути ключа MS и должно быть прикреплено к одному из предопределенных корневых ключей. Как обычно,

Другие предопределенные корневые ключи не поддерживаются.

Поддерживаемые типы данных: REG_DWORD, REG_SZ, REG_EXPAND_SZ, REG_MULTI_SZ. Данные с помощью REG_DWORD Тип будет превращен в строку, 'REG_MULTI_SZ' в список строк, а для тех, у кого в нем переменные среды типа REG_EXPAND_SZ, будут заменены их заданными значениями. Данные с типом REG_SZ и другими неподдерживаемыми типами будут помещаться в строку без изменения. Если он не может получить значение данных, он просто возвращает пустой список. Например,

local PSDK-location =
  [ W32_GETREG HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\MicrosoftSDK\\Directories : "Install Dir" ] ;

rule W32_GETREGNAMES ( path : result-type )

Это касается только платформы Win32. Он читает реестр Windows. "path" - это местоположение информации, а "тип результата" - это либо "subkeys", либо "values". Для получения дополнительной информации о формате и ограничениях path см. W32_GETREG.

В зависимости от типа результата , правило возвращает одно из следующих:

Если «тип результата » не распознан или запрошенные данные не могут быть извлечены, правило возвращает пустой список. Пример:

local key = "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\App Paths" ;
local subkeys = [ W32_GETREGNAMES "$(key)" : subkeys ] ;
for local subkey in $(subkeys)
{
    local values = [ W32_GETREGNAMES "$(key)\\$(subkey)" : values ] ;
    for local value in $(values)
    {
        local data = [ W32_GETREG "$(key)\\$(subkey)" : "$(value)" ] ;
        ECHO "Registry path: " $(key)\\$(subkey) ":" $(value) "=" $(data) ;
    }
}

rule SHELL ( command : * )

SHELL выполняет команду, а затем возвращает стандартный вывод команду. SHELL работает только на платформах с функцией popen() в библиотеке C. На платформах без рабочей функции popen() SHELL реализуется как no-op. SHELL работает на Unix, MacOS X и большинстве компиляторов Windows. SHELL - это no-op на компиляторах Metrowerks под Windows. Существует переменный набор допустимых вариантов в качестве дополнительных аргументов:

Поскольку Perforce/Jambase определяет правило SHELL, которое скрывает встроенное правило, COMMAND может использоваться в качестве псевдонима для SHELL в таком случае.

rule MD5 ( string )

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

rule SPLIT_BY_CHARACTERS ( string : delimiters )

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

rule PRECIOUS ( targets * )

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

rule PAD ( string : width )

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

rule FILE_OPEN ( filename : mode )

Правило FILE_OPEN открывает указанный файл и возвращает дескриптор файла. Параметр mode может быть либо «w», либо «r». Обратите внимание, что в настоящее время только правило UPDATE_NOW может использовать полученный номер дескриптора файла.

rule UPDATE_NOW ( targets * : log ? : ignore-minus-n ? )

UPDATE_NOW немедленно обновил указанные цели. Если обновление было успешным, возвращается непустая строка. Параметр log, если он присутствует, указывает дескриптор файла, в котором весь вывод из здания перенаправляется. Если параметр ignore-minus-n задан, цели обновляются, даже если параметр -n задан в командной строке.