Changeset 18580

Timestamp:

08/22/2011 05:39:44 PM (15 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 ];
         }