Contents

• Public Types
• Public Functions
• Static Public Members
• Detailed Description

Detailed Description

TheQUrlInfo class stores information about URLs.

The information about a URL that can be retrieved includesname(),permissions(),owner(),group(),size(),lastModified(),lastRead(),isDir(),isFile(),isSymLink(),isWritable(),isReadable() andisExecutable().

You can create your ownQUrlInfo objects passing in all the relevant information in the constructor, and you can modify aQUrlInfo; for each getter mentioned above there is an equivalent setter. Note that setting values does not affect the underlying resource that theQUrlInfo provides information about; for example if you callsetWritable(true) on a read-only resource the only thing changed is theQUrlInfo object, not the resource.

Member Type Documentation

enum QUrlInfo::PermissionSpec

This enum is used by thepermissions() function to report the permissions of a file.

Member Function Documentation

QUrlInfo::QUrlInfo()

Constructs an invalidQUrlInfo object with default values.

See alsoisValid().

QUrlInfo::QUrlInfo(constQUrlInfo & ui)

Copy constructor, copiesui to this URL info object.

QUrlInfo::QUrlInfo(constQString & name,int permissions, constQString & owner, constQString & group,qint64 size, constQDateTime & lastModified, constQDateTime & lastRead,bool isDir,bool isFile,bool isSymLink,bool isWritable,bool isReadable,bool isExecutable)

Constructs aQUrlInfo object by specifying all the URL's information.

The information that is passed is thename, filepermissions,owner andgroup and the file'ssize. Also passed is thelastModified date/time and thelastRead date/time. Flags are also passed, specifically,isDir,isFile,isSymLink,isWritable,isReadable andisExecutable.

QUrlInfo::QUrlInfo(constQUrl & url,int permissions, constQString & owner, constQString & group,qint64 size, constQDateTime & lastModified, constQDateTime & lastRead,bool isDir,bool isFile,bool isSymLink,bool isWritable,bool isReadable,bool isExecutable)

Constructs aQUrlInfo object by specifying all the URL's information.

The information that is passed is theurl, filepermissions,owner andgroup and the file'ssize. Also passed is thelastModified date/time and thelastRead date/time. Flags are also passed, specifically,isDir,isFile,isSymLink,isWritable,isReadable andisExecutable.

[virtual]QUrlInfo::~QUrlInfo()

Destroys the URL info object.

[static]bool QUrlInfo::equal(constQUrlInfo & i1, constQUrlInfo & i2,int sortBy)

Returns true ifi1 equals toi2; otherwise returns false. The objects are compared by the value, which is specified bysortBy. This must be one ofQDir::Name,QDir::Time orQDir::Size.

[static]bool QUrlInfo::greaterThan(constQUrlInfo & i1, constQUrlInfo & i2,int sortBy)

Returns true ifi1 is greater thani2; otherwise returns false. The objects are compared by the value, which is specified bysortBy. This must be one ofQDir::Name,QDir::Time orQDir::Size.

QString QUrlInfo::group() const

Returns the group of the URL.

See alsosetGroup() andisValid().

bool QUrlInfo::isDir() const

Returns true if the URL is a directory; otherwise returns false.

See alsoisValid().

bool QUrlInfo::isExecutable() const

Returns true if the URL is executable; otherwise returns false.

See alsoisValid().

bool QUrlInfo::isFile() const

Returns true if the URL is a file; otherwise returns false.

See alsoisValid().

bool QUrlInfo::isReadable() const

Returns true if the URL is readable; otherwise returns false.

See alsoisValid().

bool QUrlInfo::isSymLink() const

Returns true if the URL is a symbolic link; otherwise returns false.

See alsoisValid().

bool QUrlInfo::isValid() const

Returns true if the URL info is valid; otherwise returns false. Valid means that theQUrlInfo contains real information.

You should always check if the URL info is valid before relying on the values.

bool QUrlInfo::isWritable() const

Returns true if the URL is writable; otherwise returns false.

See alsoisValid().

QDateTime QUrlInfo::lastModified() const

Returns the last modification date of the URL.

See alsosetLastModified() andisValid().

QDateTime QUrlInfo::lastRead() const

Returns the date when the URL was last read.

See alsosetLastRead() andisValid().

[static]bool QUrlInfo::lessThan(constQUrlInfo & i1, constQUrlInfo & i2,int sortBy)

Returns true ifi1 is less thani2; otherwise returns false. The objects are compared by the value, which is specified bysortBy. This must be one ofQDir::Name,QDir::Time orQDir::Size.

QString QUrlInfo::name() const

Returns the file name of the URL.

See alsosetName() andisValid().

QString QUrlInfo::owner() const

Returns the owner of the URL.

See alsosetOwner() andisValid().

int QUrlInfo::permissions() const

Returns the permissions of the URL. You can use thePermissionSpec flags to test for certain permissions.

See alsosetPermissions() andisValid().

[virtual]void QUrlInfo::setDir(bool b)

Ifb is true then the URL is set to be a directory; ifb is false then the URL is set not to be a directory (which normally means it is a file). (Note that a URL can refer to both a file and a directory even though most file systems do not support this.)

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoisDir() andisValid().

[virtual]void QUrlInfo::setFile(bool b)

Ifb is true then the URL is set to be a file; ifis false then the URL is set not to be a file (which normally means it is a directory). (Note that a URL can refer to both a file and a directory even though most file systems do not support this.)

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoisFile() andisValid().

[virtual]void QUrlInfo::setGroup(constQString & s)

Specifies that the owning group of the URL is calleds.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsogroup() andisValid().

[virtual]void QUrlInfo::setLastModified(constQDateTime & dt)

Specifies that the object the URL refers to was last modified atdt.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsolastModified() andisValid().

void QUrlInfo::setLastRead(constQDateTime & dt)

Specifies that the object the URL refers to was last read atdt.

If you call this function for an invalid URL info, this function turns it into a valid one.

This function was introduced in Qt 4.4.

See alsolastRead() andisValid().

[virtual]void QUrlInfo::setName(constQString & name)

Sets the name of the URL toname. The name is the full text, for example, "http://qt.nokia.com/doc/qurlinfo.html".

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoname() andisValid().

[virtual]void QUrlInfo::setOwner(constQString & s)

Specifies that the owner of the URL is calleds.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoowner() andisValid().

[virtual]void QUrlInfo::setPermissions(int p)

Specifies that the URL has access permissionsp.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsopermissions() andisValid().

[virtual]void QUrlInfo::setReadable(bool b)

Specifies that the URL is readable ifb is true and not readable ifb is false.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoisReadable() andisValid().

[virtual]void QUrlInfo::setSize(qint64 size)

Specifies thesize of the URL.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsosize() andisValid().

[virtual]void QUrlInfo::setSymLink(bool b)

Specifies that the URL refers to a symbolic link ifb is true and that it does not ifb is false.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoisSymLink() andisValid().

[virtual]void QUrlInfo::setWritable(bool b)

Specifies that the URL is writable ifb is true and not writable ifb is false.

If you call this function for an invalid URL info, this function turns it into a valid one.

See alsoisWritable() andisValid().

qint64 QUrlInfo::size() const

Returns the size of the URL.

See alsosetSize() andisValid().

bool QUrlInfo::operator!=(constQUrlInfo & other) const

Returns true if thisQUrlInfo is not equal toother; otherwise returns false.

This function was introduced in Qt 4.2.

See alsolessThan() andequal().

QUrlInfo & QUrlInfo::operator=(constQUrlInfo & ui)

Assigns the values ofui to thisQUrlInfo object.

bool QUrlInfo::operator==(constQUrlInfo & other) const

Returns true if thisQUrlInfo is equal toother; otherwise returns false.

See alsolessThan() andequal().