QUrl

QUrl is a class in the Qt framework that encapsulates a Uniform Resource Locator (URL) and provides facilities for parsing, constructing, and manipulating URLs in a platform-agnostic manner. It supports the standard URL components, including scheme, userInfo, host, port, path, query, and fragment, and can represent both absolute and relative URLs as well as local files.

Construction and parsing: QUrl can be created from a string, from a local file path via fromLocalFile, or from user input using fromUserInput for URLs entered by users. The class offers accessors to inspect components (scheme, host, port, path, query, fragment) and methods to determine properties such as validity, absoluteness, or whether it refers to a local file. It is commonly used together with related classes like QUrlQuery to manipulate the query string.

Encoding and decoding: URLs often require percent-encoding to ensure safe transport. QUrl provides support for encoding and decoding URL components and can produce representations suitable for display or transmission. It can generate a display-friendly string (toDisplayString) and a fully encoded form for network usage. For handling query strings separately, QUrlQuery offers convenient parsing and modification of parameters.

Usage: QUrl is central to Qt’s network stack, used by classes such as QNetworkRequest, QNetworkAccessManager, and related networking utilities. It is designed to be cross-platform and resilient to variations in URL formats encountered across different environments and protocols.

See also: QUrlQuery.