Function

CFURLCopyNetLocation

Returns the net location portion of a given URL.

Declaration

CFStringRef CFURLCopyNetLocation(CFURLRef anURL);

Parameters

anURL

The CFURL object to examine.

Return Value

The net location of anURL, or NULL if the URL cannot be decomposed (doesn't conform to RFC 1808). Ownership follows the create rule. See The Create Rule.

Discussion

The URL net location is the portion of the URL that identifies the network address of the resource. It includes the optional username and password, as well as the target machine’s IP address or host name.

This function leaves any percent escape sequences intact.

See Also

Accessing the Parts of a URL

CFURLCanBeDecomposed

Determines if the given URL conforms to RFC 1808 and therefore can be decomposed.

CFURLCopyFileSystemPath

Returns the path portion of a given URL.

CFURLCopyFragment

Returns the fragment from a given URL.

CFURLCopyHostName

Returns the host name of a given URL.

CFURLCopyLastPathComponent

Returns the last path component of a given URL.

CFURLCopyParameterString

Returns the parameter string from a given URL.

Deprecated
CFURLCopyPassword

Returns the password of a given URL.

CFURLCopyPath

Returns the path portion of a given URL.

CFURLCopyPathExtension

Returns the path extension of a given URL.

CFURLCopyQueryString

Returns the query string of a given URL.

CFURLCopyResourceSpecifier

Returns any additional resource specifiers after the path.

CFURLCopyScheme

Returns the scheme portion of a given URL.

CFURLCopyStrictPath

Returns the path portion of a given URL.

CFURLCopyUserName

Returns the user name from a given URL.

CFURLGetPortNumber

Returns the port number from a given URL.

CFURLHasDirectoryPath

Determines if a given URL's path represents a directory.