feat(array): has_key()

Author: kakserpom

src/types/array/mod.rs

@@ -693,12 +693,56 @@ impl ZendHashTable {
         K: Into<ArrayKey<'k>>,
     {
         let key = key.into();
-        if self.get(key.clone()).is_some() {
+        if self.has_key(&key) {
             Entry::Occupied(entry::OccupiedEntry::new(self, key))
         } else {
             Entry::Vacant(entry::VacantEntry::new(self, key))
         }
     }
+
+    /// Checks if a key exists in the hash table.
+    ///
+    /// # Parameters
+    ///
+    /// * `key` - The key to check for in the hash table.
+    ///
+    /// # Returns
+    ///
+    /// * `true` - The key exists in the hash table.
+    /// * `false` - The key does not exist in the hash table.
+    ///
+    /// # Example
+    ///
+    /// ```no_run
+    /// use ext_php_rs::types::{ZendHashTable, ArrayKey};
+    ///
+    /// let mut ht = ZendHashTable::new();
+    ///
+    /// ht.insert("test", "hello world");
+    /// assert!(ht.has_key(&ArrayKey::from("test")));
+    /// assert!(!ht.has_key(&ArrayKey::from("missing")));
+    /// ```
+    #[must_use]
+    pub fn has_key(&self, key: &ArrayKey<'_>) -> bool {
+        match key {
+            ArrayKey::Long(index) => unsafe {
+                #[allow(clippy::cast_sign_loss)]
+                !zend_hash_index_find(self, *index as zend_ulong).is_null()
+            },
+            ArrayKey::String(key) => {
+                let Ok(cstr) = CString::new(key.as_str()) else {
+                    return false;
+                };
+                unsafe { !zend_hash_str_find(self, cstr.as_ptr(), key.len() as _).is_null() }
+            }
+            ArrayKey::Str(key) => {
+                let Ok(cstr) = CString::new(*key) else {
+                    return false;
+                };
+                unsafe { !zend_hash_str_find(self, cstr.as_ptr(), key.len() as _).is_null() }
+            }
+        }
+    }
 }
 
 unsafe impl ZBoxable for ZendHashTable {
@@ -762,3 +806,47 @@ impl<'a> FromZval<'a> for &'a ZendHashTable {
         zval.array()
     }
 }
+
+#[cfg(test)]
+#[cfg(feature = "embed")]
+mod tests {
+    use super::*;
+    use crate::embed::Embed;
+
+    #[test]
+    fn test_has_key_string() {
+        Embed::run(|| {
+            let mut ht = ZendHashTable::new();
+            let _ = ht.insert("test", "value");
+
+            assert!(ht.has_key(&ArrayKey::from("test")));
+            assert!(!ht.has_key(&ArrayKey::from("missing")));
+        });
+    }
+
+    #[test]
+    fn test_has_key_long() {
+        Embed::run(|| {
+            let mut ht = ZendHashTable::new();
+            let _ = ht.push(42i64);
+
+            assert!(ht.has_key(&ArrayKey::Long(0)));
+            assert!(!ht.has_key(&ArrayKey::Long(1)));
+        });
+    }
+
+    #[test]
+    fn test_has_key_str_ref() {
+        Embed::run(|| {
+            let mut ht = ZendHashTable::new();
+            let _ = ht.insert("hello", "world");
+
+            let key = ArrayKey::Str("hello");
+            assert!(ht.has_key(&key));
+            // Key is still usable after has_key (no clone needed)
+            assert!(ht.has_key(&key));
+
+            assert!(!ht.has_key(&ArrayKey::Str("missing")));
+        });
+    }
+}