WP_Object_Cache::incr( int|string $key, int $offset = 1, string $group = 'default' ): int|false

Increments numeric cache item’s value.


Parameters

$key int|string Required
The cache key to increment.
$offset int Optional
The amount by which to increment the item's value.

Default: 1

$group string Optional
The group the key is in. Default 'default'.

Default: 'default'


Top ↑

Return

int|false The item's new value on success, false on failure.


Top ↑

Source

File: wp-includes/class-wp-object-cache.php. View all references

public function incr( $key, $offset = 1, $group = 'default' ) {
	if ( ! $this->is_valid_key( $key ) ) {
		return false;
	}

	if ( empty( $group ) ) {
		$group = 'default';
	}

	if ( $this->multisite && ! isset( $this->global_groups[ $group ] ) ) {
		$key = $this->blog_prefix . $key;
	}

	if ( ! $this->_exists( $key, $group ) ) {
		return false;
	}

	if ( ! is_numeric( $this->cache[ $group ][ $key ] ) ) {
		$this->cache[ $group ][ $key ] = 0;
	}

	$offset = (int) $offset;

	$this->cache[ $group ][ $key ] += $offset;

	if ( $this->cache[ $group ][ $key ] < 0 ) {
		$this->cache[ $group ][ $key ] = 0;
	}

	return $this->cache[ $group ][ $key ];
}


Top ↑

Changelog

Changelog
Version Description
3.3.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.