Class TEntry

TEntry

Support

Supported from 5.0

Description

Directory entry. This class encapsulates a single directory entry for a file or directory. Each file and directory entry has a name which is relative to its owning directory and a type, which is indicated by its unique identifier (UID).

An entry can be interrogated for the following attributes:

• the kind of entry

• its size

• the time it was last modified

Defined in TEntry:
IsArchive(), IsDir(), IsHidden(), IsReadOnly(), IsSystem(), IsTypeValid(), IsUidPresent(), MostDerivedUid(), iAtt, iModified, iName, iSize, iType, operator[]()

See also:

• File or directory attributes
• File constants

TBool IsReadOnly() const;

Description

Tests whether the file or directory is read-only.

Return value

TBool True if entry is read-only, false if not

TBool IsHidden() const;

Description

Tests whether the file or directory is hidden.

Return value

TBool True if entry is hidden, false if not

TBool IsSystem() const;

Description

Tests whether the file or directory has the system attribute set.

Return value

TBool True if entry is a system entry, false if not

TBool IsDir() const;

Description

Tests whether the entry is a directory.

Return value

TBool True if entry indicates a directory, false if not

TBool IsArchive() const;

Description

Tests whether the file is an archive file.

Return value

TBool True if file is archive, false if not

const TUid& operator[](TInt anIndex) const;

Description

Returns any one of the file’s three UIDs.

Parameters

TInt anIndex Identifies which UID is required. This can be zero, one or two. Specifiying any other value raises a panic.

Return value

TUid& On return contains the requested UID.

TBool IsUidPresent(TUid aUid) const;

Description

Tests whether a UID is present in any of the three forms.

Parameters

TUid aUid The UID to check

Return value

TBool True if the UID specified is present. false if not.

TBool IsTypeValid() const;

Description

Test whether the file has any UID which is not NULL.

Return value

TBool True if the entry has any UID which is not NULL, false if all three UIDs are NULL.

TUid MostDerivedUid() const;

Description

Gets the most derived (i.e. most specific) UID.

Return value

TUid The entry’s most derived UID

TUint iAtt

Description

The individual bits within this byte indicate which attributes have been set. For more information see KEntryAttNormal or the other file/directory attributes.

TTime iModified

Description

System time of last modification

TBufC<KMaxFileName> iName

Description

Name of file relative to the owning directory, with a maximum ofKMaxFileName (= 256) characters.

TInt iSize

Description

Size of the file in bytes

TUidType iType

Description

Extraction and enquiry functions for a file’s UIDs