# class UDSEntry

###

Module | kio
Namespace | KIO
Class | UDSEntry
Inherits |

Universal Directory Service

UDS entry is the data structure representing all the fields about a given URL (file or directory).

The KIO.listDir() and KIO:stat() operations use this data structure.

KIO defines a number of standard fields, see the UDS_XXX enums (see StandardFieldTypes). at the moment UDSEntry only provides fields with numeric indexes, but there might be named fields with string indexes in the future.

For instance, to retrieve the name of the entry, use:

    QString displayName = entry.stringValue( KIO.UDSEntry.UDS_NAME );

To know the modification time of the file/url:

    time_t mtime = entry.numberValue( KIO.UDSEntry.UDS_MODIFICATION_TIME, -1 );
    if ( mtime != -1 )
    ...

### enums

- StandardFieldTypes { UDS_STRING, UDS_NUMBER, UDS_TIME, UDS_SIZE, UDS_SIZE_LARGE, UDS_USER, UDS_ICON_NAME, UDS_GROUP, UDS_NAME, UDS_LOCAL_PATH, UDS_HIDDEN, UDS_ACCESS, UDS_MODIFICATION_TIME, UDS_ACCESS_TIME, UDS_CREATION_TIME, UDS_FILE_TYPE, UDS_LINK_DEST, UDS_URL, UDS_MIME_TYPE, UDS_GUESSED_MIME_TYPE, UDS_XML_PROPERTIES, UDS_EXTENDED_ACL, UDS_ACL_STRING, UDS_DEFAULT_ACL_STRING, UDS_DISPLAY_NAME, UDS_TARGET_URL, UDS_EXTRA, UDS_EXTRA_END }
- StandardFieldTypes { UDS_STRING, UDS_NUMBER, UDS_TIME, UDS_SIZE, UDS_SIZE_LARGE, UDS_USER, UDS_ICON_NAME, UDS_GROUP, UDS_NAME, UDS_LOCAL_PATH, UDS_HIDDEN, UDS_ACCESS, UDS_MODIFICATION_TIME, UDS_ACCESS_TIME, UDS_CREATION_TIME, UDS_FILE_TYPE, UDS_LINK_DEST, UDS_URL, UDS_MIME_TYPE, UDS_GUESSED_MIME_TYPE, UDS_XML_PROPERTIES, UDS_EXTENDED_ACL, UDS_ACL_STRING, UDS_DEFAULT_ACL_STRING, UDS_EXTRA, UDS_EXTRA_END }

enum details

### methods

- UDSEntry ( )

  returns ctor

- UDSEntry (other)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  other | KIO.UDSEntry |

- clear ( )

  returns Nothing

  remove all fields

- contains (field)

  returns bool

  Argument | Type | Default
  --- | --- | ---
  field | uint |

  check existence of a field

  field -

- count ( )

  returns int

  count fields Returns the number of fields

- insert (field, value)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  field | uint |
  value | QString |

  insert field with numeric value

  field - numeric field id

  value -

- insert (field, l)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  field | uint |
  l | long long |

  insert field with string value

  field - numeric tield id

  l - value to set

- isDir ( )

  returns bool

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

- isLink ( )

  returns bool

  Returns true if this entry is a link

- listFields ( )

  returns QList<uint>

  lists all fields

- numberValue (field, defaultValue)

  returns long long

  Argument | Type | Default
  --- | --- | ---
  field | uint |
  defaultValue | long long | 0

  Returns value of a numeric field

- remove (field)

  returns bool

  Argument | Type | Default
  --- | --- | ---
  field | uint |

  remove a field with a certain numeric id

  field - numeric type id

- stringValue (field)

  returns QString

  Argument | Type | Default
  --- | --- | ---
  field | uint |

  Returns value of a textual field

### enums - detail

- StandardFieldTypes { UDS_STRING, UDS_NUMBER, UDS_TIME, UDS_SIZE, UDS_SIZE_LARGE, UDS_USER, UDS_ICON_NAME, UDS_GROUP, UDS_NAME, UDS_LOCAL_PATH, UDS_HIDDEN, UDS_ACCESS, UDS_MODIFICATION_TIME, UDS_ACCESS_TIME, UDS_CREATION_TIME, UDS_FILE_TYPE, UDS_LINK_DEST, UDS_URL, UDS_MIME_TYPE, UDS_GUESSED_MIME_TYPE, UDS_XML_PROPERTIES, UDS_EXTENDED_ACL, UDS_ACL_STRING, UDS_DEFAULT_ACL_STRING, UDS_DISPLAY_NAME, UDS_TARGET_URL, UDS_EXTRA, UDS_EXTRA_END }

  Indicates that the field is a QString

  | UDS_STRING | - 0x01000000 | - |
  | UDS_NUMBER | - 0x02000000 | - |
  | UDS_TIME | - 0x04000000|UDS_NUMBER | - |
  | UDS_SIZE | - 1|UDS_NUMBER | - |
  | UDS_SIZE_LARGE | - 2|UDS_NUMBER | - |
  | UDS_USER | - 3|UDS_STRING | - |
  | UDS_ICON_NAME | - 4|UDS_STRING | - |
  | UDS_GROUP | - 5|UDS_STRING | - |
  | UDS_NAME | - 6|UDS_STRING | - |
  | UDS_LOCAL_PATH | - 7|UDS_STRING | - |
  | UDS_HIDDEN | - 8|UDS_NUMBER | - |
  | UDS_ACCESS | - 9|UDS_NUMBER | - |
  | UDS_MODIFICATION_TIME | - 10|UDS_TIME | - |
  | UDS_ACCESS_TIME | - 11|UDS_TIME | - |
  | UDS_CREATION_TIME | - 12|UDS_TIME | - |
  | UDS_FILE_TYPE | - 13|UDS_NUMBER | - |
  | UDS_LINK_DEST | - 14|UDS_STRING | - |
  | UDS_URL | - 15|UDS_STRING | - |
  | UDS_MIME_TYPE | - 16|UDS_STRING | - |
  | UDS_GUESSED_MIME_TYPE | - 17|UDS_STRING | - |
  | UDS_XML_PROPERTIES | - 18|UDS_STRING | - |
  | UDS_EXTENDED_ACL | - 19|UDS_NUMBER | - |
  | UDS_ACL_STRING | - 20|UDS_STRING | - |
  | UDS_DEFAULT_ACL_STRING | - 21|UDS_STRING | - |
  | UDS_DISPLAY_NAME | - 22|UDS_STRING | - |
  | UDS_TARGET_URL | - 23|UDS_STRING | - |
  | UDS_EXTRA | - 100|UDS_STRING | - |
  | UDS_EXTRA_END | - 140|UDS_STRING | - |

- StandardFieldTypes { UDS_STRING, UDS_NUMBER, UDS_TIME, UDS_SIZE, UDS_SIZE_LARGE, UDS_USER, UDS_ICON_NAME, UDS_GROUP, UDS_NAME, UDS_LOCAL_PATH, UDS_HIDDEN, UDS_ACCESS, UDS_MODIFICATION_TIME, UDS_ACCESS_TIME, UDS_CREATION_TIME, UDS_FILE_TYPE, UDS_LINK_DEST, UDS_URL, UDS_MIME_TYPE, UDS_GUESSED_MIME_TYPE, UDS_XML_PROPERTIES, UDS_EXTENDED_ACL, UDS_ACL_STRING, UDS_DEFAULT_ACL_STRING, UDS_EXTRA, UDS_EXTRA_END }

  | UDS_STRING | - | - |
  | UDS_NUMBER | - | - |
  | UDS_TIME | - | - |
  | UDS_SIZE | - | - |
  | UDS_SIZE_LARGE | - | - |
  | UDS_USER | - | - |
  | UDS_ICON_NAME | - | - |
  | UDS_GROUP | - | - |
  | UDS_NAME | - | - |
  | UDS_LOCAL_PATH | - | - |
  | UDS_HIDDEN | - | - |
  | UDS_ACCESS | - | - |
  | UDS_MODIFICATION_TIME | - | - |
  | UDS_ACCESS_TIME | - | - |
  | UDS_CREATION_TIME | - | - |
  | UDS_FILE_TYPE | - | - |
  | UDS_LINK_DEST | - | - |
  | UDS_URL | - | - |
  | UDS_MIME_TYPE | - | - |
  | UDS_GUESSED_MIME_TYPE | - | - |
  | UDS_XML_PROPERTIES | - | - |
  | UDS_EXTENDED_ACL | - | - |
  | UDS_ACL_STRING | - | - |
  | UDS_DEFAULT_ACL_STRING | - | - |
  | UDS_EXTRA | - | - |
  | UDS_EXTRA_END | - | - |