к оглавлению   к 4GL - визуальному программированию

Условная компиляция

Visual J++ поддерживает два новых механизма условной компиляции в Java: директивы и методы условной компиляции. В таблице, приведенной ниже, описаны все директивы условной компиляции, а общие сведения о них даны в разделе «Директивы условной компиляции». Краткое описание синтаксиса и примеры использования методов условной компиляции см. в разделе «Методы условной компиляции» далее в этом приложении.

Примечание Эти механизмы относятся к расширениям языка Java, разработанным Microsoft. Поэтому исходный код, в котором задействованы эти механизмы, некорректно компилируется другими средствами разработки Java-программ.

Директива условной компиляции

Описание

#if

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

#elif

Дополняет директиву #if. Если предшествующая проверка условия #if дает false, #elif включает или исключает блоки кода из компиляции в зависимости от значения своего выражения или идентификатора.

#else

Дополняет директиву #if. Если предшествующая проверка условия #lf дает false, компилируется блок кода, следующий за #else.

#endif

Требуется при использовании директивы #if. Завершает блок кода, компилируемый по условию.

#define

Определяет идентификатор для препроцессора.

#error При компиляции генерирует сообщение об ошибке, определенной программистом.
#warning При компиляции генерирует предупреждение, определенное программистом.

#undef

Отменяет определение идентификатора для препроцессора.

 

Директивы условной компиляции #if, #elif, #else и #endif

Директивы #if, #elif, #else и #endif позволяют включать или исключать блоки исходного кода из компиляции по неким условиям. У директивы #if, с которой начинаются все условные блоки, должна быть парная директива #endif.

Синтаксис #if <выражение1>

включаемый блок #elif <выражение2>

включаемый блок #else

включаемый блок #endif

Выражение, следующее за #if и #endif, должно быть допустимым логическим выражением, которое состоит из Булевых операторов и использует идентификаторы, объявленные директивами #define и #undef. Если выражение в #if дает true, следующие за ней строки подлежат компиляции, а если оно — false, все строки до соответствующей директивы #elif, #else или #endif из компиляции исключаются. В блоке условной компиляции допустима лишь одна директива #else. Строки, расположенные за ней, подлежат компиляции, только если выражение в соответствующей директиве #if ложно. А директива #elif может появляться в таком блоке произвольное число раз (или вовсе отсутствовать).

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

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

#define DEBUG

#undef RETAIL

public class test {

#if DEBUG

if (cmdStatus.equals(invokeError)) {

// следующая строка выводит диагностическое сообщение: System.out.println("Error: command timed out.");

// здесь выполняются соответствующие действия

}

#elif RETAIL

if (cmdStatus.equals(invokeError))

// здесь выполняются соответствующие действия

}

#else

#error Must define DEBUG or RETAIL;

#endif

}

Директива условной компиляции #define

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

По соглашению значение идентификатора, объявленного директивой #define, должно быть всегда true.

Синтаксис

#define <идентификатор>

Идентификатор состоит максимум из 1 024 символов и набирается только заглавными буквами.

Следующий пример демонстрирует применение #define в Java-приложении:

#define DEBUG // DEBUG присваивается true

#if DEBUG

// код, подлежащий компиляции #endif

Примечание Процесс сборки в Visual J++ не предусматривает задания параметров отдельно для каждого файла. Поэтому, если Вы хотите включать и исключать идентификаторы условной компиляции в индивидуальном исходном файле, объявляйте директивы #define и #undef явным образом в каждом файле.

Директива условной компиляции #undef

Директива #undef удаляет идентификатор из исходного файла. Этот идентификатор не обязательно должен быть определен, и, кроме того, Вы можете переопредить его в исходном файле, используя директиву #define. Директиву #undef следует помещать в начало исходного файла — предшествовать ей могут только комментарии и другие директивы условной компиляции.

Синтаксис

#undef <идентификатор>

Идентификатор состоит максимум из 1 024 символов, и набирается только заглавными буквами.

Следующий пример демонстрирует применение #undef в Java-приложении:

#undef DEBUG // DEBUG присваивается false

#if DEBUG

// код, исключаемый из компиляции #endif

Примечание Процесс сборки в Visual J + + не предусматривает задания параметров отдельно для каждого файла. Поэтому, если Вы хотите включать и исключать идентификаторы условной компиляции в индивидуальном исходном файле, объявляйте директивы #define и #undef явным образом в каждом файле.

Директива условной компиляции #error

Директива #error принимает в качестве аргумента строку и при компиляции генерирует сообщение об ошибке. Последние выводятся как обычные ошибки компилятора.

Подобно #warning, эта директива наиболее полезна при предварительной обработке исходного файла для выявления предопределенных ограничений и несоответствий.

Синтаксис

#error <строка_сообщения>

Этот идентификатор строки сообщения указывает, какое сообщение об ошибке следует вывести. Применение #error иллюстрирует такой пример:

#if DEBUG

#elif RETAIL

#else

#error DEBUG or RETAIL must be defined!

#endif

Компилятор, встретив последнее определение, выведет строку: #error 'DEBUG or RETAIL must be defined' (J0500)

Директива условной компиляции #warning

Директива #warning принимает в качестве аргумента строку и при компиляции генерирует предупреждение. Последние выводятся как обычные предупреждения компилятора.

Подобно #error, эта директива наиболее полезна при предварительной обработке исходного файла для выявления предопределенных ограничений и несоответствий.

Синтаксис

#warning <строка сообщении>

Этот идентификатор строки сообщения указывает, какое предупреждение следует вывести.

Применение #warning иллюстрирует такой пример:

#if !TRACING

#warning This interface has not been completely tested yet!

#endif

Компилятор, встретив данное определение, выведет строку:

#warning 'This interface has not been completely tested yet!' (J5500)

Методы условной компиляции

Метод условной компиляции помечается тэгом @, встроенным в Java-doc-комментарий, и по результатам проверки условия либо включается, либо исключается из исходного файла. Если метод исключен из исходного файла, компилятор автоматически убирает его вызовы из исходного кода программы.

Синтаксис

/** @conditional (выражение) */

void цмя_метода(аргументы)

{

}

Выражение может быть любым, допустимым в Java, и использовать идентификаторы, объявленные директивами #define или #undef. Главное достоинство методов условной компиляции в том, что они упрощают включение или исключение больших объемов отладочной информации. Например, позволяют генерировать важную диагностическую информацию в процессе разработки программы. А как только разработка завершена и приложение готово к выпуску, все методы условной компиляции и их вызовы легко убираются простой модификацией значения идентификатора.

Применение метода условной компиляции иллюстрирует следующий пример: #define DEBUG // DEBUG присваивается true

public class someClass {

/** @conditional (DEBUG) */

trackDisplay(int dTrack)

{

System.out.println("Variable dTrack assigned: %d", dTrack);

} }

Здесь Вы определяете идентификатор DEBUG и тем самым включаете в процесс компиляции метод trackDisplay. Если этот метод больше не нужен, то, заменив #define на #undef, Вы заставите компилятор исключить его из компиляции исходного файла и отменить все обращения к нему из любого места программы.

Директивы условной компиляции

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

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

#define PRINTHELLO // PRINTHELLO имеет значение true

public class sample {

public static void main(String args[]) {

#if PRINTHELLO

System.out.println("Hello!");

#eise

System.out.println("Goodbye.");

#endif } }

Здесь выводится строка «Hello!». Если удалить директиву #define, будет отображаться строка «Goodbye».

Как и в стандартных условных конструкциях Java, в некоторых директивах условной компиляции (например, в #if) применяются выражения, управляющие последовательностью выполнения этих директив. Многие правила синтаксиса Java-операторов применимы и к выражениям в директивах условной компиляции.

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

Разумно применяя такие директивы, Вы сэкономите при отладке программы немало времени и сил.

к оглавлению   к 4GL - визуальному программированию

Знаете ли Вы, что только в 1990-х доплеровские измерения радиотелескопами показали скорость Маринова для CMB (космического микроволнового излучения), которую он открыл в 1974. Естественно, о Маринове никто не хотел вспоминать. Подробнее читайте в FAQ по эфирной физике.

НОВОСТИ ФОРУМАФорум Рыцари теории эфира
Рыцари теории эфира
 17.08.2019 - 18:50: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Андрея Тиртхи - Карим_Хайдаров.
15.08.2019 - 23:53: ВОЙНА, ПОЛИТИКА И НАУКА - War, Politics and Science -> РАСЧЕЛОВЕЧИВАНИЕ ЧЕЛОВЕКА. КОМУ ЭТО НАДО? - Карим_Хайдаров.
15.08.2019 - 23:52: ТЕОРЕТИЗИРОВАНИЕ И МАТЕМАТИЧЕСКОЕ МОДЕЛИРОВАНИЕ - Theorizing and Mathematical Design -> ФУТУРОЛОГИЯ - прогнозы на будущее - Карим_Хайдаров.
15.08.2019 - 23:50: НОВЫЕ ТЕХНОЛОГИИ - New Technologies -> ПРОБЛЕМА ИСКУССТВЕННОГО ИНТЕЛЛЕКТА - Карим_Хайдаров.
15.08.2019 - 17:13: НОВЫЕ ТЕХНОЛОГИИ - New Technologies -> ПРОБЛЕМЫ ВНЕДРЕНИЯ НОВЫХ ТЕХНОЛОГИЙ - Карим_Хайдаров.
15.08.2019 - 16:22: ВОЙНА, ПОЛИТИКА И НАУКА - War, Politics and Science -> ЗА НАМИ БЛЮДЯТ - Карим_Хайдаров.
15.08.2019 - 14:50: ЭКСПЕРИМЕНТАЛЬНАЯ ФИЗИКА - Experimental Physics -> Вихревые эффекты и вихревые теплогенераторы - Карим_Хайдаров.
13.08.2019 - 05:27: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Ю.Ю. Болдырева - Карим_Хайдаров.
12.08.2019 - 06:16: ВОСПИТАНИЕ, ПРОСВЕЩЕНИЕ, ОБРАЗОВАНИЕ - Upbringing, Inlightening, Education -> Просвещение от Вячеслава Осиевского - Карим_Хайдаров.
09.08.2019 - 13:03: АСТРОФИЗИКА - Astrophysics -> Исследования комет - Карим_Хайдаров.
08.08.2019 - 04:32: ВОЙНА, ПОЛИТИКА И НАУКА - War, Politics and Science -> Проблема государственного терроризма - Карим_Хайдаров.
29.07.2019 - 04:33: НОВЫЕ ТЕХНОЛОГИИ - New Technologies -> "Зенит"ы с "Протон"ами будут падать - Карим_Хайдаров.
Bourabai Research Institution home page

Bourabai Research - Технологии XXI века Bourabai Research Institution