11.3 Устаревшие возможности

11.3.1 Утверждения

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

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

Утверждение выглядит так:

#predicate (answer)

predicate должно быть единственным идентификатором. answer может быть любой последовательностью токенов; все символы имеют значение, за исключением начальных и конечных пробелов, а различия во внутренних последовательностях пробелов игнорируются. (Это аналогично правилам, регулирующим переопределение макросов.) Таким образом, (x + y) отличается от (x+y), но эквивалентно ( x + y ). Скобки не вложены внутри ответа.

Чтобы проверить утверждение, запишите его в «#if». Например, это условное выражение выполняется успешно, если либо vax или ns16000 были утверждены как ответ для machine.

#if #machine (vax) || #machine (ns16000)

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

#if #machine

Утверждения создаются с помощью директивы «#assert». Единственный аргумент — утверждение для создания без ведущего «#», которое идентифицирует утверждения в условных выражениях.

#assert predicate (answer)

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

Утверждения можно отменить с помощью директивы «#unassert». У неё такая же синтаксис, как у «#assert». В этом формате она отменяет только ответ, который был указан в строке «#unassert»; другие ответы для этого предиката остаются истинными. Вы можете отменить весь предикат, убрав ответ:

#unassert predicate

В любом случае, если такое утверждение не было сделано, «#unassert» не оказывает никакого влияния.

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