QUrl Class

Dokumentation der Mitgliedsfunktionen

QUrl::QUrl()

Konstruiert ein leeres QUrl-Objekt.

QUrl::QUrl(const QString &url, QUrl::ParsingMode parsingMode = TolerantMode)

Konstruiert eine URL durch Parsen von url. Beachten Sie, dass dieser Konstruktor eine korrekte URL oder URL-Referenz erwartet und nicht versucht, die Absicht zu erraten. Zum Beispiel die folgende Deklaration:

QUrl url("example.com");

Konstruiert eine gültige URL, die aber möglicherweise nicht den Erwartungen entspricht, da der scheme()-Teil der Eingabe fehlt. Für eine Zeichenkette wie die obige möchten Anwendungen vielleicht fromUserInput() verwenden. Für diesen Konstruktor oder setUrl() ist wahrscheinlich das Folgende beabsichtigt:

QUrl url("https://example.com");

QUrl kodiert automatisch alle Zeichen, die in einer URL nicht erlaubt sind, und dekodiert die prozentual kodierten Sequenzen, die ein nicht reserviertes Zeichen darstellen (Buchstaben, Ziffern, Bindestriche, Unterstriche, Punkte und Tilden). Alle anderen Zeichen werden in ihrer ursprünglichen Form belassen.

Parst die url unter Verwendung des Parsermodus parsingMode. Im Modus TolerantMode (Standardeinstellung) korrigiert QUrl bestimmte Fehler, insbesondere das Vorhandensein eines Prozentzeichens ("%"), auf das nicht zwei hexadezimale Ziffern folgen, und akzeptiert jedes Zeichen an jeder Position. In StrictMode werden Kodierungsfehler nicht toleriert, und QUrl prüft auch, ob bestimmte verbotene Zeichen nicht in unverschlüsselter Form vorhanden sind. Wenn in StrictMode ein Fehler festgestellt wird, gibt isValid() false zurück. Der Parsing-Modus DecodedMode ist in diesem Zusammenhang nicht erlaubt.

Beispiel:

QUrl url("http://www.example.com/List of holidays.xml");
// url.toEncoded() == "http://www.example.com/List%20of%20holidays.xml"

Um eine URL aus einer kodierten Zeichenkette zu konstruieren, können Sie auch fromEncoded() verwenden:

QUrl url = QUrl::fromEncoded("http://qt-project.org/List%20of%20holidays.xml");

Beide Funktionen sind gleichwertig und in Qt 5 akzeptieren beide Funktionen kodierte Daten. Normalerweise hängt die Wahl des QUrl-Konstruktors oder setUrl() versus fromEncoded() von den Quelldaten ab: Der Konstruktor und setUrl() nehmen ein QString, während fromEncoded ein QByteArray nimmt.

Siehe auch setUrl(), fromEncoded(), und TolerantMode.

[noexcept] QUrl::QUrl(const QUrl &other)

Konstruiert eine Kopie von other.

[noexcept] QUrl::QUrl(QUrl &&other)

Move-konstruiert eine QUrl-Instanz, die auf das gleiche Objekt zeigt, auf das other gezeigt hat.

[noexcept] QUrl::~QUrl()

Destruktor; wird aufgerufen, unmittelbar bevor das Objekt gelöscht wird.

QUrl QUrl::adjusted(QUrl::FormattingOptions options) const

Gibt eine angepasste Version der URL zurück. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden.

Die Kodierungsoptionen von QUrl::ComponentFormattingOption sind für diese Methode nicht sehr sinnvoll, ebenso wenig wie QUrl::PreferLocalFile.

Dies ist immer gleichbedeutend mit QUrl(url.toString(options)).

Siehe auch FormattingOptions, toEncoded(), und toString().

QString QUrl::authority(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

Gibt die Autorität der URL zurück, wenn sie definiert ist; andernfalls wird ein leerer String zurückgegeben.

Diese Funktion gibt einen eindeutigen Wert zurück, der die Zeichen enthalten kann, die noch prozentual kodiert sind, sowie einige Steuersequenzen, die in QString nicht in dekodierter Form dargestellt werden können.

Das Argument options steuert, wie die Benutzerinformationskomponente formatiert werden soll. Der Wert von QUrl::FullyDecoded ist in dieser Funktion nicht zulässig. Wenn Sie vollständig dekodierte Daten benötigen, rufen Sie userName(), password(), host() und port() einzeln auf.

Siehe auch setAuthority(), userInfo(), userName(), password(), host(), und port().

void QUrl::clear()

Setzt den Inhalt von QUrl zurück. Nach dem Aufruf dieser Funktion ist QUrl gleich demjenigen, der mit dem Standard-Leer-Konstruktor erstellt wurde.

Siehe auch isEmpty().

QString QUrl::errorString() const

Gibt eine Fehlermeldung zurück, wenn bei der letzten Operation, die dieses QUrl Objekt verändert hat, ein Parsing-Fehler aufgetreten ist. Wurde kein Fehler festgestellt, gibt diese Funktion eine leere Zeichenkette zurück und isValid() gibt true zurück.

Die von dieser Funktion zurückgegebene Fehlermeldung ist technischer Natur und wird von Endbenutzern möglicherweise nicht verstanden. Sie ist hauptsächlich für Entwickler nützlich, die versuchen zu verstehen, warum QUrl eine bestimmte Eingabe nicht akzeptiert.

Siehe auch QUrl::ParsingMode.

QString QUrl::fileName(QUrl::ComponentFormattingOptions options = FullyDecoded) const

Gibt den Namen der Datei zurück, ohne den Verzeichnispfad.

Wird diesem QUrl -Objekt ein Pfad übergeben, der mit einem Schrägstrich endet, wird der Name der Datei als leer betrachtet.

Enthält der Pfad keinen Schrägstrich, wird er vollständig als Dateiname zurückgegeben.

Beispiel:

QUrl url("http://qt-project.org/support/file.html");
// url.adjusted(RemoveFilename) == "http://qt-project.org/support/"
// url.fileName() == "file.html"

Das Argument options bestimmt, wie die Dateinamenkomponente formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Siehe auch path().

QString QUrl::fragment(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

Gibt das Fragment der URL zurück. Um festzustellen, ob die geparste URL ein Fragment enthält, verwenden Sie hasFragment().

Das Argument options steuert, wie die Fragmentkomponente formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Beachten Sie, dass QUrl::FullyDecoded zu Datenverlusten führen kann, wenn diese nicht darstellbaren Sequenzen vorhanden sind. Es wird empfohlen, diesen Wert zu verwenden, wenn das Ergebnis in einem Nicht-URL-Kontext verwendet werden soll.

Siehe auch setFragment() und hasFragment().

[static, since 6.3] QString QUrl::fromAce(const QByteArray &domain, QUrl::AceProcessingOptions options = {})

Gibt die Unicode-Form des angegebenen Domänennamens domain zurück, die in der ASCII-kompatiblen Kodierung (ACE) kodiert ist. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden. Das Ergebnis dieser Funktion wird als äquivalent zu domain betrachtet.

Wenn der Wert in domain nicht kodiert werden kann, wird er in QString umgewandelt und zurückgegeben.

Die ASCII-kompatible Kodierung (ACE) wird durch RFC 3490, RFC 3491 und RFC 3492 definiert und durch den Unicode Technical Standard #46 aktualisiert. Sie ist Teil der Spezifikation Internationalizing Domain Names in Applications (IDNA), die es ermöglicht, Domainnamen (wie "example.com") mit Nicht-US-ASCII-Zeichen zu schreiben.

Diese Funktion wurde in Qt 6.3 eingeführt.

[static] QUrl QUrl::fromCFURL(CFURLRef url)

Konstruiert eine QUrl, die eine Kopie der CFURL url enthält.

[static] QUrl QUrl::fromEncoded(QByteArrayView input, QUrl::ParsingMode mode = TolerantMode)

Analysiert input und gibt die entsprechende QUrl zurück. input wird in kodierter Form angenommen und enthält nur ASCII-Zeichen.

Analysiert die URL mit mode. Siehe setUrl() für weitere Informationen zu diesem Parameter. QUrl::DecodedMode ist in diesem Zusammenhang nicht erlaubt.

Siehe auch toEncoded() und setUrl().

[static] QUrl QUrl::fromLocalFile(const QString &localFile)

Gibt eine QUrl Darstellung von localFile zurück, die als lokale Datei interpretiert wird. Diese Funktion akzeptiert Pfade, die durch Schrägstriche getrennt sind, sowie das native Trennzeichen für diese Plattform.

Diese Funktion akzeptiert auch Pfade mit einem doppelten führenden Schrägstrich (oder Backslash), um eine entfernte Datei anzuzeigen, wie in "//servername/path/to/file.txt". Beachten Sie, dass nur bestimmte Plattformen diese Datei tatsächlich mit QFile::open() öffnen können.

Eine leere localFile führt zu einer leeren URL (seit Qt 5.4).

   qDebug()<< QUrl::fromLocalFile("file.txt"); // QUrl("file:file.txt")    qDebug() << QUrl::fromLocalFile("/home/user/file.txt"); // QUrl("file:///home/user/file.txt")
    qDebug() << QUrl::fromLocalFile("file:file.txt");       // doesn't make sense; expects path, not url with scheme

In der ersten Zeile des obigen Ausschnitts wird ein Datei-URL aus einem lokalen, relativen Pfad konstruiert. Eine Datei-URL mit einem relativen Pfad ist nur dann sinnvoll, wenn es eine Basis-URL gibt, gegen die sie aufgelöst werden kann. Zum Beispiel:

    QUrl url = QUrl::fromLocalFile("file.txt");    QUrl baseUrl = QUrl("file:/home/user/"); // falsch: gibt QUrl("file:file.txt") aus, da url bereits ein Schema hat    qDebug() << baseUrl.resolved(url);

Um eine solche URL aufzulösen, muss man das Schema vorher entfernen:

   // korrekt: prints QUrl("file:///home/user/file.txt")url.setScheme(QString());    qDebug() << baseUrl.resolved(url);

Aus diesem Grund ist es besser, für relative Dateipfade eine relative URL (d. h. kein Schema) zu verwenden:

    QUrl url = QUrl("datei.txt");    QUrl baseUrl = QUrl("file:/home/user/"); // gibt QUrl("file:///home/user/file.txt") aus    qDebug() << baseUrl.resolved(url);

Siehe auch toLocalFile(), isLocalFile(), und QDir::toNativeSeparators().

[static] QUrl QUrl::fromNSURL(const NSURL *url)

Konstruiert eine QUrl, die eine Kopie der NSURL url enthält.

[static] QString QUrl::fromPercentEncoding(const QByteArray &input)

Gibt eine dekodierte Kopie von input zurück. input wird zunächst aus der Prozentkodierung dekodiert und dann von UTF-8 in Unicode konvertiert.

[static] QList<QUrl> QUrl::fromStringList(const QStringList &urls, QUrl::ParsingMode mode = TolerantMode)

Konvertiert eine Liste von Strings, die urls repräsentieren, in eine Liste von URLs unter Verwendung von QUrl(str, mode). Beachten Sie, dass dies bedeutet, dass alle Strings URLs sein müssen, nicht etwa lokale Pfade.

[static] QUrl QUrl::fromUserInput(const QString &userInput, const QString &workingDirectory = QString(), QUrl::UserInputResolutionOptions options = DefaultResolution)

Gibt eine gültige URL aus einer vom Benutzer angegebenen userInput Zeichenkette zurück, sofern eine solche abgeleitet werden kann. Falls dies nicht möglich ist, wird ein ungültiger QUrl() zurückgegeben.

Dies ermöglicht es dem Benutzer, eine URL oder einen lokalen Dateipfad in Form einer einfachen Zeichenfolge einzugeben. Diese Zeichenfolge kann manuell in eine Adressleiste eingegeben, aus der Zwischenablage entnommen oder über Befehlszeilenargumente übergeben werden.

Wenn die Zeichenkette nicht bereits eine gültige URL ist, wird eine bestmögliche Schätzung vorgenommen, wobei verschiedene Annahmen getroffen werden.

Entspricht die Zeichenkette einem gültigen Dateipfad auf dem System, wird eine file:// URL unter Verwendung von QUrl::fromLocalFile() erstellt.

Ist dies nicht der Fall, wird versucht, die Zeichenkette in eine http:// oder ftp:// URL zu verwandeln. Letzteres ist der Fall, wenn die Zeichenkette mit "ftp" beginnt. Das Ergebnis wird dann durch den toleranten Parser von QUrl geleitet, und im Erfolgsfall wird eine gültige QUrl zurückgegeben, andernfalls eine QUrl().

Beispiele:

• qt-project.org wird zu http://qt-project.org
• ftp.qt-project.org wird zu ftp://ftp.qt-project.org
• hostname wird zu http://hostname
• /home/user/test.html wird zu file:///home/user/test.html

Um relative Pfade behandeln zu können, nimmt diese Methode einen optionalen workingDirectory Pfad an. Dies ist besonders nützlich bei der Behandlung von Befehlszeilenargumenten. Wenn workingDirectory leer ist, werden keine relativen Pfade verarbeitet.

Standardmäßig wird ein Eingabe-String, der wie ein relativer Pfad aussieht, nur dann als solcher behandelt, wenn die Datei tatsächlich im angegebenen Arbeitsverzeichnis existiert. Wenn die Anwendung mit Dateien umgehen kann, die noch nicht existieren, sollte sie das Flag AssumeLocalFile in options übergeben.

bool QUrl::hasFragment() const

Gibt true zurück, wenn diese URL ein Fragment enthält (d. h., wenn # darauf gesehen wurde).

Siehe auch fragment() und setFragment().

bool QUrl::hasQuery() const

Gibt true zurück, wenn diese URL eine Abfrage enthält (d. h., wenn ? darauf gesehen wurde).

Siehe auch setQuery(), query(), und hasFragment().

QString QUrl::host(QUrl::ComponentFormattingOptions options = FullyDecoded) const

Gibt den Host der URL zurück, wenn er definiert ist; andernfalls wird eine leere Zeichenkette zurückgegeben.

Das Argument options bestimmt, wie der Hostname formatiert wird. Die Option QUrl::EncodeUnicode veranlasst diese Funktion, den Hostnamen in der ASCII-kompatiblen Kodierung (ACE) zurückzugeben, die für die Verwendung in Kanälen geeignet ist, die nicht 8-Bit-sauber sind oder die den alten Hostnamen erfordern (wie DNS-Anfragen oder in HTTP-Anfrage-Headern). Wenn dieses Flag nicht vorhanden ist, gibt diese Funktion den internationalen Domänennamen (IDN) in Unicode-Form zurück, entsprechend der Liste der zulässigen Top-Level-Domänen (siehe idnWhitelist()).

Alle anderen Flags werden ignoriert. Hostnamen können keine Steuer- oder Prozentzeichen enthalten, so dass der zurückgegebene Wert als vollständig dekodiert betrachtet werden kann.

Siehe auch setHost(), idnWhitelist(), setIdnWhitelist(), und authority().

[static] QStringList QUrl::idnWhitelist()

Gibt die aktuelle Whitelist der Top-Level-Domains zurück, die Nicht-ASCII-Zeichen in ihren Zusammensetzungen enthalten dürfen.

Siehe setIdnWhitelist() für die Gründe für diese Liste.

Siehe auch setIdnWhitelist() und AceProcessingOption.

bool QUrl::isEmpty() const

Gibt true zurück, wenn die URL keine Daten enthält; andernfalls wird false zurückgegeben.

Siehe auch clear().

bool QUrl::isLocalFile() const

Gibt true zurück, wenn diese URL auf einen lokalen Dateipfad verweist. Eine URL ist ein lokaler Dateipfad, wenn das Schema "file" ist.

Beachten Sie, dass diese Funktion URLs mit Hostnamen als lokale Dateipfade betrachtet, auch wenn der eventuelle Dateipfad nicht mit QFile::open() geöffnet werden kann.

Siehe auch fromLocalFile() und toLocalFile().

bool QUrl::isParentOf(const QUrl &childUrl) const

Gibt true zurück, wenn diese URL ein übergeordnetes Element von childUrl ist. childUrl ist ein untergeordnetes Element dieser URL, wenn die beiden URLs dasselbe Schema und dieselbe Autorität haben und der Pfad dieser URL ein übergeordnetes Element des Pfads von childUrl ist.

bool QUrl::isRelative() const

Gibt true zurück, wenn die URL relativ ist; andernfalls wird false zurückgegeben. Eine URL ist eine relative Referenz, wenn ihr Schema undefiniert ist; diese Funktion ist daher äquivalent zum Aufruf von scheme().isEmpty().

Relative Referenzen sind in RFC 3986 Abschnitt 4.2 definiert.

Siehe auch Relative URLs vs Relative Paths.

bool QUrl::isValid() const

Gibt true zurück, wenn die URL nicht leer und gültig ist; andernfalls wird false zurückgegeben.

Die URL wird einem Konformitätstest unterzogen. Jeder Teil der URL muss mit den Standardkodierungsregeln des URI-Standards übereinstimmen, damit die URL als gültig gemeldet wird.

bool checkUrl(const QUrl &url) { if (!url.isValid()) {        qDebug("Invalid URL: %s", qUtf8Printable(url.toString()));
       return false; } return true; }

bool QUrl::matches(const QUrl &url, QUrl::FormattingOptions options) const

Gibt true zurück, wenn diese URL und die angegebene url nach Anwendung von options auf beide gleich sind; andernfalls wird false zurückgegeben.

Dies ist gleichbedeutend mit dem Aufruf von adjusted(options) für beide URLs und dem Vergleich der resultierenden URLs, aber schneller.

QString QUrl::password(QUrl::ComponentFormattingOptions options = FullyDecoded) const

Gibt das Passwort der URL zurück, wenn es definiert ist; andernfalls wird eine leere Zeichenfolge zurückgegeben.

Das Argument options steuert, wie die Komponente Benutzername formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Beachten Sie, dass QUrl::FullyDecoded zu Datenverlusten führen kann, wenn diese nicht darstellbaren Sequenzen vorhanden sind. Es wird empfohlen, diesen Wert zu verwenden, wenn das Ergebnis in einem Nicht-URL-Kontext verwendet wird, z. B. bei der Einstellung in QAuthenticator oder bei der Aushandlung eines Logins.

Siehe auch setPassword().

QString QUrl::path(QUrl::ComponentFormattingOptions options = FullyDecoded) const

Gibt den Pfad der URL zurück.

   qDebug()<< QUrl("file:file.txt").path(); // "file.txt"    qDebug() << QUrl("/home/user/file.txt").path();             // "/home/user/file.txt"
    qDebug() << QUrl("http://www.example.com/test/123").path(); // "/test/123"

Das Argument options steuert, wie die Pfadkomponente formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Beachten Sie, dass QUrl::FullyDecoded zu Datenverlusten führen kann, wenn diese nicht darstellbaren Sequenzen vorhanden sind. Es wird empfohlen, diesen Wert zu verwenden, wenn das Ergebnis in einem Nicht-URL-Kontext verwendet wird, z. B. beim Senden an einen FTP-Server.

Ein Beispiel für einen Datenverlust ist, wenn Sie nicht Unicode-prozentkodierte Sequenzen haben und FullyDecoded (die Vorgabe) verwenden:

    qDebug() << QUrl("/foo%FFbar").path();

In diesem Beispiel kommt es zu einem gewissen Datenverlust, da die %FF nicht konvertiert werden kann.

Datenverluste können auch auftreten, wenn der Pfad Sub-Delimiter enthält (z. B. +):

    qDebug() << QUrl("/foo+bar%2B").path(); // "/foo+bar+"

Andere Dekodierungsbeispiele:

   const QUrl url("/tmp/Mambo %235%3F.mp3");    qDebug() << url.path(QUrl::FullyDecoded);  // "/tmp/Mambo #5?.mp3"
    qDebug() << url.path(QUrl::PrettyDecoded); // "/tmp/Mambo #5?.mp3"
    qDebug() << url.path(QUrl::FullyEncoded);  // "/tmp/Mambo%20%235%3F.mp3"

Siehe auch setPath().

int QUrl::port(int defaultPort = -1) const

Gibt den Port der URL zurück, oder defaultPort, wenn der Port nicht angegeben ist.

Beispiel:

QTcpSocket sock;
sock.connectToHost(url.host(), url.port(80));

Siehe auch setPort().

QString QUrl::query(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

Gibt den Query-String der URL zurück, wenn ein Query-String vorhanden ist, oder ein leeres Ergebnis, wenn nicht. Um festzustellen, ob die geparste URL eine Abfragezeichenfolge enthält, verwenden Sie hasQuery().

Das Argument options bestimmt, wie die Abfragekomponente formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Beachten Sie, dass von der Verwendung von QUrl::FullyDecoded in Abfragen abgeraten wird, da Abfragen oft Daten enthalten, die prozentual kodiert bleiben sollen, einschließlich der Verwendung der "%2B"-Sequenz zur Darstellung eines Pluszeichens ("+").

Siehe auch setQuery() und hasQuery().

QUrl QUrl::resolved(const QUrl &relative) const

Gibt das Ergebnis der Zusammenführung dieser URL mit relative zurück. Diese URL wird als Basis für die Umwandlung von relative in eine absolute URL verwendet.

Wenn relative keine relative URL ist, gibt diese Funktion direkt relative zurück. Andernfalls werden die Pfade der beiden URLs verschmolzen, und die neue URL, die zurückgegeben wird, hat das Schema und die Autorität der Basis-URL, aber mit dem verschmolzenen Pfad, wie im folgenden Beispiel:

QUrl baseUrl("http://qt.digia.com/Support/");QUrl relativeUrl("../Produkt/Bibliothek/");qDebug(baseUrl.resolved(relativeUrl).toString());
// gibt "http://qt.digia.com/Product/Library/" aus

Der Aufruf von resolved() mit ".." gibt eine QUrl zurück, deren Verzeichnis eine Ebene höher liegt als das Original. In ähnlicher Weise entfernt der Aufruf von resolved() mit "../.." zwei Ebenen aus dem Pfad. Wenn relative "/" ist, wird der Pfad zu "/".

Siehe auch isRelative().

QString QUrl::scheme() const

Gibt das Schema der URL zurück. Wird eine leere Zeichenkette zurückgegeben, bedeutet dies, dass das Schema undefiniert ist und die URL dann relativ ist.

Das Schema kann nur US-ASCII-Buchstaben oder -Ziffern enthalten, d. h. es darf keine Zeichen enthalten, die sonst eine Kodierung erfordern würden. Außerdem werden Schemata immer in Kleinbuchstaben zurückgegeben.

Siehe auch setScheme() und isRelative().

void QUrl::setAuthority(const QString &authority, QUrl::ParsingMode mode = TolerantMode)

Setzt die Autorität der URL auf authority.

Die Autorität einer URL ist die Kombination aus Benutzerinformationen, einem Hostnamen und einem Port. Alle diese Elemente sind optional; eine leere Autorität ist daher gültig.

Die Benutzerangaben und der Host werden durch ein "@", der Host und der Port durch ein ":" voneinander getrennt. Wenn die Benutzerinformation leer ist, muss das '@' weggelassen werden; ein leeres ':' ist jedoch zulässig, wenn der Port leer ist.

Das folgende Beispiel zeigt einen gültigen Autorisierungsstring:

Die Daten von authority werden gemäß mode interpretiert: In StrictMode müssen auf jedes '%'-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode (der Standardeinstellung) werden alle Zeichen in undekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende "%"-Zeichen, denen keine zwei Hexadezimalzeichen folgen.

Mit dieser Funktion kann mode nicht zu QUrl::DecodedMode werden. Um vollständig dekodierte Daten zu setzen, rufen Sie setUserName(), setPassword(), setHost() und setPort() einzeln auf.

Siehe auch authority(), setUserInfo(), setHost(), und setPort().

void QUrl::setFragment(const QString &fragment, QUrl::ParsingMode mode = TolerantMode)

Setzt das Fragment der URL auf fragment. Das Fragment ist der letzte Teil der URL, der durch ein "#" gefolgt von einer Zeichenkette dargestellt wird. Es wird in der Regel in HTTP verwendet, um auf einen bestimmten Link oder Punkt auf einer Seite zu verweisen:

Das Fragment wird manchmal auch als URL-"Referenz" bezeichnet.

Die Übergabe eines QString()-Arguments (eine Null QString) hebt das Fragment auf. Die Übergabe eines Arguments QString("") (ein leeres, aber nicht null QString) setzt das Fragment auf eine leere Zeichenkette (als ob die ursprüngliche URL ein einsames "#" hätte).

Die Daten von fragment werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode werden alle Zeichen in nicht dekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende '%'-Zeichen, auf die nicht zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

QUrl::DecodedMode sollte verwendet werden, wenn das Fragment aus einer Datenquelle gesetzt wird, die keine URL ist, oder mit einem Fragment, das durch den Aufruf von fragment() mit der Formatierungsoption QUrl::FullyDecoded erhalten wurde.

Siehe auch fragment() und hasFragment().

void QUrl::setHost(const QString &host, QUrl::ParsingMode mode = DecodedMode)

Setzt den Host der URL auf host. Der Host ist Teil der Autorität.

Die Daten von host werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode werden alle Zeichen in nicht dekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende '%'-Zeichen, auf die nicht zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

Beachten Sie, dass das Ergebnis des Parsens in jedem Fall ein gültiger Hostname gemäß den STD 3-Regeln in der durch die Internationalized Resource Identifiers-Spezifikation (RFC 3987) geänderten Form sein muss. Ungültige Hostnamen sind nicht zulässig und führen dazu, dass isValid() zu false wird.

Siehe auch host() und setAuthority().

[static] void QUrl::setIdnWhitelist(const QStringList &list)

Setzt die Whitelist der Top-Level-Domains (TLDs), die Nicht-ASCII-Zeichen in Domains enthalten dürfen, auf den Wert von list.

Beachten Sie, dass Sie diese Funktion aufrufen müssen, bevor Sie einen Thread starten, der auf idnWhitelist() zugreifen könnte.

Qt wird mit einer Standardliste geliefert, die die Internet Top-Level-Domains enthält, die Unterstützung für Internationalized Domain Names (IDNs) und Regeln veröffentlicht haben, um zu garantieren, dass keine Täuschung zwischen ähnlich aussehenden Zeichen (wie dem lateinischen Kleinbuchstaben 'a' und dem kyrillischen Äquivalent, die in den meisten Schriftarten visuell identisch sind) stattfinden kann.

Diese Liste wird in regelmäßigen Abständen aktualisiert, wenn die Registrierstellen neue Regeln veröffentlichen.

Diese Funktion wird für diejenigen bereitgestellt, die die Liste manipulieren müssen, um eine TLD hinzuzufügen oder zu entfernen. Es wird nicht empfohlen, den Wert zu anderen Zwecken als zu Testzwecken zu ändern, da dies die Benutzer einem Sicherheitsrisiko aussetzen kann.

Siehe auch idnWhitelist().

void QUrl::setPassword(const QString &password, QUrl::ParsingMode mode = DecodedMode)

Legt das Passwort der URL auf password fest. password ist Teil des User-Info-Elements in der Autorität der URL, wie in setUserInfo() beschrieben.

Die Daten von password werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode werden alle Zeichen in nicht dekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende '%'-Zeichen, auf die nicht zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

QUrl::DecodedMode sollte verwendet werden, wenn das Kennwort aus einer Datenquelle gesetzt wird, die keine URL ist, wie z. B. ein Kennwortdialog, der dem Benutzer angezeigt wird, oder mit einem Kennwort, das durch den Aufruf von password() mit der Formatierungsoption QUrl::FullyDecoded erhalten wurde.

Siehe auch password() und setUserInfo().

void QUrl::setPath(const QString &path, QUrl::ParsingMode mode = DecodedMode)

Setzt den Pfad der URL auf path. Der Pfad ist der Teil der URL, der nach der Autorität, aber vor der Abfragezeichenfolge kommt.

Bei nicht-hierarchischen Schemata ist der Pfad alles, was auf die Schema-Deklaration folgt, wie im folgenden Beispiel:

Die Daten von path werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode werden alle Zeichen in nicht dekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende '%'-Zeichen, auf die nicht zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

QUrl::DecodedMode sollte verwendet werden, wenn der Pfad von einer Datenquelle gesetzt wird, die keine URL ist, wie z. B. ein Dialog, der dem Benutzer angezeigt wird, oder mit einem Pfad, der durch den Aufruf von path() mit der Formatierungsoption QUrl::FullyDecoded erhalten wurde.

Siehe auch path().

void QUrl::setPort(int port)

Setzt den Port der URL auf port. Der Port ist Teil der Autorität der URL, wie in setAuthority() beschrieben.

port muss zwischen 0 und 65535 einschließlich liegen. Wird der Port auf -1 gesetzt, bedeutet dies, dass der Port nicht spezifiziert ist.

Siehe auch port().

void QUrl::setQuery(const QString &query, QUrl::ParsingMode mode = TolerantMode)

Setzt die Abfragezeichenfolge der URL auf query.

Diese Funktion ist nützlich, wenn Sie eine Abfragezeichenfolge übergeben müssen, die nicht in das Schlüssel-Wert-Muster passt oder die ein anderes Schema für die Kodierung von Sonderzeichen verwendet, als von QUrl vorgeschlagen wird.

Die Übergabe eines Wertes von QString() an query (eine Null QString) hebt die Abfrage vollständig auf. Die Übergabe eines Wertes von QString("") setzt die Abfrage jedoch auf einen leeren Wert, als ob die ursprüngliche URL ein einsames "?" hätte.

Die Daten von query werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode werden alle Zeichen in nicht dekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende '%'-Zeichen, auf die nicht zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

Abfragezeichenfolgen enthalten oft prozentual kodierte Sequenzen, daher wird von der Verwendung von DecodedMode abgeraten. Eine spezielle Sequenz, die zu beachten ist, ist das Pluszeichen ("+"). QUrl wandelt Leerzeichen nicht in Pluszeichen um, auch wenn HTML-Formulare, die von Webbrowsern angezeigt werden, dies tun. Um ein tatsächliches Pluszeichen in einer Abfrage darzustellen, wird normalerweise die Sequenz "%2B" verwendet. Diese Funktion lässt "%2B"-Sequenzen in TolerantMode oder StrictMode unangetastet.

Siehe auch query() und hasQuery().

void QUrl::setQuery(const QUrlQuery &query)

Dies ist eine überladene Funktion.

Setzt den Query-String der URL auf query.

Diese Funktion rekonstruiert die Abfragezeichenfolge aus dem Objekt QUrlQuery und setzt sie auf dieses Objekt QUrl. Diese Funktion hat keine Parsing-Parameter, da die QUrlQuery Daten enthält, die bereits geparst wurden.

Siehe auch query() und hasQuery().

void QUrl::setScheme(const QString &scheme)

Setzt das Schema der URL auf scheme. Da ein Schema nur ASCII-Zeichen enthalten kann, wird bei der Eingabe keine Konvertierung oder Dekodierung vorgenommen. Außerdem muss es mit einem ASCII-Buchstaben beginnen.

Das Schema beschreibt den Typ (oder das Protokoll) der URL. Es wird durch ein oder mehrere ASCII-Zeichen am Anfang der URL dargestellt.

Ein Schema ist streng RFC 3986-konform: scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )

Das folgende Beispiel zeigt eine URL, bei der das Schema "ftp" lautet:

Um das Schema festzulegen, wird der folgende Aufruf verwendet:

    QUrl url;
    url.setScheme("ftp");

Das Schema kann auch leer sein, in diesem Fall wird die URL als relativ interpretiert.

Siehe auch scheme() und isRelative().

void QUrl::setUrl(const QString &url, QUrl::ParsingMode parsingMode = TolerantMode)

Parst url und setzt dieses Objekt auf diesen Wert. QUrl kodiert automatisch alle Zeichen, die in einer URL nicht erlaubt sind, und dekodiert die prozentual kodierten Sequenzen, die ein nicht reserviertes Zeichen darstellen (Buchstaben, Ziffern, Bindestriche, Unterstriche, Punkte und Tilden). Alle anderen Zeichen werden in ihrer ursprünglichen Form belassen.

Parst die url unter Verwendung des Parsermodus parsingMode. In TolerantMode (der Standardeinstellung) korrigiert QUrl bestimmte Fehler, insbesondere das Vorhandensein eines Prozentzeichens ("%"), dem keine zwei hexadezimalen Ziffern folgen, und akzeptiert jedes Zeichen an jeder Position. In StrictMode werden Kodierungsfehler nicht toleriert, und QUrl prüft auch, ob bestimmte verbotene Zeichen nicht in nicht kodierter Form vorhanden sind. Wenn in StrictMode ein Fehler festgestellt wird, gibt isValid() false zurück. Der Parsing-Modus DecodedMode ist in diesem Zusammenhang nicht zulässig und führt zu einer Laufzeitwarnung.

Siehe auch url() und toString().

void QUrl::setUserInfo(const QString &userInfo, QUrl::ParsingMode mode = TolerantMode)

Setzt die Benutzerinformation der URL auf userInfo. Die Benutzerinformation ist ein optionaler Teil der Autorität der URL, wie in setAuthority() beschrieben.

Die Benutzerinfo besteht aus einem Benutzernamen und optional einem Passwort, getrennt durch ein ':'. Wenn das Kennwort leer ist, muss der Doppelpunkt weggelassen werden. Das folgende Beispiel zeigt einen gültigen Benutzerinformationsstring:

Die Daten von userInfo werden gemäß mode interpretiert: In StrictMode müssen auf jedes '%'-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode (der Standardeinstellung) werden alle Zeichen in undekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende "%"-Zeichen, denen keine zwei Hexadezimalzeichen folgen.

Mit dieser Funktion kann mode nicht zu QUrl::DecodedMode werden. Um vollständig dekodierte Daten zu setzen, rufen Sie setUserName() und setPassword() einzeln auf.

Siehe auch userInfo(), setUserName(), setPassword(), und setAuthority().

void QUrl::setUserName(const QString &userName, QUrl::ParsingMode mode = DecodedMode)

Setzt den Benutzernamen der URL auf userName. userName ist Teil des Benutzerinformations-Elements in der Autorität der URL, wie in setUserInfo() beschrieben.

Die Daten von userName werden gemäß mode interpretiert: In StrictMode müssen auf jedes "%"-Zeichen genau zwei hexadezimale Zeichen folgen, und einige Zeichen (einschließlich Leerzeichen) sind in undecodierter Form nicht zulässig. In TolerantMode (der Standardeinstellung) werden alle Zeichen in undekodierter Form akzeptiert, und der tolerante Parser korrigiert fehlende "%"-Zeichen, denen keine zwei Hexadezimalzeichen folgen. In DecodedMode steht '%' für sich selbst und kodierte Zeichen sind nicht möglich.

QUrl::DecodedMode sollte verwendet werden, wenn der Benutzername aus einer Datenquelle gesetzt wird, die keine URL ist, z. B. aus einem Passwort-Dialog, der dem Benutzer angezeigt wird, oder mit einem Benutzernamen, der durch den Aufruf von userName() mit der Formatierungsoption QUrl::FullyDecoded erhalten wurde.

Siehe auch userName() und setUserInfo().

[noexcept] void QUrl::swap(QUrl &other)

Tauscht diese URL mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

[static, since 6.3] QByteArray QUrl::toAce(const QString &domain, QUrl::AceProcessingOptions options = {})

Gibt die ASCII-kompatible Kodierung des angegebenen Domainnamens domain zurück. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden. Das Ergebnis dieser Funktion ist äquivalent zu domain.

Die ASCII-kompatible Kodierung (ACE) wird durch RFC 3490, RFC 3491 und RFC 3492 definiert und durch den Unicode Technical Standard #46 aktualisiert. Sie ist Teil der IDNA-Spezifikation (Internationalizing Domain Names in Applications), die es ermöglicht, Domain-Namen (wie "example.com") mit Nicht-US-ASCII-Zeichen zu schreiben.

Diese Funktion gibt ein leeres QByteArray zurück, wenn domain kein gültiger Hostname ist. Beachten Sie insbesondere, dass IPv6-Literale keine gültigen Domainnamen sind.

Diese Funktion wurde in Qt 6.3 eingeführt.

CFURLRef QUrl::toCFURL() const

Erzeugt eine CFURL aus einer QUrl.

Der Aufrufer ist Eigentümer der CFURL und verantwortlich für deren Freigabe.

QString QUrl::toDisplayString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

Gibt eine anzeigbare String-Darstellung der URL zurück. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden. Die Option RemovePassword ist immer aktiviert, da Passwörter niemals an Benutzer zurückgegeben werden sollten.

Mit den Standardoptionen kann die resultierende QString zu einem späteren Zeitpunkt an QUrl zurückgegeben werden, wobei jedoch jedes ursprünglich vorhandene Kennwort verloren geht.

Siehe auch FormattingOptions, toEncoded(), und toString().

QByteArray QUrl::toEncoded(QUrl::FormattingOptions options = FullyEncoded) const

Gibt die kodierte Darstellung der URL zurück, wenn sie gültig ist; andernfalls wird ein leeres QByteArray zurückgegeben. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden.

Die Benutzerinformationen, der Pfad und das Fragment werden alle in UTF-8 konvertiert, und alle Nicht-ASCII-Zeichen werden dann in Prozent kodiert. Der Hostname wird mit Punycode kodiert.

QString QUrl::toLocalFile() const

Gibt den Pfad dieser URL als lokalen Dateipfad formatiert zurück. Der zurückgegebene Pfad verwendet Schrägstriche, auch wenn er ursprünglich aus einem Pfad mit Backslashes erstellt wurde.

Wenn diese URL einen nicht leeren Hostnamen enthält, wird dieser im zurückgegebenen Wert in der in SMB-Netzwerken üblichen Form kodiert (z. B. "//servername/path/to/file.txt").

   qDebug()<< QUrl("file:file.txt").toLocalFile(); // "file.txt"    qDebug() << QUrl("file:/home/user/file.txt").toLocalFile(); // "/home/user/file.txt"
    qDebug() << QUrl("file.txt").toLocalFile();                 // ""; wasn't a local file as it had no scheme

Hinweis: Wenn die Pfadkomponente dieser URL eine nicht-UTF-8-Binärsequenz enthält (z. B. %80), ist das Verhalten dieser Funktion undefiniert.

Siehe auch fromLocalFile() und isLocalFile().

NSURL *QUrl::toNSURL() const

Erzeugt eine NSURL aus einer QUrl.

Die NSURL wird automatisch wieder freigegeben.

[static] QByteArray QUrl::toPercentEncoding(const QString &input, const QByteArray &exclude = QByteArray(), const QByteArray &include = QByteArray())

Gibt eine kodierte Kopie von input zurück. input wird zunächst in UTF-8 konvertiert, und alle ASCII-Zeichen, die nicht in der nicht reservierten Gruppe sind, werden prozentual kodiert. Um zu verhindern, dass Zeichen prozentual kodiert werden, übergeben Sie sie an exclude. Um zu erzwingen, dass Zeichen prozentual kodiert werden, übergeben Sie sie an include.

Unreserviert ist definiert als: ALPHA / DIGIT / "-" / "." / "_" / "~"

QByteArray ba = QUrl::toPercentEncoding("{ein fischiger String?}", "{}", "s");qDebug(ba.constData());
// druckt "{a fi%73hy %73tring%3F}"

QString QUrl::toString(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

Gibt eine String-Darstellung der URL zurück. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden. Die Option QUrl::FullyDecoded ist in dieser Funktion nicht zulässig, da sie mehrdeutige Daten erzeugen würde.

Die Standardformatierungsoption ist PrettyDecoded.

Siehe auch FormattingOptions, url(), und setUrl().

[static] QStringList QUrl::toStringList(const QList<QUrl> &urls, QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded))

Konvertiert eine Liste von urls in eine Liste von QString Objekten, unter Verwendung von toString(options).

QString QUrl::url(QUrl::FormattingOptions options = FormattingOptions(PrettyDecoded)) const

Gibt eine String-Darstellung der URL zurück. Die Ausgabe kann durch Übergabe von Flags mit options angepasst werden. Die Option QUrl::FullyDecoded ist in dieser Funktion nicht zulässig, da sie mehrdeutige Daten erzeugen würde.

Die resultierende QString kann später an eine QUrl zurückgegeben werden.

Synonym für toString(Optionen).

Siehe auch setUrl(), FormattingOptions, toEncoded(), und toString().

QString QUrl::userInfo(QUrl::ComponentFormattingOptions options = PrettyDecoded) const

Gibt die Benutzerinformation der URL zurück, oder eine leere Zeichenkette, wenn die Benutzerinformation nicht definiert ist.

Diese Funktion gibt einen eindeutigen Wert zurück, der die Zeichen enthalten kann, die noch prozentual kodiert sind, sowie einige Steuersequenzen, die in QString nicht in dekodierter Form dargestellt werden können.

Das Argument options steuert, wie die Benutzerinfokomponente formatiert werden soll. Der Wert von QUrl::FullyDecoded ist in dieser Funktion nicht zulässig. Wenn Sie vollständig dekodierte Daten benötigen, rufen Sie userName() und password() einzeln auf.

Siehe auch setUserInfo(), userName(), password(), und authority().

QString QUrl::userName(QUrl::ComponentFormattingOptions options = FullyDecoded) const

Gibt den Benutzernamen der URL zurück, wenn er definiert ist; andernfalls wird eine leere Zeichenfolge zurückgegeben.

Das Argument options steuert, wie die Komponente Benutzername formatiert werden soll. Alle Werte ergeben ein eindeutiges Ergebnis. Mit QUrl::FullyDecoded werden alle prozentual kodierten Sequenzen dekodiert; andernfalls kann der zurückgegebene Wert einige prozentual kodierte Sequenzen für einige Steuersequenzen enthalten, die nicht in dekodierter Form in QString dargestellt werden können.

Beachten Sie, dass QUrl::FullyDecoded zu Datenverlusten führen kann, wenn diese nicht darstellbaren Sequenzen vorhanden sind. Es wird empfohlen, diesen Wert zu verwenden, wenn das Ergebnis in einem Nicht-URL-Kontext verwendet wird, z. B. bei der Einstellung in QAuthenticator oder bei der Aushandlung eines Logins.

Siehe auch setUserName() und userInfo().

[noexcept] QUrl &QUrl::operator=(QUrl &&other)

Verschieben - weist other dieser QUrl Instanz zu.

QUrl &QUrl::operator=(const QString &url)

Weist diesem Objekt die angegebene url zu.

[noexcept] QUrl &QUrl::operator=(const QUrl &url)

Weist diesem Objekt die angegebene url zu.