get_theme_file_path() WordPress Function

function get_theme_file_path( $file = '' ) {
	$file = ltrim( $file, '/' );

	if ( empty( $file ) ) {
		$path = get_stylesheet_directory();
	} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
		$path = get_stylesheet_directory() . '/' . $file;
	} else {
		$path = get_template_directory() . '/' . $file;
	}

	/**
	 * Filters the path to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $path The file path.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( 'theme_file_path', $path, $file );
}
Uses	Description
wp-includes/link-template.php:theme_file_path	Filters the path to a file in the theme.
wp-includes/theme.php:get_stylesheet_directory()	Retrieves stylesheet directory path for the active theme.
wp-includes/theme.php:get_template_directory()	Retrieves template directory path for the active theme.
wp-includes/plugin.php:apply_filters()	Calls the callback functions that have been added to a filter hook.
Used By	Description
wp-includes/blocks.php:_wp_multiple_block_styles()	Allows multiple block styles.
wp-includes/block-editor.php:get_block_editor_theme_styles()	Creates an array of theme styles to load into the block editor.
wp-includes/blocks.php:register_block_script_handle()	Finds a script handle for the selected block metadata field. It detects when a path to file was provided and finds a corresponding asset file with details necessary to register the script under automatically generated handle name. It returns unprocessed script handle otherwise.
wp-includes/blocks.php:register_block_style_handle()	Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise.