Enum SendData 

#[non_exhaustive]
pub enum SendData {
    Uris(Vec<String>),
    String(String),
    Bytes(Vec<u8>),
}

Kinds of data that can be sent via a DataTransfer.

Some kinds of data cannot be represented by just a binary blob in a cross-platform way. File URIs on Windows and macOS are represented as arrays of strings, and strings have different encoding on different platforms. To allow this to be represented, we allow supplying strings and URIs separately from binary blobs.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Uris(Vec<String>)

List of URIs.

These should conform to RFC 3986. If you just want to send file paths, see SendData::from_file_paths.

Note that SendData implements From<String> and From<Vec<u8>>, but not From<Vec<String>>, as it is not necessarily obvious to a reader that Vec<String> will be interpreted as a URI list. However, it does implement From<Url>, if you are using the url crate.

String(String)

String

This can also be constructed with the From<String> implementation.

Bytes(Vec<u8>)

Binary blob

This can also be constructed with the From<Vec<u8>> implementation.

Implementations

impl SendData

pub fn from_file_paths<I>(paths: I) -> Option<Self>

where I: IntoIterator, I::Item: AsRef<Path>,

Create SendData::Uris from an iterator of Paths.

All paths must be absolute, and on Windows must include either a drive prefix (e.g. C:\) or a UNC prefix (\\). See documentation for url::Url::from_file_path.

Trait Implementations

impl Clone for SendData

fn clone(&self) -> SendData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SendData

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

Formats the value using the given formatter.

impl Eq for SendData

impl From<String> for SendData

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Vec<Url>> for SendData

fn from(value: Vec<Url>) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for SendData

fn from(value: Vec<u8>) -> Self

Converts to this type from the input type.

impl Hash for SendData

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 PartialEq for SendData

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SendData