Backport official GLib iterator safety fix for Linux desktop

apps/desktop/src-tauri/vendor/glib/src/unicollate.rs

@@ -0,0 +1,88 @@
+// Take a look at the license at the top of the repository in the LICENSE file.
+
+use crate::translate::*;
+
+// rustdoc-stripper-ignore-next
+/// A `CollationKey` allows ordering strings using the linguistically correct rules for the current locale.
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
+pub struct CollationKey(String);
+
+impl<T: AsRef<str>> From<T> for CollationKey {
+    // rustdoc-stripper-ignore-next
+    /// Converts a string into a `CollationKey` that can be compared with other
+    /// collation keys produced by the same function using `std::cmp::Ordering::cmp()`.
+    #[doc(alias = "g_utf8_collate_key")]
+    fn from(s: T) -> Self {
+        let key =
+            unsafe { from_glib_full(ffi::g_utf8_collate_key(s.as_ref().to_glib_none().0, -1)) };
+        Self(key)
+    }
+}
+
+// rustdoc-stripper-ignore-next
+/// A `FilenameCollationKey` allows ordering file names using the linguistically correct rules for the current locale.
+/// Compared to `CollationKey`, filename collation keys take into consideration dots and other characters
+/// commonly found in file names.
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
+pub struct FilenameCollationKey(String);
+
+impl<T: AsRef<str>> From<T> for FilenameCollationKey {
+    // rustdoc-stripper-ignore-next
+    /// Converts a string into a `FilenameCollationKey` that can be compared with other
+    /// collation keys produced by the same function using `std::cmp::Ordering::cmp()`.
+    #[doc(alias = "g_utf8_collate_key_for_filename")]
+    fn from(s: T) -> Self {
+        let key = unsafe {
+            from_glib_full(ffi::g_utf8_collate_key_for_filename(
+                s.as_ref().to_glib_none().0,
+                -1,
+            ))
+        };
+        Self(key)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn collate() {
+        let mut unsorted = vec![
+            String::from("bcd"),
+            String::from("cde"),
+            String::from("abc"),
+        ];
+
+        let sorted = vec![
+            String::from("abc"),
+            String::from("bcd"),
+            String::from("cde"),
+        ];
+
+        unsorted.sort_by(|s1, s2| CollationKey::from(&s1).cmp(&CollationKey::from(&s2)));
+
+        assert_eq!(unsorted, sorted);
+    }
+
+    #[test]
+    fn collate_filenames() {
+        let mut unsorted = vec![
+            String::from("bcd.a"),
+            String::from("cde.b"),
+            String::from("abc.c"),
+        ];
+
+        let sorted = vec![
+            String::from("abc.c"),
+            String::from("bcd.a"),
+            String::from("cde.b"),
+        ];
+
+        unsorted.sort_by(|s1, s2| {
+            FilenameCollationKey::from(&s1).cmp(&FilenameCollationKey::from(&s2))
+        });
+
+        assert_eq!(unsorted, sorted);
+    }
+}