_get_component_from_parsed_url_array() │ WP 4.7.0

Retrieves a specific component from a parsed URL array.

Internal function — this function is designed to be used by the kernel itself. It is not recommended to use this function in your code.

No Hooks.

Returns

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.9.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;
	}
}