From 0aca58fdaa09a25947d9c7912fe3d1b37761eb86 Mon Sep 17 00:00:00 2001
From: Arndt Kaiser <42686074+madmajestro@users.noreply.github.com>
Date: Thu, 27 Mar 2025 19:31:13 +0100
Subject: [PATCH] Remove unused function apc_cache_find()

---
 TECHNOTES.txt |  5 ++---
 apc_cache.c   | 20 --------------------
 apc_cache.h   |  9 +--------
 3 files changed, 3 insertions(+), 31 deletions(-)

diff --git a/TECHNOTES.txt b/TECHNOTES.txt
index f993b61d..a48e1899 100644
--- a/TECHNOTES.txt
+++ b/TECHNOTES.txt
@@ -233,9 +233,8 @@ form of a quick-start guide to start hacking on APCu.
    deletion occurs depends on runtime parameters, see INSTALL for runtime parameter
    configuration details.
 
-   apc_cache_find() simply hashes and returns the entry if it is there.  If it is there
-   but older than the mtime in the entry we are looking for, we delete the one that is
-   there and return indicating we didn't find it.
+   apc_cache_rlocked_find() simply hashes and returns the entry if it is there. If it is there
+   but older than the mtime in the entry we are looking for, we return indicating we didn't find it.
 
    API users are advised to use apc_cache_fetch over find for simplicity, this ensures
    correct operation, fetch sets up the call to find and takes care of copying and releasing
diff --git a/apc_cache.c b/apc_cache.c
index b7c1bd03..f6822b3f 100644
--- a/apc_cache.c
+++ b/apc_cache.c
@@ -784,26 +784,6 @@ PHP_APCU_API void apc_cache_default_expunge(apc_cache_t* cache, size_t size)
 }
 /* }}} */
 
-/* {{{ apc_cache_find */
-PHP_APCU_API apc_cache_entry_t *apc_cache_find(apc_cache_t* cache, zend_string *key, time_t t)
-{
-	apc_cache_entry_t *entry;
-
-	if (!cache) {
-		return NULL;
-	}
-
-	if (!apc_cache_rlock(cache)) {
-		return NULL;
-	}
-
-	entry = apc_cache_rlocked_find_incref(cache, key, t);
-	apc_cache_runlock(cache);
-
-	return entry;
-}
-/* }}} */
-
 /* {{{ apc_cache_fetch */
 PHP_APCU_API zend_bool apc_cache_fetch(apc_cache_t* cache, zend_string *key, time_t t, zval *dst)
 {
diff --git a/apc_cache.h b/apc_cache.h
index 2ee06169..b26dd0d1 100644
--- a/apc_cache.h
+++ b/apc_cache.h
@@ -167,13 +167,6 @@ PHP_APCU_API zend_bool apc_cache_atomic_update_long(
 		apc_cache_t *cache, zend_string *key, apc_cache_atomic_updater_t updater, void *data,
 		zend_bool insert_if_not_found, zend_long ttl);
 
-/*
- * apc_cache_find searches for a cache entry by its hashed identifier,
- * and returns a pointer to the entry if found, NULL otherwise.
- *
- */
-PHP_APCU_API apc_cache_entry_t* apc_cache_find(apc_cache_t* cache, zend_string *key, time_t t);
-
 /*
  * apc_cache_fetch fetches an entry from the cache directly into dst
  *
@@ -198,7 +191,7 @@ PHP_APCU_API zend_bool apc_cache_entry_fetch_zval(
 
 /*
  * apc_cache_entry_release decrements the reference count associated with a cache
- * entry. Calling apc_cache_find automatically increments the reference count,
+ * entry. Calling apc_cache_rlocked_find_incref automatically increments the reference count,
  * and this function must be called post-execution to return the count to its
  * original value. Failing to do so will prevent the entry from being
  * garbage-collected.