list_with_capacity()

Author: Muhtasim-Rasheed

docs/misc.md

@@ -46,6 +46,7 @@ The miscellaneous functions do not fit into any other category. They are used fo
 - `screenshot()`: Takes a screenshot of the current screen and saves it to the `exports` directory in the project root.
 - `screenshot(path)`: Takes a screenshot of the current screen and saves it to the specified path. The path is relative to the project root.
 - `typeof(value)`: Returns the type of the given value as a string.
+- `list_with_capacity(capacity)`: Returns a list with capacity for values.
 - `push(list, value)`: Pushes the given value to the end of the list and returns the new list.
 - `pop(list)`: Pops the last value from the list and returns a list containing the new list and the popped value.
 - `insert(list, index, value)`: Inserts the given value at the specified index in the list and returns the new list.

src/utils/sprite/builtins/builtins.rs

@@ -47,6 +47,7 @@ pub fn builtins() -> HashMap<String, Callable> {
     builtin!(builtins, "set_uv", |st, ar| misc::set_uv(st, ar));
     builtin!(builtins, "screenshot", |st, ar| misc::screenshot(st, ar));
     builtin!(builtins, "typeof", |_, ar| misc::r#typeof(ar));
+    builtin!(builtins, "list_with_capacity", |_, ar| misc::list_with_capacity(ar));
     builtin!(builtins, "push", |_, ar| misc::push(ar));
     builtin!(builtins, "pop", |_, ar| misc::pop(ar));
     builtin!(builtins, "insert", |_, ar| misc::insert(ar));

src/utils/sprite/builtins/misc.rs

@@ -443,6 +443,15 @@ pub fn r#typeof(args: &[Value]) -> Result {
     Ok(Value::String(value_type.to_string()))
 }
 
+pub fn list_with_capacity(args: &[Value]) -> Result {
+    if let [Value::Number(capacity)] = args {
+        let capacity = *capacity as usize;
+        Ok(Value::List(Vec::with_capacity(capacity)))
+    } else {
+        Err("list_with_capacity() expects a capacity integer".to_string())
+    }
+}
+
 pub fn push(args: &[Value]) -> Result {
     if let [Value::List(list), value] = args {
         let mut new_list = list.clone();