Enum RealmBuilderError

pub enum RealmBuilderError {
    ChildAlreadyExists,
    InvalidManifestExtension,
    InvalidComponentDecl,
    NoSuchChild,
    ChildDeclNotVisible,
    NoSuchSource,
    NoSuchTarget,
    CapabilitiesEmpty,
    TargetsEmpty,
    SourceAndTargetMatch,
    DeclNotFound,
    DeclReadError,
    BuildAlreadyCalled,
    CapabilityInvalid,
    InvalidChildRealmHandle,
    ImmutableProgram,
    UrlIsNotRelative,
    InvalidPkgDirHandle,
    NoConfigSchema,
    NoSuchConfigField,
    ConfigValueInvalid,
    ConfigOverrideUnsupported,
    // some variants omitted
}

Errors that may be returned by the Realm and Builder protocols.

Variants

ChildAlreadyExists

Child cannot be added to the realm, as there is already a child in the realm with that name.

InvalidManifestExtension

A legacy component URL was given to AddChild, or a modern component url was given to AddLegacyChild.

InvalidComponentDecl

A component declaration failed validation.

NoSuchChild

The referenced child does not exist.

ChildDeclNotVisible

The component declaration for the referenced child cannot be viewed nor manipulated by RealmBuilder, because the child was added to the realm using an URL that was neither a fragment-only nor a legacy URL.

NoSuchSource

The source does not exist.

NoSuchTarget

A target does not exist.

CapabilitiesEmpty

The capabilities field is empty.

TargetsEmpty

The targets field is empty.

SourceAndTargetMatch

The from value is equal to one of the elements in to.

DeclNotFound

The test package does not contain the component declaration referenced by a fragment-only component URL.

DeclReadError

Encountered an I/O error when attempting to read a component declaration referenced by a fragment-only component URL from the test package.

BuildAlreadyCalled

The Build function has been called multiple times on this channel.

CapabilityInvalid

A capability is invalid. This may occur if a required field is empty or if an unsupported type is received.

InvalidChildRealmHandle

The handle the client provided for the child realm is not usable.

ImmutableProgram

ReplaceComponentDecl was called on a legacy or local component with a program declaration that did not match the one from the old component declaration. This could render a legacy or local component non-functional, and is disallowed.

UrlIsNotRelative

The URL provided to RealmBuilderFactory.CreateFromRelativeURL is not a fragment-only component URL.

InvalidPkgDirHandle

The handle the client provided for the test’s pkg directory is not usable.

NoConfigSchema

The component does not have a config schema defined. Attempting to set a config value is not allowed.

NoSuchConfigField

The component’s config schema does not have a field with that name.

ConfigValueInvalid

A config value is invalid. This may mean a type mismatch or an issue with constraints like string/vector length.

ConfigOverrideUnsupported

A config value cannot be set because the realm has not chosen its override policy.

Implementations

impl RealmBuilderError

pub fn from_primitive(prim: u32) -> Option<Self>

pub fn from_primitive_allow_unknown(prim: u32) -> Self

pub fn unknown() -> Self

pub const fn into_primitive(self) -> u32

pub fn is_unknown(&self) -> bool

Trait Implementations

impl Clone for RealmBuilderError

fn clone(&self) -> RealmBuilderError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RealmBuilderError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<D: ResourceDialect> Decode<RealmBuilderError, D> for RealmBuilderError

fn new_empty() -> Self

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<()>

Decodes an object of type T from the decoder’s buffers into self.

impl<D: ResourceDialect> Encode<RealmBuilderError, D> for RealmBuilderError

unsafe fn encode( self, encoder: &mut Encoder<'_, D>, offset: usize, _depth: Depth, ) -> Result<()>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl Hash for RealmBuilderError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for RealmBuilderError

fn cmp(&self, other: &RealmBuilderError) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for RealmBuilderError

fn eq(&self, other: &RealmBuilderError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for RealmBuilderError

fn partial_cmp(&self, other: &RealmBuilderError) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl TypeMarker for RealmBuilderError

type Owned = RealmBuilderError

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl ValueTypeMarker for RealmBuilderError

type Borrowed<'a> = RealmBuilderError

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &Self::Owned. There are three cases:

fn borrow(value: &<Self as TypeMarker>::Owned) -> Self::Borrowed<'_>

Cheaply converts from &Self::Owned to Self::Borrowed.

impl Copy for RealmBuilderError

impl Eq for RealmBuilderError

impl StructuralPartialEq for RealmBuilderError