KIO::UDSEntry Class

QString displayName = entry.stringValue( KIO::UDSEntry::UDS_DISPLAY_NAME );

QDateTime mtime = QDateTime::fromSecsSinceEpoch(entry.numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME, 0));
if (mtime.isValid())
    ...

if (entry.contains(KIO::UDSEntry::UDS_MODIFICATION_TIME_NS_OFFSET)) {
    long long totalMSecs = (entry.numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME, 0) * 1000LL)
                          + entry.numberValue(KIO::UDSEntry::UDS_MODIFICATION_TIME_NS_OFFSET, 0) / 1000000LL);

    QDateTime mtime = QDateTime::fromMSecsSinceEpoch(totalMSecs);

Member Function Documentation

UDSEntry::UDSEntry()

UDSEntry::UDSEntry(const struct stat64 &buff, const QString &name = QString())

Create a UDSEntry by QT_STATBUF

buff QT_STATBUF object

name filename

UDSEntry::UDSEntry(const KIO::UDSEntry &)

Copy constructor

void UDSEntry::clear()

remove all fields

bool UDSEntry::contains(uint field) const

check existence of a field

field numeric field id

int UDSEntry::count() const

The number of fields

void UDSEntry::fastInsert(uint field, const QString &value)

Insert field with string value, it will assert if the field is already inserted. In that case, use replace() instead. field numeric field id value to set

void UDSEntry::fastInsert(uint field, long long l)

Insert field with numeric value, it will assert if the field is already inserted. In that case, use replace() instead. field numeric field id l value to set

QList<uint> UDSEntry::fields() const

A vector of fields being present for the current entry.

Returns all fields for the current entry.

[since 6.29] void UDSEntry::insert(std::initializer_list<std::pair<uint, const QString &>> fieldValuePairs)

Insert the values passed as pairs {field, value} in a initializer_list

This will first pre-allocate the necessary memory in the underlying storage vector.

Example:

UDSEntry entry;
entry.insert({{UDS_SIZE, 0}, {UDS_ACCESS, 0}});

fieldValuePairs the fields and the values to insert

This function was introduced in 6.29.

[since 6.29] void UDSEntry::insert(std::initializer_list<std::pair<uint, long long>> fieldValuePairs)

Insert the values passed as pairs {field, value} in a initializer_list

This will first pre-allocate the necessary memory in the underlying storage vector.

Example:

UDSEntry entry;
entry.insert({{UDS_NAME, ""}, {UDS_USER, ""}});

fieldValuePairs the fields and the values to insert

This function was introduced in 6.29.

bool UDSEntry::isDir() const

Returns true if this entry is a directory (or a link to a directory)

bool UDSEntry::isLink() const

Returns true if this entry is a link

long long UDSEntry::numberValue(uint field, long long defaultValue = 0) const

Returns value of a numeric field

[since 6.29] int UDSEntry::numbersCount() const

The number of number fields (including time fields)

This function was introduced in 6.29.

void UDSEntry::replace(uint field, const QString &value)

Replace or insert field with string value field numeric field id value to set

void UDSEntry::replace(uint field, long long l)

Replace or insert field with numeric value field numeric field id l value to set

[since 6.29] void UDSEntry::reserve(std::initializer_list<uint> fields)

Pre-allocate fields fields in the backend storage according to their UDS_TYPE

Example:

UDSEntry entry;
entry.reserve({UDS_SIZE, UDS_ACCESS, UDS_MODIFICATION_TIME, UDS_NAME});

fields the fields to pre-allocate for

This function was introduced in 6.29.

[since 6.29] void UDSEntry::reserveNumbers(int size)

Calling this function before inserting items into an empty UDSEntry may save time and memory.

size number of UDS_NUMBER fields for which memory will be pre-allocated

This function was introduced in 6.29.

See also reserveStrings().

[since 6.29] void UDSEntry::reserveStrings(int size)

Calling this function before inserting items into an empty UDSEntry may save time and memory.

size number of UDS_STRING fields for which memory will be pre-allocated

This function was introduced in 6.29.

See also reserveNumbers().

QString UDSEntry::stringValue(uint field) const

Returns value of a textual field

[since 6.29] int UDSEntry::stringsCount() const

The number of string fields

This function was introduced in 6.29.

KIO::UDSEntryList::ConstIterator it = entries.begin();
const KIO::UDSEntryList::ConstIterator end = entries.end();
for (; it != end; ++it) {
  const KIO::UDSEntry& entry = *it;
  QString name = entry.stringValue( KIO::UDSEntry::UDS_NAME );
  bool isDir = entry.isDir();
  KIO::filesize_t size = entry.numberValue( KIO::UDSEntry::UDS_SIZE, -1 );
  ...
}