_deep_replace( string|array $search, string $subject ): string

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only by core. It is listed here for completeness.

Performs a deep string replace operation to ensure the values in $search are no longer present.

Description

Repeats the replacement operation until it no longer replaces anything to remove “nested” values e.g. $subject = ‘%0%0%0DDD’, $search =’%0D’, $result ='' rather than the ‘%0%0DD’ that str_replace would return

Parameters

$searchstring|arrayrequired
The value being searched for, otherwise known as the needle.
An array may be used to designate multiple needles.
$subjectstringrequired
The string being searched and replaced on, otherwise known as the haystack.

Return

string The string with the replaced values.

Source

function _deep_replace( $search, $subject ) {
	$subject = (string) $subject;

	$count = 1;
	while ( $count ) {
		$subject = str_replace( $search, '', $subject, $count );
	}

	return $subject;
}

Changelog

VersionDescription
2.8.1Introduced.

User Contributed Notes

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