Related Non-Members

KIO::StatJob *mostLocalUrl(const QUrl &url, KIO::JobFlags flags = DefaultFlags)

Tries to map a local URL for the given URL, using a KIO job. This only makes sense for protocols that have Class ":local" (such protocols most likely have KIO workers that set UDSEntry::UDS_LOCAL_PATH); ideally you should check the URL protocol Class before creating a StatJob. See KProtocolInfo::protocolClass().

Starts a (stat) job for determining the "most local URL" for a given URL. Retrieve the result with StatJob::mostLocalUrl in the result slot.

url The URL we are stat'ing.

Sample usage:

Here the KIO worker name is "foo", which for example could be:

• "desktop", "fonts", "kdeconnect", these have class ":local"
• "ftp", "sftp", "smb", these have class ":internet"

QUrl url(QStringLiteral("foo://bar/");
if (url.isLocalFile()) { // If it's a local URL, there is no need to stat
   [...]
} else if (KProtocolInfo::protocolClass(url.scheme()) == QLatin1String(":local")) {
    // Not a local URL, but if the protocol class is ":local", we may be able to stat
    // and get a "most local URL"
    auto *job = KIO::mostLocalUrl(url);
    job->uiDelegate()->setWindow(this);
    connect(job, &KJob::result, this, &MyClass::slotMostLocalUrlResult);
    [...]
    // And in slotMostLocalUrlResult(KJob *job)
    if (job->error()) {
        [...] // Doesn't exist, ideally show an error message
    } else {
        const QUrl localUrl = job->mostLocalUrl();
        // localUrl = file:///local/path/to/bar/
        [...]
    }
}

KIO::StatJob *stat(const QUrl &url, KIO::JobFlags flags = DefaultFlags)

Find all details for one file or directory.

url the URL of the file

flags Can be HideProgressInfo here

Returns the job handling the operation.

[since 6.0] KIO::StatJob *stat(const QUrl &url, KIO::StatJob::StatSide side, KIO::StatDetails details = KIO::StatDefaultDetails, KIO::JobFlags flags = DefaultFlags)

Find all details for one file or directory. This version of the call includes two additional booleans, sideIsSource and details.

url the URL of the file

side is SourceSide when stating a source file (we will do a get on it if the stat works) and DestinationSide when stating a destination file (target of a copy). The reason for this parameter is that in some cases the KIO worker might not be able to determine a file's existence (e.g. HTTP doesn't allow it, FTP has issues with case-sensitivity on some systems). When the worker can't reliably determine the existence of a file, it will:

• be optimistic if SourceSide, i.e. it will assume the file exists, and if it doesn't this will appear when actually trying to download it
• be pessimistic if DestinationSide, i.e. it will assume the file doesn't exist, to prevent showing "about to overwrite" errors to the user. If you simply want to check for existence without downloading/uploading afterwards, then you should use DestinationSide.

details selects the level of details we want. You should minimize the detail level for better performance.

flags Can be HideProgressInfo here

Returns the job handling the operation.

This function was introduced in 6.0.