Changeset 18580 for trunk/wp-includes/cache.php

Timestamp:

08/22/2011 05:39:44 PM (13 years ago)

Author:

ryan

Message:

Introduce wp_cache_incr() and wp_cache_decr(). fixes #18494

File:

• trunk/wp-includes/cache.php (modified) (4 diffs)

trunk/wp-includes/cache.php

@@ -45 +45 @@
 
 /**
+ * Decrement numeric cache item's value
+ *
+ * @since 3.3.0
+ * @uses $wp_object_cache Object Cache Class
+ * @see WP_Object_Cache::decr()
+ *
+ * @param int|string $key The cache ID to increment
+ * @param int $offset The amount by which to decrement the item's value.  Default is 1.
+ * @param string $flag The group the key is in.
+ * @return false|int False on failure, the item's new value on success.
+ */
+function wp_cache_decr( $key, $offset = 1, $flag = '' ) {
+    global $wp_object_cache;
+
+    return $wp_object_cache->decr( $key, $offset, $flag );
+}
+
+/**
  * Removes the cache contents matching ID and flag.
  *
@@ -92 +110 @@
 
     return $wp_object_cache->get($id, $flag);
+}
+
+/**
+ * Increment numeric cache item's value
+ *
+ * @since 3.3.0
+ * @uses $wp_object_cache Object Cache Class
+ * @see WP_Object_Cache::incr()
+ *
+ * @param int|string $key The cache ID to increment
+ * @param int $offset The amount by which to increment the item's value.  Default is 1.
+ * @param string $flag The group the key is in.
+ * @return false|int False on failure, the item's new value on success.
+ */
+function wp_cache_incr( $key, $offset = 1, $flag = '' ) {
+    global $wp_object_cache;
+
+    return $wp_object_cache->incr( $key, $offset, $flag );
 }
 
@@ -279 +315 @@
         $this->global_groups = array_merge($this->global_groups, $groups);
         $this->global_groups = array_unique($this->global_groups);
+    }
+
+    /**
+     * Decrement numeric cache item's value
+     *
+     * @since 3.3.0
+     *
+     * @param int|string $id The cache ID to increment
+     * @param int $offset The amount by which to decrement the item's value.  Default is 1.
+     * @param string $flag The group the key is in.
+     * @return false|int False on failure, the item's new value on success.
+     */
+    function decr( $id, $offset = 1, $group = 'default' ) {
+        if ( ! isset( $this->cache[ $group ][ $id ] ) )
+            return false;
+
+        if ( ! is_numeric( $this->cache[ $group ][ $id ] ) )
+            $this->cache[ $group ][ $id ] = 0;
+
+        $offset = (int) $offset;
+
+        $this->cache[ $group ][ $id ] -= $offset;
+
+        if ( $this->cache[ $group ][ $id ] < 0 )
+            $this->cache[ $group ][ $id ] = 0;
+
+        return $this->cache[ $group ][ $id ];
     }
 
@@ -362 +425 @@
         $this->cache_misses += 1;
         return false;
+    }
+
+    /**
+     * Increment numeric cache item's value
+     *
+     * @since 3.3.0
+     *
+     * @param int|string $id The cache ID to increment
+     * @param int $offset The amount by which to increment the item's value.  Default is 1.
+     * @param string $flag The group the key is in.
+     * @return false|int False on failure, the item's new value on success.
+     */
+    function incr( $id, $offset = 1, $group = 'default' ) {
+        if ( ! isset( $this->cache[ $group ][ $id ] ) )
+            return false;
+
+        if ( ! is_numeric( $this->cache[ $group ][ $id ] ) )
+            $this->cache[ $group ][ $id ] = 0;
+
+        $offset = (int) $offset;
+
+        $this->cache[ $group ][ $id ] += $offset;
+
+        if ( $this->cache[ $group ][ $id ] < 0 )
+            $this->cache[ $group ][ $id ] = 0;
+
+        return $this->cache[ $group ][ $id ];
     }