API reference - Class QFile

Notation used in Ruby API documentation

Module: QtCore

Description: Binding of QFile

Class hierarchy: QFile » QIODevice » QObject

Sub-classes: FileError, QFlags_FileError, Permission, QFlags_Permission

Public constructors

new QFilenewConstructor QFile::QFile()
new QFilenew(string name)Constructor QFile::QFile(const QString &name)
new QFilenew(QObject ptr parent)Constructor QFile::QFile(QObject *parent)
new QFilenew(string name,
QObject ptr parent)
Constructor QFile::QFile(const QString &name, QObject *parent)

Public methods

void_createEnsures the C++ object is created
void_destroyExplicitly destroys the object
[const]bool_destroyed?Returns a value indicating whether the object was already destroyed
[const]bool_is_const_object?Returns a value indicating whether the reference is a const reference
void_manageMarks the object as managed by the script side.
void_unmanageMarks the object as no longer owned by the script side.
[signal]voidaboutToCloseSignal declaration for QFile::aboutToClose()
[const]boolatEndMethod bool QFile::atEnd()
[signal]voidbytesWritten(long long bytes)Signal declaration for QFile::bytesWritten(qint64 bytes)
voidcloseMethod void QFile::close()
boolcopy(string newName)Method bool QFile::copy(const QString &newName)
[signal]voiddestroyed(QObject ptr arg1)Signal declaration for QFile::destroyed(QObject *)
[const]QFile_FileErrorerrorMethod QFile::FileError QFile::error()
[const]boolexistsMethod bool QFile::exists()
[const]stringfileNameMethod QString QFile::fileName()
voidfileName=(string name)Method void QFile::setFileName(const QString &name)
boolflushMethod bool QFile::flush()
[const]inthandleMethod int QFile::handle()
[const]boolisSequential?Method bool QFile::isSequential()
boollink(string newName)Method bool QFile::link(const QString &newName)
boolopen(QIODevice_QFlags_OpenModeFlag flags)Method bool QFile::open(QFlags<QIODevice::OpenModeFlag> flags)
[const]QFile_QFlags_PermissionpermissionsMethod QFlags<QFile::Permission> QFile::permissions()
[const]long longposMethod qint64 QFile::pos()
[signal]voidreadChannelFinishedSignal declaration for QFile::readChannelFinished()
[const]stringreadLinkMethod QString QFile::readLink()
[signal]voidreadyReadSignal declaration for QFile::readyRead()
boolremoveMethod bool QFile::remove()
boolrename(string newName)Method bool QFile::rename(const QString &newName)
boolresize(long long sz)Method bool QFile::resize(qint64 sz)
boolseek(long long offset)Method bool QFile::seek(qint64 offset)
voidsetFileName(string name)Method void QFile::setFileName(const QString &name)
boolsetPermissions(QFile_QFlags_Permission permissionSpec)Method bool QFile::setPermissions(QFlags<QFile::Permission> permissionSpec)
[const]long longsizeMethod qint64 QFile::size()
[const]stringsymLinkTargetMethod QString QFile::symLinkTarget()
voidunsetErrorMethod void QFile::unsetError()

Public static methods and constants

[static,const]QFile_FileErrorAbortErrorEnum constant QFile::AbortError
[static,const]QFile_FileErrorCopyErrorEnum constant QFile::CopyError
[static,const]QFile_PermissionExeGroupEnum constant QFile::ExeGroup
[static,const]QFile_PermissionExeOtherEnum constant QFile::ExeOther
[static,const]QFile_PermissionExeOwnerEnum constant QFile::ExeOwner
[static,const]QFile_PermissionExeUserEnum constant QFile::ExeUser
[static,const]QFile_FileErrorFatalErrorEnum constant QFile::FatalError
[static,const]QFile_FileErrorNoErrorEnum constant QFile::NoError
[static,const]QFile_FileErrorOpenErrorEnum constant QFile::OpenError
[static,const]QFile_FileErrorPermissionsErrorEnum constant QFile::PermissionsError
[static,const]QFile_FileErrorPositionErrorEnum constant QFile::PositionError
[static,const]QFile_FileErrorReadErrorEnum constant QFile::ReadError
[static,const]QFile_PermissionReadGroupEnum constant QFile::ReadGroup
[static,const]QFile_PermissionReadOtherEnum constant QFile::ReadOther
[static,const]QFile_PermissionReadOwnerEnum constant QFile::ReadOwner
[static,const]QFile_PermissionReadUserEnum constant QFile::ReadUser
[static,const]QFile_FileErrorRemoveErrorEnum constant QFile::RemoveError
[static,const]QFile_FileErrorRenameErrorEnum constant QFile::RenameError
[static,const]QFile_FileErrorResizeErrorEnum constant QFile::ResizeError
[static,const]QFile_FileErrorResourceErrorEnum constant QFile::ResourceError
[static,const]QFile_FileErrorTimeOutErrorEnum constant QFile::TimeOutError
[static,const]QFile_FileErrorUnspecifiedErrorEnum constant QFile::UnspecifiedError
[static,const]QFile_FileErrorWriteErrorEnum constant QFile::WriteError
[static,const]QFile_PermissionWriteGroupEnum constant QFile::WriteGroup
[static,const]QFile_PermissionWriteOtherEnum constant QFile::WriteOther
[static,const]QFile_PermissionWriteOwnerEnum constant QFile::WriteOwner
[static,const]QFile_PermissionWriteUserEnum constant QFile::WriteUser
boolcopy(string fileName,
string newName)
Static method bool QFile::copy(const QString &fileName, const QString &newName)
stringdecodeName(string localFileName)Static method QString QFile::decodeName(const char *localFileName)
encodeName(string fileName)Static method QByteArray QFile::encodeName(const QString &fileName)
boolexists(string fileName)Static method bool QFile::exists(const QString &fileName)
boollink(string oldname,
string newName)
Static method bool QFile::link(const QString &oldname, const QString &newName)
QFile_QFlags_Permissionpermissions(string filename)Static method QFlags<QFile::Permission> QFile::permissions(const QString &filename)
stringreadLink(string fileName)Static method QString QFile::readLink(const QString &fileName)
boolremove(string fileName)Static method bool QFile::remove(const QString &fileName)
boolrename(string oldName,
string newName)
Static method bool QFile::rename(const QString &oldName, const QString &newName)
boolresize(string filename,
long long sz)
Static method bool QFile::resize(const QString &filename, qint64 sz)
boolsetPermissions(string filename,
QFile_QFlags_Permission permissionSpec)
Static method bool QFile::setPermissions(const QString &filename, QFlags<QFile::Permission> permissionSpec)
QMetaObjectstaticMetaObjectObtains the static MetaObject for this class.
stringsymLinkTarget(string fileName)Static method QString QFile::symLinkTarget(const QString &fileName)
stringtr(string s,
string c = 0)
Static method QString QFile::tr(const char *s, const char *c)
stringtr(string s,
string c,
int n)
Static method QString QFile::tr(const char *s, const char *c, int n)
stringtrUtf8(string s,
string c = 0)
Static method QString QFile::trUtf8(const char *s, const char *c)
stringtrUtf8(string s,
string c,
int n)
Static method QString QFile::trUtf8(const char *s, const char *c, int n)

Deprecated methods (protected, public, static, non-static and constructors)

voidcreateUse of this method is deprecated. Use _create instead
voiddestroyUse of this method is deprecated. Use _destroy instead
[const]boolis_const_object?Use of this method is deprecated. Use _is_const_object? instead

Detailed description

AbortError

Signature: [static,const] QFile_FileError AbortError

Description: Enum constant QFile::AbortError

CopyError

Signature: [static,const] QFile_FileError CopyError

Description: Enum constant QFile::CopyError

ExeGroup

Signature: [static,const] QFile_Permission ExeGroup

Description: Enum constant QFile::ExeGroup

ExeOther

Signature: [static,const] QFile_Permission ExeOther

Description: Enum constant QFile::ExeOther

ExeOwner

Signature: [static,const] QFile_Permission ExeOwner

Description: Enum constant QFile::ExeOwner

ExeUser

Signature: [static,const] QFile_Permission ExeUser

Description: Enum constant QFile::ExeUser

FatalError

Signature: [static,const] QFile_FileError FatalError

Description: Enum constant QFile::FatalError

NoError

Signature: [static,const] QFile_FileError NoError

Description: Enum constant QFile::NoError

OpenError

Signature: [static,const] QFile_FileError OpenError

Description: Enum constant QFile::OpenError

PermissionsError

Signature: [static,const] QFile_FileError PermissionsError

Description: Enum constant QFile::PermissionsError

PositionError

Signature: [static,const] QFile_FileError PositionError

Description: Enum constant QFile::PositionError

ReadError

Signature: [static,const] QFile_FileError ReadError

Description: Enum constant QFile::ReadError

ReadGroup

Signature: [static,const] QFile_Permission ReadGroup

Description: Enum constant QFile::ReadGroup

ReadOther

Signature: [static,const] QFile_Permission ReadOther

Description: Enum constant QFile::ReadOther

ReadOwner

Signature: [static,const] QFile_Permission ReadOwner

Description: Enum constant QFile::ReadOwner

ReadUser

Signature: [static,const] QFile_Permission ReadUser

Description: Enum constant QFile::ReadUser

RemoveError

Signature: [static,const] QFile_FileError RemoveError

Description: Enum constant QFile::RemoveError

RenameError

Signature: [static,const] QFile_FileError RenameError

Description: Enum constant QFile::RenameError

ResizeError

Signature: [static,const] QFile_FileError ResizeError

Description: Enum constant QFile::ResizeError

ResourceError

Signature: [static,const] QFile_FileError ResourceError

Description: Enum constant QFile::ResourceError

TimeOutError

Signature: [static,const] QFile_FileError TimeOutError

Description: Enum constant QFile::TimeOutError

UnspecifiedError

Signature: [static,const] QFile_FileError UnspecifiedError

Description: Enum constant QFile::UnspecifiedError

WriteError

Signature: [static,const] QFile_FileError WriteError

Description: Enum constant QFile::WriteError

WriteGroup

Signature: [static,const] QFile_Permission WriteGroup

Description: Enum constant QFile::WriteGroup

WriteOther

Signature: [static,const] QFile_Permission WriteOther

Description: Enum constant QFile::WriteOther

WriteOwner

Signature: [static,const] QFile_Permission WriteOwner

Description: Enum constant QFile::WriteOwner

WriteUser

Signature: [static,const] QFile_Permission WriteUser

Description: Enum constant QFile::WriteUser

_create

Signature: void _create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

_destroy

Signature: void _destroy

Description: Explicitly destroys the object

Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing.

_destroyed?

Signature: [const] bool _destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

_is_const_object?

Signature: [const] bool _is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

_manage

Signature: void _manage

Description: Marks the object as managed by the script side.

After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required.

Usually it's not required to call this method. It has been introduced in version 0.24.

_unmanage

Signature: void _unmanage

Description: Marks the object as no longer owned by the script side.

Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur.

Usually it's not required to call this method. It has been introduced in version 0.24.

aboutToClose

Signature: [signal] void aboutToClose

Description: Signal declaration for QFile::aboutToClose()

You can bind a procedure to this signal.

Python specific notes:
The object exposes a readable attribute 'aboutToClose'. This is the getter. The object exposes a writable attribute 'aboutToClose'. This is the setter.

atEnd

Signature: [const] bool atEnd

Description: Method bool QFile::atEnd()

This is a reimplementation of QIODevice::atEnd

bytesWritten

Signature: [signal] void bytesWritten (long long bytes)

Description: Signal declaration for QFile::bytesWritten(qint64 bytes)

You can bind a procedure to this signal.

Python specific notes:
The object exposes a readable attribute 'bytesWritten'. This is the getter. The object exposes a writable attribute 'bytesWritten'. This is the setter.

close

Signature: void close

Description: Method void QFile::close()

This is a reimplementation of QIODevice::close

copy

Signature: bool copy (string newName)

Description: Method bool QFile::copy(const QString &newName)

Python specific notes:
This attribute is available as '_inst_copy' in Python

Signature: [static] bool copy (string fileName, string newName)

Description: Static method bool QFile::copy(const QString &fileName, const QString &newName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_copy' in Python

create

Signature: void create

Description: Ensures the C++ object is created

Use of this method is deprecated. Use _create instead

decodeName

Signature: [static] string decodeName (string localFileName)

Description: Static method QString QFile::decodeName(const char *localFileName)

This method is static and can be called without an instance.

destroy

Signature: void destroy

Description: Explicitly destroys the object

Use of this method is deprecated. Use _destroy instead

destroyed

Signature: [signal] void destroyed (QObject ptr arg1)

Description: Signal declaration for QFile::destroyed(QObject *)

You can bind a procedure to this signal.

Python specific notes:
The object exposes a readable attribute 'destroyed'. This is the getter. The object exposes a writable attribute 'destroyed'. This is the setter.

encodeName

Signature: [static] encodeName (string fileName)

Description: Static method QByteArray QFile::encodeName(const QString &fileName)

This method is static and can be called without an instance.

error

Signature: [const] QFile_FileError error

Description: Method QFile::FileError QFile::error()

exists

Signature: [const] bool exists

Description: Method bool QFile::exists()

Python specific notes:
This attribute is available as '_inst_exists' in Python

Signature: [static] bool exists (string fileName)

Description: Static method bool QFile::exists(const QString &fileName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_exists' in Python

fileName

Signature: [const] string fileName

Description: Method QString QFile::fileName()

Python specific notes:
The object exposes a readable attribute 'fileName'. This is the getter.

fileName=

Signature: void fileName= (string name)

Description: Method void QFile::setFileName(const QString &name)

Python specific notes:
The object exposes a writable attribute 'fileName'. This is the setter. The object exposes a writable attribute 'fileName'. This is the setter.

flush

Signature: bool flush

Description: Method bool QFile::flush()

handle

Signature: [const] int handle

Description: Method int QFile::handle()

isSequential?

Signature: [const] bool isSequential?

Description: Method bool QFile::isSequential()

This is a reimplementation of QIODevice::isSequential

is_const_object?

Signature: [const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

Use of this method is deprecated. Use _is_const_object? instead

link

Signature: bool link (string newName)

Description: Method bool QFile::link(const QString &newName)

Python specific notes:
This attribute is available as '_inst_link' in Python

Signature: [static] bool link (string oldname, string newName)

Description: Static method bool QFile::link(const QString &oldname, const QString &newName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_link' in Python

new

Signature: [static] new QFile new

Description: Constructor QFile::QFile()

This method creates an object of class QFile.

Python specific notes:
This method is the default initializer of the object

Signature: [static] new QFile new (string name)

Description: Constructor QFile::QFile(const QString &name)

This method creates an object of class QFile.

Python specific notes:
This method is the default initializer of the object

Signature: [static] new QFile new (QObject ptr parent)

Description: Constructor QFile::QFile(QObject *parent)

This method creates an object of class QFile.

Python specific notes:
This method is the default initializer of the object

Signature: [static] new QFile new (string name, QObject ptr parent)

Description: Constructor QFile::QFile(const QString &name, QObject *parent)

This method creates an object of class QFile.

Python specific notes:
This method is the default initializer of the object

open

Signature: bool open (QIODevice_QFlags_OpenModeFlag flags)

Description: Method bool QFile::open(QFlags<QIODevice::OpenModeFlag> flags)

This is a reimplementation of QIODevice::open

permissions

Signature: [const] QFile_QFlags_Permission permissions

Description: Method QFlags<QFile::Permission> QFile::permissions()

Python specific notes:
This attribute is available as '_inst_permissions' in Python

Signature: [static] QFile_QFlags_Permission permissions (string filename)

Description: Static method QFlags<QFile::Permission> QFile::permissions(const QString &filename)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_permissions' in Python

pos

Signature: [const] long long pos

Description: Method qint64 QFile::pos()

This is a reimplementation of QIODevice::pos

readChannelFinished

Signature: [signal] void readChannelFinished

Description: Signal declaration for QFile::readChannelFinished()

You can bind a procedure to this signal.

Python specific notes:
The object exposes a readable attribute 'readChannelFinished'. This is the getter. The object exposes a writable attribute 'readChannelFinished'. This is the setter.

readLink

Signature: [const] string readLink

Description: Method QString QFile::readLink()

Python specific notes:
This attribute is available as '_inst_readLink' in Python

Signature: [static] string readLink (string fileName)

Description: Static method QString QFile::readLink(const QString &fileName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_readLink' in Python

readyRead

Signature: [signal] void readyRead

Description: Signal declaration for QFile::readyRead()

You can bind a procedure to this signal.

Python specific notes:
The object exposes a readable attribute 'readyRead'. This is the getter. The object exposes a writable attribute 'readyRead'. This is the setter.

remove

Signature: bool remove

Description: Method bool QFile::remove()

Python specific notes:
This attribute is available as '_inst_remove' in Python

Signature: [static] bool remove (string fileName)

Description: Static method bool QFile::remove(const QString &fileName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_remove' in Python

rename

Signature: bool rename (string newName)

Description: Method bool QFile::rename(const QString &newName)

Python specific notes:
This attribute is available as '_inst_rename' in Python

Signature: [static] bool rename (string oldName, string newName)

Description: Static method bool QFile::rename(const QString &oldName, const QString &newName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_rename' in Python

resize

Signature: bool resize (long long sz)

Description: Method bool QFile::resize(qint64 sz)

Python specific notes:
This attribute is available as '_inst_resize' in Python

Signature: [static] bool resize (string filename, long long sz)

Description: Static method bool QFile::resize(const QString &filename, qint64 sz)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_resize' in Python

seek

Signature: bool seek (long long offset)

Description: Method bool QFile::seek(qint64 offset)

This is a reimplementation of QIODevice::seek

setFileName

Signature: void setFileName (string name)

Description: Method void QFile::setFileName(const QString &name)

Python specific notes:
The object exposes a writable attribute 'fileName'. This is the setter. The object exposes a writable attribute 'fileName'. This is the setter.

setPermissions

Signature: bool setPermissions (QFile_QFlags_Permission permissionSpec)

Description: Method bool QFile::setPermissions(QFlags<QFile::Permission> permissionSpec)

Python specific notes:
This attribute is available as '_inst_setPermissions' in Python

Signature: [static] bool setPermissions (string filename, QFile_QFlags_Permission permissionSpec)

Description: Static method bool QFile::setPermissions(const QString &filename, QFlags<QFile::Permission> permissionSpec)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_setPermissions' in Python

size

Signature: [const] long long size

Description: Method qint64 QFile::size()

This is a reimplementation of QIODevice::size

Python specific notes:
This method is also available as 'len(object)'

staticMetaObject

Signature: [static] QMetaObject staticMetaObject

Description: Obtains the static MetaObject for this class.

symLinkTarget

Signature: [const] string symLinkTarget

Description: Method QString QFile::symLinkTarget()

Python specific notes:
This attribute is available as '_inst_symLinkTarget' in Python

Signature: [static] string symLinkTarget (string fileName)

Description: Static method QString QFile::symLinkTarget(const QString &fileName)

This method is static and can be called without an instance.

Python specific notes:
This attribute is available as '_class_symLinkTarget' in Python

tr

Signature: [static] string tr (string s, string c = 0)

Description: Static method QString QFile::tr(const char *s, const char *c)

This method is static and can be called without an instance.

Signature: [static] string tr (string s, string c, int n)

Description: Static method QString QFile::tr(const char *s, const char *c, int n)

This method is static and can be called without an instance.

trUtf8

Signature: [static] string trUtf8 (string s, string c = 0)

Description: Static method QString QFile::trUtf8(const char *s, const char *c)

This method is static and can be called without an instance.

Signature: [static] string trUtf8 (string s, string c, int n)

Description: Static method QString QFile::trUtf8(const char *s, const char *c, int n)

This method is static and can be called without an instance.

unsetError

Signature: void unsetError

Description: Method void QFile::unsetError()