Merge pull request #1669 from sdroege/intern-string

glib: Add bindings for `g_intern_string()` and `g_intern_static_string()` to `GStr`
gtk-rs · Mar 3, 2025 · e6b43dc · e6b43dc
2 parents 9ce31b9 + 84824fd
commit e6b43dc
Show file tree

Hide file tree

Showing 3 changed files with 72 additions and 36 deletions.
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/glib/src/gstring.rs b/glib/src/gstring.rs
@@ -289,6 +289,39 @@ impl GStr {
         }
     }
     pub const NONE: Option<&'static GStr> = None;
+
+    // rustdoc-stripper-ignore-next
+    /// Interns the string and returns the canonical representation.
+    #[inline]
+    #[doc(alias = "g_intern_string")]
+    pub fn intern(&self) -> &'static GStr {
+        unsafe {
+            let s = ffi::g_intern_string(self.to_glib_none().0);
+            GStr::from_ptr(s)
+        }
+    }
+
+    // rustdoc-stripper-ignore-next
+    /// Interns the `'static` string and returns the canonical representation.
+    #[inline]
+    #[doc(alias = "g_intern_static_string")]
+    pub fn intern_static(&'static self) -> &'static GStr {
+        unsafe {
+            let s = ffi::g_intern_static_string(self.to_glib_none().0);
+            GStr::from_ptr(s)
+        }
+    }
+
+    // rustdoc-stripper-ignore-next
+    /// Interns the string and returns the canonical representation.
+    #[inline]
+    #[doc(alias = "g_intern_string")]
+    pub fn intern_from_str(s: impl AsRef<str>) -> &'static GStr {
+        unsafe {
+            let s = ffi::g_intern_string(s.as_ref().to_glib_none().0);
+            GStr::from_ptr(s)
+        }
+    }
 }
 
 // rustdoc-stripper-ignore-next

diff --git a/graphene/src/matrix.rs b/graphene/src/matrix.rs
@@ -246,6 +246,7 @@ impl ops::MulAssign<Matrix> for Matrix {
 impl ops::Mul<Vec4> for Matrix {
     type Output = Vec4;
 
+    // rustdoc-stripper-ignore-next
     /// Transforms this `Vec4` using the provided matrix.
     /// See [Matrix::transform_vec4].
     fn mul(self, rhs: Vec4) -> Self::Output {
@@ -256,6 +257,7 @@ impl ops::Mul<Vec4> for Matrix {
 impl ops::Mul<Vec3> for Matrix {
     type Output = Vec3;
 
+    // rustdoc-stripper-ignore-next
     /// Transforms this `Vec3` using the provided matrix.
     /// See [Matrix::transform_vec3].
     fn mul(self, rhs: Vec3) -> Self::Output {
@@ -274,6 +276,7 @@ impl ops::Mul<Point> for Matrix {
 impl ops::Mul<Point3D> for Matrix {
     type Output = Point3D;
 
+    // rustdoc-stripper-ignore-next
     /// Transforms this point using the provided matrix.
     /// See [Matrix::transform_point3d].
     fn mul(self, rhs: Point3D) -> Self::Output {