1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
//! Rust side representation of a Dart side [`List`].
//!
//! [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
use dart_sys::Dart_Handle;
use derive_more::From;
use medea_macro::dart_bridge;
use crate::{
api::DartValue,
platform::dart::utils::{handle::DartHandle, NonNullDartValueArgExt as _},
};
#[dart_bridge("flutter/lib/src/native/ffi/list.g.dart")]
mod list {
use std::ptr;
use dart_sys::Dart_Handle;
use crate::{
api::{DartValue, DartValueArg},
platform::{dart::utils::handle::DartHandle, Error},
};
extern "C" {
/// Returns an element by the provided `index` from the provided
/// [`List`].
///
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
pub fn get(
list: Dart_Handle,
index: u32,
) -> Result<ptr::NonNull<DartValueArg<Option<DartHandle>>>, Error>;
/// Returns [`length`] of the provided [`List`].
///
/// [`length`]: https://api.dart.dev/stable/dart-core/List/length.html
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
pub fn length(list: Dart_Handle) -> Result<u32, Error>;
/// Initializes a new empty [`List`].
///
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
pub fn init() -> Result<Dart_Handle, Error>;
/// Adds the provided [`DartValue`] to the provided [`List`].
///
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
pub fn add(map: Dart_Handle, value: DartValue) -> Result<(), Error>;
}
}
/// Rust side representation of a Dart side [`List`].
///
/// [`List`]: https://api.dart.dev/stable/dart-core/List-class.html
#[derive(Debug, From)]
pub struct DartList(DartHandle);
impl DartList {
/// Creates a new empty [`DartList`].
#[must_use]
pub fn new() -> Self {
let map = unsafe { list::init() }.unwrap();
Self(unsafe { DartHandle::new(map) })
}
/// Adds the provided [`DartValue`] to the end of this [`DartList`],
/// extending the length by one.
pub fn add(&mut self, value: DartValue) {
unsafe { list::add(self.0.get(), value) }.unwrap();
}
/// Returns an element by the provided `index` from this [`DartList`].
#[expect(clippy::unwrap_in_result, reason = "unrelated")]
#[must_use]
pub fn get(&self, index: usize) -> Option<DartHandle> {
#[expect( // intended
clippy::cast_possible_truncation,
reason = "overflow is unexpected"
)]
let item_ptr =
unsafe { list::get(self.0.get(), index as u32) }.unwrap();
unsafe { item_ptr.unbox() }.try_into().unwrap()
}
/// Returns [`length`] of this [`DartList`].
///
/// [`length`]: https://api.dart.dev/stable/dart-core/List/length.html
#[must_use]
pub fn length(&self) -> usize {
unsafe { list::length(self.0.get()).unwrap() as usize }
}
/// Returns the underlying [`Dart_Handle`] of this [`DartList`].
#[must_use]
pub fn handle(&self) -> Dart_Handle {
self.0.get()
}
}
impl<T: From<DartHandle>> From<DartList> for Vec<T> {
fn from(list: DartList) -> Self {
let len = list.length();
let mut out = Self::with_capacity(len);
for i in 0..len {
if let Some(v) = list.get(i) {
out.push(v.into());
}
}
out
}
}
impl Default for DartList {
fn default() -> Self {
Self::new()
}
}