safe_union
в HIDL представляет собой явно помеченный тип объединения. Это похоже на union
, за исключением того, что safe_union
отслеживает базовый тип и совместим с Java. Тип safe_union
доступен в Android 10 и более поздних версиях для новых и обновленных устройств.
Синтаксис
safe_union
выражается в HIDL точно так же, как union
или struct
.
safe_union MySafeUnion { TypeA a; TypeB b; ... };
Применение
Во время выполнения safe_union
может быть только одного типа. По умолчанию это будет первый тип в объединении. Например, выше MySafeUnion
по умолчанию имеет TypeA
hidl-gen
генерирует собственный класс или структуру для safe_union
как в C++, так и в Java. Этот класс включает в себя дискриминатор для каждого члена (в hidl_discriminator
), метод для получения текущего дискриминатора ( getDiscriminator
), а также методы установки и получения для каждого члена. Каждый сеттер и геттер называется точно так же, как и его член. Например, метод получения TypeA a
будет называться «a» и вернет что-то вроде TypeA
. Соответствующий установщик также будет называться «a» и принимать параметр TypeA
. Установка значения в safe_union
обновит значение дискриминатора, возвращаемое getDiscriminator
. Доступ к значению дискриминатора, который не является текущим дискриминатором, прерывает программу. Например, если вызов getDiscriminator
для экземпляра MySafeUnion
возвращает hidl_discriminator::b
, то попытка получить a
приведет к прерыванию программы.
моногосударство
safe_union
всегда имеет значение, но если желательно, чтобы оно не имело значения, используйте android.hidl.safe_union@1.0::Monostate
в качестве заполнителя. Например, следующий союз может быть либо noinit
(пустым), либо foo
:
import android.hidl.safe_union@1.0::Monostate; safe_union OptionalFoo { Monostate noinit; Foo foo; };