Struct LaunchInput 

pub struct LaunchInput<'a> { /* private fields */ }

What a launch handed the app: the arguments of its command line or of an “open with” (paths, URLs), the app’s own options it named, the file a host lent it, the content store where the app keeps what a launch hands it, and where playback of the media it names stood on the device or app that handed it over.

Implementations

impl<'a> LaunchInput<'a>

pub fn new(arguments: &'a [String], file: Option<&'a OpenFile>) -> Self

A launch naming arguments and handing over file: what a host asks ResourceApp::launch about, and what a test of an app’s launch builds.

pub fn with_record(self, state: &'a dyn Any) -> Self

The same launch on a record that is already there, as it is now.

pub fn record<S: 'static>(&self) -> Option<&'a S>

The state of the record the launch opened, as it is when the launch is taken: S is the app resource’s state. None before the record is open (a genesis) or for another type.

pub fn with_content(self, content: Option<&'a ContentStore>) -> Self

The same launch on a host that lends the app content.

pub fn with_handoff(self, handoff: Option<&'a PlaybackHandoff>) -> Self

The same launch, continuing handoff’s playback.

pub fn with_options(self, options: &'a [LaunchOption]) -> Self

This launch, also naming the app’s own options.

pub fn arguments(&self) -> &'a [String]

The launch’s arguments, in order; at most ResourceApp::ARGUMENTS of them.

pub fn argument(&self) -> Option<&'a str>

The first argument, for an app that takes one (a path, a URL).

pub fn file(&self) -> Option<&'a OpenFile>

The file a host handed over to open: its name, media type and bytes. Only a file of a type the app opens reaches it.

pub fn content(&self) -> Option<&'a ContentStore>

The content store of the host the app is launched in: a handed file’s bytes are kept there, and the launch’s actions name them by hash, so the record never carries a file and every device that holds the bytes reads them. None where the host lends none.

pub fn handoff(&self) -> Option<&'a PlaybackHandoff>

Where playback of the media the launch names stood on the device or app that handed it over: the position to continue from, whether it keeps playing and what it was called there. None for an ordinary launch, which starts at the beginning.

pub fn option(&self, name: &str) -> Option<&'a str>

The value of the app’s option name (--purpose), when the launch named it; see ResourceApp::OPTIONS.

pub fn flag(&self, name: &str) -> bool

Whether the launch named the app’s switch name; see ResourceApp::FLAGS.

pub fn is_empty(&self) -> bool

Whether the launch named nothing: a plain start of the app.

Trait Implementations

impl<'a> Clone for LaunchInput<'a>

fn clone(&self) -> LaunchInput<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for LaunchInput<'a>