WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

_wp_check_alternate_file_names()

_wp_check_alternate_file_names( string[] $filenames, string $dir, array $files ): bool

In this article

Back to top

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

Helper function to test if each of an array of file names could conflict with existing files.

Parameters

$filenamesstring[]required
Array of file names to check.
$dirstringrequired
The directory containing the files.
$filesarrayrequired
An array of existing files in the directory. May be empty.

Return

bool True if the tested file name could match an existing file, false otherwise.

Source

function _wp_check_alternate_file_names( $filenames, $dir, $files ) {
	foreach ( $filenames as $filename ) {
		if ( file_exists( $dir . $filename ) ) {
			return true;
		}

		if ( ! empty( $files ) && _wp_check_existing_file_names( $filename, $files ) ) {
			return true;
		}
	}

	return false;
}

View all references View on Trac View on GitHub

UsesDescription
_wp_check_existing_file_names()wp-includes/functions.php

Helper function to check if a file name could match an existing image sub-size file name.

Used byDescription
wp_unique_filename()wp-includes/functions.php

Gets a filename that is sanitized and unique for the given directory.

Changelog

VersionDescription
5.8.1Introduced.

User Contributed Notes

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