Struct LaunchArgs 

pub struct LaunchArgs { /* private fields */ }

The launch arguments the app was started with.

An immutable snapshot: reading it never allocates, so composables may query it per frame. The platform replaces the whole snapshot when the launch parameters change (Android onNewIntent); it never mutates one in place.

Implementations

impl LaunchArgs

pub fn new( entries: impl IntoIterator<Item = (String, LaunchArgValue)>, debuggable: bool, ) -> LaunchArgs

Builds a snapshot from named values.

Platform backends call this; apps read launch_args instead. A repeated name keeps the first value, matching a Bundle, where the later putExtra of the same key is what the caller has to avoid.

pub fn is_debuggable(&self) -> bool

Whether the OS considers this build debuggable — Android’s ApplicationInfo.FLAG_DEBUGGABLE, cfg!(debug_assertions) elsewhere.

Gate debug and instrumentation options on this. It is the only check that stays correct in a shipped build: a release APK reports false even when someone passes the extras, so the options cannot be turned on from the outside.

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

Whether an argument with this name was supplied, whatever its type.

The reference pattern is a single presence flag (ob_debug) that switches a whole block of options on.

pub fn names(&self) -> impl Iterator<Item = &str>

The names supplied, in the order the platform reported them.

pub fn len(&self) -> usize

The number of arguments supplied.

pub fn is_empty(&self) -> bool

Whether the app was launched without any arguments.

pub fn value(&self, name: &str) -> Option<&LaunchArgValue>

The raw value, in the type the platform delivered.

pub fn boolean(&self, name: &str) -> Option<bool>

Reads a boolean argument.

Accepts a Bool value, or text spelled true/false, 1/0, yes/no, on/off in any case. A number is not coerced: an --ei flag 1 that was meant to be --ez flag true reads as None rather than silently enabling something.

pub fn int(&self, name: &str) -> Option<i32>

Reads a 32-bit integer argument.

Accepts an Int, a Long that fits, or text.

pub fn long(&self, name: &str) -> Option<i64>

Reads a 64-bit integer argument.

Accepts a Long, an Int, or text. Seeds are the usual case, and a seed written as --ei still reads back here.

pub fn float(&self, name: &str) -> Option<f32>

Reads a float argument.

Accepts a Float, an integer widened to f32, or text.

pub fn string(&self, name: &str) -> Option<&str>

Reads a text argument.

Only a value that was delivered as text answers here, matching Bundle.getString, which returns null for an int extra. Numbers are not formatted back into strings.

Trait Implementations

impl Clone for LaunchArgs

fn clone(&self) -> LaunchArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LaunchArgs

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

Formats the value using the given formatter.

impl Default for LaunchArgs

fn default() -> LaunchArgs

Returns the “default value” for a type.

impl PartialEq for LaunchArgs

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LaunchArgs