_get_component_from_parsed_url_array() │ WP 4.7.0

Retrieve a specific component from a parsed URL array.

This is an internal function for using it by WP core itself. It's not recommended to use this function in your code.

No Hooks.

Return

Mixed. False on parse failure; Array of URL components on success; When a specific component has been requested: null if the component doesn't exist in the given URL; a string or - in the case of PHP_URL_PORT - integer when it does. See parse_url()'s return values.

Usage

_get_component_from_parsed_url_array( $url_parts, $component );
$url_parts(array|false) (required)
The parsed URL. Can be false if the URL failed to parse.
$component(int)
The specific component to retrieve. Use one of the PHP predefined constants to specify which one.
Default: -1 (= return all parts as an array)

Changelog

Since 4.7.0 Introduced.

_get_component_from_parsed_url_array() code WP 6.1.1

wp-includes/http.php 
function _get_component_from_parsed_url_array( $url_parts, $component = -1 ) {
	if ( -1 === $component ) {
		return $url_parts;
	}

	$key = _wp_translate_php_url_constant_to_key( $component );
	if ( false !== $key && is_array( $url_parts ) && isset( $url_parts[ $key ] ) ) {
		return $url_parts[ $key ];
	} else {
		return null;
	}
}