QUrl Class

メンバ関数ドキュメント

QUrl::QUrl()

空の QUrl オブジェクトを構築します。

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

url を解析してURLを構築する。このコンストラクタは適切なURLまたはURL-Referenceを期待し、意図を推測しようとしないことに注意。例えば、次のように宣言します：

QUrl url("example.com");

有効なURLは構築されるが、入力のscheme()の部分が欠落しているため、期待するものとは異なる可能性がある。上記のような文字列の場合、アプリケーションはfromUserInput() を使用する。このコンストラクタやsetUrl （）については、おそらく次のようなものが意図されたものでしょう：

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

QUrlは、URLで許可されていないすべての文字を自動的にパーセントエンコードし、予約されていない文字（文字、数字、ハイフン、アンダースコア、ドット、チルダ）を表すパーセントエンコードされたシーケンスをデコードします。それ以外の文字はそのままの形で残す。

パーサーモードparsingMode を使ってurl を解析する。TolerantMode (デフォルト)では、QUrlは特定の間違い、特に16進数2桁が続かないパーセント文字('%')の存在を修正します。StrictMode では、エンコードの間違いは許されず、QUrlはある種の禁じられた文字がエンコードされていない形で存在しないこともチェックします。StrictMode でエラーが検出された場合、isValid() は偽を返す。構文解析モードDecodedMode は、このコンテキストでは許可されません。

例

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

エンコードされた文字列から URL を作成するには、fromEncoded() を使用することもできる：

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

Qt 5 では、どちらの関数もエンコードされたデータを受け入れます。通常、QUrl コンストラクタやsetUrl() とfromEncoded() の選択は、ソース・データによって異なります。コンストラクタやsetUrl() はQString を受け取りますが、fromEncoded はQByteArray を受け取ります。

setUrl()、fromEncoded()、TolerantModeも参照して ください。

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

other のコピーを作成する。

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

Move-QUrlインスタンスを構築し、other が指していたのと同じオブジェクトを指すようにする。

[noexcept] QUrl::~QUrl()

オブジェクトが削除される直前に呼び出される。

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

URLの調整バージョンを返す。options でフラグを渡すことで、出力をカスタマイズできる。

QUrl::ComponentFormattingOption のエンコーディングオプションは、このメソッドではあまり意味をなさない。QUrl::PreferLocalFile も同様である。

これは常にQUrl(url.toString(オプション)) と等価です。

FormattingOptions 、toEncoded()、toString()も参照して ください。

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

URLの権威が定義されていればそれを返し、そうでなければ空文字列を返す。

この関数は、パーセントエンコードされたままの文字に加え、QString でデコードされた形では表現できないいくつかの制御シーケンスを含む可能性のある、曖昧性のない値を返します。

引数options は、ユーザー情報コンポーネントの書式を制御する。この関数では、QUrl::FullyDecoded の値は許されない。完全にデコードされたデータを取得する必要がある場合は、userName()、password()、host()、port() を個別に呼び出す。

setAuthority()、userInfo()、userName()、password()、host()、port()も参照の こと。

void QUrl::clear()

QUrlこの関数を呼び出した後、QUrl はデフォルトの空のコンストラクタで構築されたものと等しくなります。

isEmpty()も参照 。

QString QUrl::errorString() const

このQUrl オブジェクトを最後に変更した操作で解析エラーが発生した場合、エラーメッセージを返す。エラーが検出されなかった場合、この関数は空の文字列を返し、isValid() はtrue を返す。

この関数が返すエラー・メッセージは技術的なものであり、エンド・ユーザーには理解できないかもしれません。これは、QUrl がある入力を受け入れない理由を理解しようとする開発者に役立つことがほとんどである。

QUrl::ParsingModeも参照のこと 。

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

ディレクトリパスを除いたファイル名を返す。

このQUrl オブジェクトにスラッシュで終わるパスが与えられた場合、ファイル名は空であるとみなされることに注意してください。

パスにスラッシュが含まれていない場合は、fileNameとして完全に返されます。

例

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

options 引数は、ファイル名コンポーネントの書式を制御します。すべての値は、あいまいでない結果を生成します。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形式では表現できない制御シーケンスのパーセントエンコードされたシーケンスが含まれる可能性がある。

path()も参照のこと 。

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

URLのフラグメントを返す。解析されたURLにフラグメントが含まれているかどうかを調べるには、hasFragment （）を使用する。

options 引数は、フラグメント・コンポーネントのフォーマット方法を制御します。すべての値は、曖昧さのない結果を生成します。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形式で表現できない制御シーケンスに対するパーセントエンコードされた シーケンスが含まれる可能性がある。

これらの表現不可能な配列が存在する場合、QUrl::FullyDecoded はデータロスを引き起こす可能性があることに注意。結果を非URLコンテキストで使用する場合は、この値を使用することを推奨する。

setFragment() およびhasFragment()も参照のこと 。

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

ASCII Compatible Encoding (ACE) でエンコードされた、与えられたドメイン名domain の Unicode 形式を返します。options でフラグを渡すことで、出力をカスタマイズすることができます。この関数の結果はdomain と等価とみなされる。

domain の値がエンコードできない場合は、QString に変換されて返されます。

ASCII-Compatible Encoding (ACE)は、RFC 3490、RFC 3491、RFC 3492で定義され、Unicode Technical Standard #46で更新されています。これはIDNA（Internationalizing Domain Names in Applications）仕様の一部であり、ドメイン名（"example.com" など）を非US-ASCII文字で記述できるようにするものです。

この関数は Qt 6.3 で導入されました。

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

CFURLurl のコピーを含むQUrl を構築する。

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

input を解析し、対応するQUrl を返す。input は、ASCII文字のみを含むエンコード形式であると仮定される。

mode を使用して URL を解析する。このパラメータの詳細については、setUrl() を参照してください。QUrl::DecodedMode は、このコンテキストでは許可されていません。

toEncoded() およびsetUrl()も参照してください 。

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

ローカルファイルとして解釈されるlocalFile のQUrl 表現を返す。この関数は、スラッシュで区切られたパスと、このプラットフォームのネイティブなセパレータを受け付ける。

この関数は、"//servername/path/to/file.txt" のように、リモート・ファイルを示すスラッシュ（またはバックスラッシュ）を先頭に2つ付けたパスも受け付ける。なお、QFile::open （）を使ってこのファイルを実際に開くことができるのは、特定のプラットフォームだけである。

空のlocalFile は空の URL になります（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

上のスニペットの1行目では、ファイルURLはローカルの相対パスから構築されている。相対パスによるファイルURLは、それを解決するベースURLがある場合にのみ意味を持ちます。例えば

    QUrlurl=QUrl::fromLocalFile("file.txt")；    QUrlbaseUrl=QUrl("file:/home/user/");// 誤り：QUrl("file:file.txt")を出力する。    qDebug() << baseUrl.resolved(url);

このようなURLを解決するには、事前にスキームを削除する必要がある：

   // 正解：QUrl("file:///home/user/file.txt")を表示するurl.setScheme(QString());    qDebug() << baseUrl.resolved(url);

このため、相対ファイルパスには相対URL（つまりスキームなし）を使う方がよい：

    QUrlurl=QUrl("file.txt")；    QUrlbaseUrl=QUrl("file:/home/user/");// QUrl("file:///home/user/file.txt")を表示します。    qDebug() << baseUrl.resolved(url);

toLocalFile （）、isLocalFile （）、QDir::toNativeSeparators （）も参照のこと 。

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

NSURLurl のコピーを含むQUrl を構築する。

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

input input はまずパーセントエンコーディングからデコードされ、次に UTF-8 からユニコードに変換される。

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

urls を表す文字列のリストを、QUrl(str,mode) を使って URL のリストに変換する。これは、すべての文字列が、例えばローカルパスではなく、URLでなければならないことを意味することに注意してください。

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

ユーザが指定したuserInput 文字列から、有効な URL が推測できる場合、その URL を返す。それが不可能な場合は、無効なQUrl() が返される。

これにより、ユーザはURLやローカルファイルのパスをプレーンな文字列の形で入力することができる。この文字列は、手動でロケーションバーに入力することも、クリップボードから取得することも、コマンドライン引数で渡すこともできる。

文字列がまだ有効なURLでない場合、さまざまな仮定を立てて最善の推測が実行される。

文字列がシステム上の有効なファイルパスに対応する場合、QUrl::fromLocalFile()を使用して、file:// URLが構築される。

そうでない場合、文字列をhttp:// またはftp:// URLに変換しようと試みる。文字列が'ftp'で始まっている場合は、後者である。その結果は、QUrl'のトレラント・パーサーに渡され、成功した場合は有効なQUrl が返され、そうでない場合はQUrl() が返される。

例

• qt-project.org は http://qt-project.org となる。
• ftp.qt-project.org は ftp://ftp.qt-project.org になります。
• ホスト名は http://hostname になります。
• /home/user/test.html は file:///home/user/test.html になります。

相対パスを扱えるようにするため、このメソッドはオプションでworkingDirectory 。これは、コマンドライン引数を扱うときに特に便利です。workingDirectory が空の場合、相対パスの処理は行われない。

デフォルトでは、相対パスのように見える入力文字列は、指定された作業ディレクトリにファイルが実際に存在する場合にのみ相対パスとして扱われます。アプリケーションがまだ存在しないファイルを処理できる場合は、options でフラグAssumeLocalFile を渡すべきである。

bool QUrl::hasFragment() const

このURLにフラグメントが含まれている場合（つまり#が表示されている場合）、true を返す。

fragment() およびsetFragment()も参照 。

bool QUrl::hasQuery() const

このURLにQueryが含まれている場合（つまり、?が表示されている場合）、true を返す。

setQuery()、query()、hasFragment()も参照 。

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

URLのホストが定義されていればそれを返し、そうでなければ空文字列を返す。

options 引数は、ホスト名がどのようにフォーマットされるかを制御します。QUrl::EncodeUnicode オプションを指定すると、この関数はホスト名を ASCII-Compatible Encoding (ACE) 形式で返します。これは、8ビットクリーンでないチャネルや、レガシーなホスト名を必要とするチャネル (DNSリクエストやHTTPリクエストヘッダなど) での使用に適しています。このフラグがない場合、この関数は、許容されるトップレベルドメインのリスト (idnWhitelist() を参照) に従って、Unicode 形式の国際ドメイン名 (IDN) を返す。

その他のフラグはすべて無視されます。ホスト名に制御文字やパーセント文字を含めることはできないので、返される値は完全にデコードされたものとみなすことができる。

setHost()、idnWhitelist()、setIdnWhitelist()、authority()も参照のこと 。

[static] QStringList QUrl::idnWhitelist()

非ASCII文字の使用が許可されているトップレベルドメインの現在のホワイトリストを返します。

このリストの根拠についてはsetIdnWhitelist() を参照のこと。

setIdnWhitelist() およびAceProcessingOptionも参照 。

bool QUrl::isEmpty() const

URLにデータがない場合はtrue を返し、そうでない場合はfalse を返す。

clear()も参照のこと 。

bool QUrl::isLocalFile() const

このURLがローカルファイルパスを指している場合、true を返す。スキームが "file "の場合、URLはローカルファイルパスである。

QFile::openこの関数は、ホスト名を持つ URL をローカル・ファイル・パスとみなす。

fromLocalFile() およびtoLocalFile()も参照の こと。

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

この URL がchildUrl の親である場合、true を返す。2 つの URL が同じスキームと権限を共有し、この URL のパスがchildUrl のパスの親である場合、childUrl はこの URL の子である。

bool QUrl::isRelative() const

URLが相対参照である場合はtrue を返し、そうでない場合はfalse を返す。スキームが未定義の場合、URLは相対参照である。したがって、この関数はscheme()を呼び出すのと等価である。isEmpty()。

相対参照はRFC 3986セクション4.2で定義されている。

Relative URLs vs Relative Pathsも参照のこと。

bool QUrl::isValid() const

URL が空でなく有効な場合はtrue を返し、そうでない場合はfalse を返す。

URLは適合性テストにかけられる。URLが有効であると報告されるためには、URLのすべての部分がURI標準の標準エンコーディング規則に適合していなければならない。

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

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

このURLと与えられたurl が、両方にoptions を適用した後で等しい場合、true を返す。そうでない場合は、false を返す。

これは、両方のURLに対してadjusted(options)を呼び出して、その結果のURLを比較するのと同じですが、より高速です。

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

URLのパスワードが定義されていればそれを返し、そうでなければ空文字列を返す。

options 引数は、ユーザー名コンポーネントの書式を制御します。すべての値は曖昧さのない結果を生成する。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形で表現できないいくつかの制御シーケンスに対するパーセントエンコードされたシーケンスが含まれる可能性がある。

これらの表現不可能な配列が存在する場合、QUrl::FullyDecoded はデータ損失を引き起こす可能性があることに注意。QAuthenticator での設定やログインのネゴシエーションなど、結果が URL ではないコンテキストで使用される場合は、その値を使用することを推奨する。

setPassword()も参照のこと 。

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

URLのパスを返します。

   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"

options 引数は、パス・コンポーネントの書式を制御する。すべての値は、曖昧さのない結果を生成する。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形で表現できない制御シーケンスに対するパーセントエンコードされたシーケンスが含まれる可能性がある。

これらの表現不可能な配列が存在する場合、QUrl::FullyDecoded はデータロスを引き起こす可能性があることに注意。FTPサーバーへの送信など、結果を非URLコンテキストで使用する場合は、この値を使用することを推奨する。

データ損失の例としては、非Unicodeパーセントエンコードシーケンスがあり、FullyDecoded （デフォルト）を使用する場合です：

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

この例では、%FF を変換できないため、ある程度のデータ損失があります。

この例では、+ が変換できないため、ある程度のデータロスが発生します。また、パスにサブデリミタ（ など）が含まれている場合にも、データロスが発生する可能性があります：

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

その他のデコード例：

    その他のデコード例 QUrlurl("/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"

setPath()も参照のこと 。

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

URL のポートを返し、ポートが指定されていない場合はdefaultPort を返します。

例

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

setPort()も参照のこと 。

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

クエリ文字列があればそのURLのクエリ文字列を返し、なければ空の結果を返す。解析されたURLにクエリー文字列が含まれているかどうかを調べるには、hasQuery()を使用します。

options 引数は、クエリーコンポーネントの書式を制御します。すべての値は、曖昧さのない結果を生成します。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形では表現できない制御シーケンスに対するパーセントエンコードされたシーケンスが含まれる可能性がある。

クエリでは、プラス文字('+')を表現するための"%2B "シーケンスの使用など、パーセントエンコードされたままであることが想定されるデータが含まれることが多いため、クエリでのQUrl::FullyDecoded の使用は推奨されないことに注意してください。

setQuery() およびhasQuery()も参照の こと。

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

この URL をrelative とマージした結果を返す。このURLは、relative を絶対URLに変換するベースとして使用される。

relative が相対 URL でない場合、この関数はrelative を直接返す。そうでない場合は、2つのURLのパスがマージされ、以下の例のように、ベースURLのスキームとオーソリティを持ち、マージされたパスを持つ新しいURLが返されます：

QUrlbaseUrl("http://qt.digia.com/Support/")；QUrlrelativeUrl("../Product/Library/")；qDebug(baseUrl.resolved(relativeUrl).toString());
// "http://qt.digia.com/Product/Library/"

resolved()に"... "を付けて呼び出すと、元のディレクトリより1レベル高いQUrl が返される。同様に、"../... "を指定してresolved()を呼び出すと、パスから2レベルが削除される。relative が"/"の場合、パスは"/"になる。

isRelative()も参照のこと 。

QString QUrl::scheme() const

URLのスキームを返す。空の文字列が返された場合は、スキームが未定義であることを意味し、URL は相対 URL となります。

スキームにはUS-ASCII文字か数字しか含めることができません。つまり、エンコードが必要な文字は一切含めることができません。さらに、スキームは常に小文字で返されます。

setScheme() およびisRelative()も参照 。

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

URL のオーソリティをauthority に設定する。

URLのauthorityは、ユーザー情報、ホスト名、ポートの組み合わせである。これらの要素はすべてオプションです。したがって、空のオーソリティも有効です。

ユーザ情報とホストは「@」で区切られ、ホストとポートは「:」で区切られます。ユーザー情報が空の場合、'@'は省略しなければなりません。

次の例は、有効な権限文字列を示しています：

authority のデータはmode に従って解釈されます:StrictMode では、'%'文字の後には正確に2つの16進文字が続かなければならず、いくつかの文字(スペースを含む)はデコードされていない形式では許可されません。TolerantMode (デフォルト) では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷 '%' を修正する。

この関数では、mode をQUrl::DecodedMode にすることはできない。完全にデコードされたデータを設定するには、setUserName()、setPassword()、setHost()、setPort() を個別に呼び出す。

authority()、setUserInfo()、setHost()、setPort()も参照のこと 。

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

URLのフラグメントをfragment に設定する。 フラグメントはURLの最後の部分で、'#'に続く文字列で表される。通常HTTPでは、ページ上の特定のリンクやポイントを参照するために使われます：

フラグメントはURLの "参照 "と呼ばれることもあります。

QString()の引数(NULLQString)を渡すと、フラグメントの設定が解除されます。QString("") (空だがNULLではないQString) を引数に渡すと、フラグメントは空の文字列に設定される (あたかも元のURLに "#" があるかのように)。

fragment のデータは、mode に従って解釈される。StrictMode では、'%'文字の後には、16進数で正確に2つの文字が続かなければな らず、いくつかの文字(スペースを含む)は、デコードされていない形では許可されな い。TolerantMode では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷子の'%'を修正する。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使えない。

QUrl::DecodedMode は、URLではないデータソースからフラグメントを設定する場合や、 書式オプションを指定して () を呼び出して取得したフラグメントを設定する場合に使用する必要があります。QUrl::FullyDecoded fragment

fragment() およびhasFragment()も参照のこと 。

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

URL のホストをhost に設定する。 ホストは権限の一部である。

host のデータはmode に従って解釈される:StrictMode では、'%'文字の後には正確に2つの16進数文字が続かなければならず、いくつかの文字(スペースを含む)はデコードされていない形式では許可されない。TolerantMode では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷子の'%'を修正する。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使えない。

すべての場合において、構文解析の結果は、国際化資源識別子仕様(Internationalized Resource Identifiers specification) (RFC 3987)によって修正されたSTD 3の規則に従って、有効なホスト名でなければならないことに注意すること。無効なホスト名は許可されず、isValid()が偽になる。

host() およびsetAuthority()も参照 。

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

ドメインに非ASCII文字を使用できるトップレベルドメイン（TLD）のホワイトリストをlist の値に設定する。

この関数を呼び出す場合は、idnWhitelist() にアクセスする可能性のあるスレッドを開始する前に行う必要があることに注意してください。

Qt には、国際化ドメイン名（IDN）のサポートを公表しているインターネットトップレベルドメインと、見た目が似ている文字（ラテン文字の小文字'a' とキリル文字の等価文字など、ほとんどのフォントでは見た目が同じ）の間で誤認が起こらないことを保証するルールを含むデフォルトのリストが用意されています。

このリストは、登録機関が新しい規則を公表するのに合わせて、定期的に保守されます。

この機能は、TLDを追加または削除するためにリストを操作する必要がある人のために提供されます。テスト以外の目的でこの値を変更することは、ユーザーをセキュリティリスクにさらす可能性があるため推奨されません。

idnWhitelist()も参照 。

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

URLのパスワードをpassword に設定する。password は、setUserInfo() で説明されているように、URLのオーソリティ内のユーザー情報要素の一部である。

password のデータはmode に従って解釈されます。StrictMode では、'%'文字の後にちょうど2つの16進数文字が続く必要があり、一部の文字(スペースを含む)は復号化されていない形式では許可されません。TolerantMode では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷子の'%'を修正する。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使用できない。

QUrl::DecodedMode は、ユーザに表示されるパスワードダイアログや、 フォーマットオプション付きで () を呼び出して取得したパスワードなど、URL ではないデータソースからパスワードを設定する場合に使用する必要があります。QUrl::FullyDecoded password

password() およびsetUserInfo()も参照の こと。

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

URL のパスをpath に設定します。 パスは URL のうち、オーソリティの後でクエリ文字列の前に来る部分です。

階層化されていないスキームの場合、パスは以下の例のようにスキーム宣言に続く全てになります：

path のデータは、mode に従って解釈されます。StrictMode では、'%'文字の後にちょうど2つの16進数文字が続く必要があり、いくつかの文字（スペースを含む）はデコードされていない状態では許可されません。TolerantMode では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷子の'%'を修正する。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使えない。

QUrl::DecodedMode は、ユーザーに表示されるダイアログや、 フォーマット・オプションを指定して () を呼び出して取得したパスなど、URL ではないデータ・ソースからパスを設定する場合に使用する必要があります。QUrl::FullyDecoded path

path()も参照 。

void QUrl::setPort(int port)

URL のポートをport に設定する。 ポートは、setAuthority() で説明されているように、URL の権限の一部である。

port は 0 から 65535 の間でなければならない。ポートを-1に設定すると、ポートが指定されていないことを示す。

port()も参照 。

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

URL のクエリー文字列をquery に設定する。

この関数は、key-valueパターンに収まらないクエリ文字列を渡す必要がある場合や、QUrl で提案されているものとは異なるスキームで特殊文字をエンコードする場合に便利です。

query に QString() の値（NULLQString ）を渡すと、クエリは完全にアンセットされます。しかし、QString （""）の値を渡すと、元のURLに"? "があるかのように、クエリが空の値に設定されます。

query のデータは、mode に従って解釈される。StrictMode では、'%'文字の後に16進数で正確に2文字続く必要があり、いくつかの文字 （スペースを含む）は、デコードされていない状態では許可されない。TolerantMode では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷子の'%'を修正する。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使用できません。

クエリー文字列はパーセントエンコードされたシーケンスを含むことが多いので、DecodedMode の使用は推奨されません。注意すべき特殊なシーケンスとして、プラス文字（'+'）があります。QUrl 、ウェブブラウザが投稿するHTMLフォームではプラス文字に変換されますが、スペースはプラス文字に変換されません。実際のプラス文字をクエリーで表現するには、通常"%2B "というシーケンスが使われます。この関数は、"%2B "シーケンスはTolerantMode やStrictMode ではそのままにする。

query() およびhasQuery()も参照のこと 。

void QUrl::setQuery(const QUrlQuery &query)

これはオーバーロードされた関数である。

URL のクエリ文字列をquery に設定する。

この関数はQUrlQuery オブジェクトからクエリ文字列を再構築し、このQUrl オブジェクトに設定します。QUrlQuery にはすでに解析済みのデータが含まれているため、この関数には解析パラメータはありません。

query() およびhasQuery()も参照 。

void QUrl::setScheme(const QString &scheme)

URL のスキームをscheme に設定します。スキームにはASCII文字しか含めることができないため、入力の変換やデコードは行われません。また、ASCII文字で始まる必要があります。

スキームはURLのタイプ（またはプロトコル）を記述します。これはURLの先頭にある1つ以上のASCII文字で表されます。

スキームは厳密にRFC 3986に準拠しています：scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )

次の例は、スキームが「ftp」であるURLを示している：

スキームを設定するには、以下の呼び出しを使用します：

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

この場合、URLは相対 URLとして解釈される。

scheme() およびisRelative()も参照の こと。

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

url をパースし、このオブジェクトにその値をセットする。QUrl は、URLで許可されていないすべての文字を自動的にパーセントエンコードし、予約されていない文字（文字、数字、ハイフン、アンダースコア、ドット、チルダ）を表すパーセントエンコードされたシーケンスをデコードする。それ以外の文字はそのままの形で残す。

パーサーモードparsingMode を使ってurl を解析する。TolerantMode (デフォルト) では、QUrl は特定の間違い、特にパーセント文字 ('%') の後に 2 桁の 16 進数字が続かないような間違いを修正します。StrictMode では、エンコードの間違いは許されず、QUrl では、ある種の禁じられた文字がエンコードされていない形で存在しないこともチェックする。StrictMode でエラーが検出されると、isValid() は偽を返す。構文解析モードDecodedMode は、このコンテキストでは許可されず、実行時に警告が表示される。

url() およびtoString()も参照 。

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

URL のユーザー情報をuserInfo に設定する。 ユーザー情報は、setAuthority() で説明されているように、URL のオーソリティのオプション部分である。

ユーザ情報は、':'で区切られたユーザ名と、オプションでパスワードから構成される。パスワードが空の場合、コロンは省略しなければなりません。以下の例は、有効なユーザー情報文字列を示している：

userInfo のデータは、mode に従って解釈される。StrictMode では、'%'文字の後に16進数で正確に2文字続く必要があり、一部の文字（スペース を含む）はデコードされていない形式では許可されない。TolerantMode (デフォルト) では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない迷 '%' を修正する。

この関数では、mode をQUrl::DecodedMode にすることはできない。完全にデコードされたデータを設定するには、setUserName() とsetPassword() を個別に呼び出す。

userInfo()、setUserName()、setPassword()、setAuthority()も参照のこと 。

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

URL のユーザー名をuserName に設定します。userName は、setUserInfo() で説明されているように、URL のオーソリティ内のユーザー情報要素の一部です。

userName のデータはmode に従って解釈されます。StrictMode では、'%'文字の後にちょうど2つの16進数文字が続く必要があり、いくつかの文字（スペースを含む）はデコードされていない状態では許可されません。TolerantMode (デフォルト) では、すべての文字がデコードされない形で受け入れられ、寛容なパーサーは、2つの16進文字が続かない、迷子の'%'を修正します。DecodedMode では、'%'はそれ自身を表し、エンコードされた文字は使えない。

QUrl::DecodedMode は、ユーザに表示されるパスワード・ダイアログや、 フォーマット・オプションを指定して () を呼び出して取得したユーザ名など、URL ではないデータ・ソースからユーザ名を設定する場合に使用する必要があります。QUrl::FullyDecoded userName

userName() およびsetUserInfo()も参照の こと。

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

このURLをother と交換する。この操作は非常に速く、失敗することはない。

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

与えられたドメイン名の ASCII 互換エンコードを返すdomain 。options でフラグを渡すことで、出力をカスタマイズすることができる。この関数の結果は、domain と同等とみなされる。

ASCII互換エンコーディング（ACE）は、RFC 3490、RFC 3491、RFC 3492で定義され、Unicode Technical Standard #46で更新されています。これは、アプリケーションにおけるドメイン名の国際化(Internationalizing Domain Names in Applications: IDNA)仕様の一部であり、("example.com" のような)ドメイン名を非US-ASCII文字で記述できるようにするものである。

この関数は、domain が有効なホスト名でない場合、空のQByteArray を返す。特に、IPv6リテラルは有効なドメイン名ではないことに注意してください。

この関数は Qt 6.3 で導入されました。

CFURLRef QUrl::toCFURL() const

QUrl から CFURL を作成する。

呼び出し元はCFURLを所有し、それを解放する責任がある。

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

人間が表示可能なURLの文字列表現を返す。options でフラグを渡すことで、出力をカスタマイズできる。パスワードは決してユーザーに表示されるべきではないので、RemovePassword オプションは常に有効になっている。

デフォルトのオプションでは、結果のQString を後でQUrl に渡すことができるが、最初に存在したパスワードは失われる。

FormattingOptions 、toEncoded()、toString()も参照のこと 。

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

URLのエンコード表現が有効であればそれを返し、そうでなければ空のQByteArray を返す。options でフラグを渡すことで、出力をカスタマイズすることができる。

ユーザー情報、パス、フラグメントはすべてUTF-8に変換され、ASCII以外の文字はすべてパーセント符号化される。ホスト名はPunycodeでエンコードされる。

QString QUrl::toLocalFile() const

このURLのパスをローカルファイルのパスとしてフォーマットして返します。返されるパスにはスラッシュが使用されます。

このURLに空でないホスト名が含まれている場合、SMBネットワークで見られる形式 (例えば、"//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

注意：このURLのパス・コンポーネントにUTF-8以外のバイナリ列（%80など）が 含まれている場合、この関数の動作は未定義である。

fromLocalFile() およびisLocalFile()も参照 。

NSURL *QUrl::toNSURL() const

QUrl から NSURL を作成する。

NSURLは自動リリースされる。

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

input のエンコードされたコピーを返す。input はまずUTF-8に変換され、unreserved グループにないすべてのASCII文字がパーセントエンコードされる。文字がパーセント符号化されないようにするには、その文字をexclude に渡します。 文字が強制的にパーセント符号化されるようにするには、その文字をinclude に渡します。

Unreservedは次のように定義される：ALPHA / DIGIT / "-" / "." / "_" / "~"

QByteArrayba=QUrl::toPercentEncoding("{あやしい文字列?}", "{}", "s")；qDebug(ba.constData());
// "{a fi%73hy %73tring%3F}" を表示

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

URLの文字列表現を返す。options でフラグを渡すことにより、出力をカスタマイズすることができる。QUrl::FullyDecoded というオプションは、あいまいなデータを生成してしまうので、この関数では許可されていません。

デフォルトのフォーマットオプションはPrettyDecoded である。

FormattingOptions 、url()、setUrl()も参照のこと 。

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

toString(options) を使って、urls のリストをQString オブジェクトのリストに変換します。

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

URLの文字列表現を返す。options でフラグを渡すことにより、出力をカスタマイズすることができる。QUrl::FullyDecoded というオプションは、あいまいなデータを生成してしまうので、この関数では許可されていない。

結果のQString は、後でQUrl に渡すことができる。

toString(オプション)の同義語。

setUrl()、FormattingOptions 、toEncoded()、toString()も参照のこと 。

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

URLのユーザー情報、またはユーザー情報が未定義の場合は空文字列を返す。

この関数は、パーセントエンコードされたままの文字に加え、QString でデコードされた形では表現できない制御シーケンスを含む可能性のある、曖昧さのない値を返します。

引数options は、ユーザー情報コンポーネントの書式を制御する。この関数では、QUrl::FullyDecoded の値は許されない。完全にデコードされたデータを取得する必要がある場合は、userName() およびpassword() を個別に呼び出す。

setUserInfo()、userName()、password()、authority()も参照 。

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

URLのユーザー名が定義されていればそれを返し、そうでなければ空文字列を返す。

options 引数は、ユーザー名コンポーネントの書式を制御します。すべての値は曖昧さのない結果を生成する。QUrl::FullyDecoded では、すべてのパーセントエンコードされたシーケンスがデコードされる。そうでない場合、返される値には、QString でデコードされた形式で表現できない制御シーケンスに対するパーセントエンコードされたシーケンスが含まれる可能性がある。

これらの表現不可能な配列が存在する場合、QUrl::FullyDecoded はデータロスを引き起こす可能性があることに注意。QAuthenticator での設定やログインのネゴシエーションなど、結果がURL以外のコンテキストで使用される場合は、その値を使用することを推奨する。

setUserName() およびuserInfo()も参照のこと 。

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

Move-other をこのQUrl インスタンスに割り当てる。

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

指定されたurl をこのオブジェクトに割り当てます。

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

指定されたurl をこのオブジェクトに割り当てます。