wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_unique_prefixed_id › WordPress Function

Since6.4.0
Deprecatedn/a
wp_unique_prefixed_id ( $prefix = '' )
Parameters:
  • (string) $prefix Optional. Prefix for the returned ID. Default empty string.
    Required: No
    Default: (empty)
Returns:
  • (string) Incremental ID per prefix.
Defined at:
Codex:

Generates an incremental ID that is independent per each different prefix.

It is similar to wp_unique_id, but each prefix has its own internal ID counter to make each prefix independent from each other. The ID starts at 1 and increments on each call. The returned value is not universally unique, but it is unique across the life of the PHP process and it's stable per prefix.


Source

function wp_unique_prefixed_id( $prefix = '' ) {
	static $id_counters = array();

	if ( ! is_string( $prefix ) ) {
		wp_trigger_error(
			__FUNCTION__,
			sprintf( 'The prefix must be a string. "%s" data type given.', gettype( $prefix ) )
		);
		$prefix = '';
	}

	if ( ! isset( $id_counters[ $prefix ] ) ) {
		$id_counters[ $prefix ] = 0;
	}

	$id = ++$id_counters[ $prefix ];

	return $prefix . (string) $id;
}