diff --git a/crates/typst-library/src/foundations/str.rs b/crates/typst-library/src/foundations/str.rs index 23a1bd4cf..015716b94 100644 --- a/crates/typst-library/src/foundations/str.rs +++ b/crates/typst-library/src/foundations/str.rs @@ -178,25 +178,39 @@ impl Str { self.0.len() } - /// Extracts the first grapheme cluster of the string. - /// Fails with an error if the string is empty. + /// Extracts the first grapheme cluster of the string. Fails with an error + /// if the string is empty. Returns the default value if the string is empty + /// or fails with an error is no default value was specified. #[func] - pub fn first(&self) -> StrResult { + pub fn first( + &self, + /// A default value to return if the string is empty. + #[named] + default: Option, + ) -> StrResult { self.0 .graphemes(true) .next() .map(Into::into) + .or(default) .ok_or_else(string_is_empty) } - /// Extracts the last grapheme cluster of the string. - /// Fails with an error if the string is empty. + /// Extracts the last grapheme cluster of the string. Fails with an error if + /// the string is empty. Returns the default value if the string is empty or + /// fails with an error is no default value was specified. #[func] - pub fn last(&self) -> StrResult { + pub fn last( + &self, + /// A default value to return if the string is empty. + #[named] + default: Option, + ) -> StrResult { self.0 .graphemes(true) .next_back() .map(Into::into) + .or(default) .ok_or_else(string_is_empty) }