Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
Loading...
Searching...
No Matches
QIOSFileEngineAssetsLibrary Class Reference

#include <qiosfileengineassetslibrary.h>

+ Inheritance diagram for QIOSFileEngineAssetsLibrary:
+ Collaboration diagram for QIOSFileEngineAssetsLibrary:

Public Member Functions

 QIOSFileEngineAssetsLibrary (const QString &fileName)
 
 ~QIOSFileEngineAssetsLibrary ()
 
bool open (QIODevice::OpenMode openMode, std::optional< QFile::Permissions > permissions) override
 Opens the file in the specified mode.
 
bool close () override
 Closes the file, returning true if successful; otherwise returns false.
 
FileFlags fileFlags (FileFlags type) const override
 This function should return the set of OR'd flags that are true for the file engine's file, and that are in the type's OR'd members.
 
qint64 size () const override
 Returns the size of the file.
 
qint64 read (char *data, qint64 maxlen) override
 Reads a number of characters from the file into data.
 
qint64 pos () const override
 Returns the current file position.
 
bool seek (qint64 pos) override
 Sets the file position to the given offset.
 
QString fileName (FileName file) const override
 Return the file engine's current file name in the format specified by file.
 
void setFileName (const QString &file) override
 Sets the file engine's file name to file.
 
IteratorUniquePtr beginEntryList (const QString &path, QDir::Filters filters, const QStringList &filterNames) override
 Returns a QAbstractFileEngine::IteratorUniquePtr, that can be used to iterate over the entries in path, using filters for entry filtering and filterNames for name filtering.
 
void setError (QFile::FileError error, const QString &str)
 
- Public Member Functions inherited from QAbstractFileEngine
virtual ~QAbstractFileEngine ()
 Destroys the QAbstractFileEngine.
 
virtual bool flush ()
 Flushes the open file, returning true if successful; otherwise returns false.
 
virtual bool syncToDisk ()
 
virtual bool isSequential () const
 Returns true if the file is a sequential access device; returns false if the file is a direct access device.
 
virtual bool remove ()
 Requests that the file is deleted from the file system.
 
virtual bool copy (const QString &newName)
 Copies the contents of this file to a file with the name newName.
 
virtual bool rename (const QString &newName)
 Requests that the file be renamed to newName in the file system.
 
virtual bool renameOverwrite (const QString &newName)
 
virtual bool link (const QString &newName)
 Creates a link from the file currently specified by fileName() to newName.
 
virtual bool mkdir (const QString &dirName, bool createParentDirectories, std::optional< QFile::Permissions > permissions=std::nullopt) const
 Requests that the directory dirName be created with the specified permissions.
 
virtual bool rmdir (const QString &dirName, bool recurseParentDirectories) const
 Requests that the directory dirName is deleted from the file system.
 
virtual bool setSize (qint64 size)
 Requests that the file be set to size size.
 
virtual bool caseSensitive () const
 Should return true if the underlying file system is case-sensitive; otherwise return false.
 
virtual bool isRelativePath () const
 Return true if the file referred to by this file engine has a relative path; otherwise return false.
 
virtual QStringList entryList (QDir::Filters filters, const QStringList &filterNames) const
 Requests that a list of all the files matching the filters list based on the filterNames in the file engine's directory are returned.
 
virtual bool setPermissions (uint perms)
 Requests that the file's permissions be set to perms.
 
virtual QByteArray id () const
 
virtual uint ownerId (FileOwner) const
 If owner is OwnerUser return the ID of the user who owns the file.
 
virtual QString owner (FileOwner) const
 If owner is OwnerUser return the name of the user who owns the file.
 
virtual bool setFileTime (const QDateTime &newDate, QFile::FileTime time)
 
virtual QDateTime fileTime (QFile::FileTime time) const
 If time is BirthTime, return when the file was born (created).
 
virtual int handle () const
 Returns the native file handle for this file engine.
 
virtual bool cloneTo (QAbstractFileEngine *target)
 
bool atEnd () const
 
ucharmap (qint64 offset, qint64 size, QFile::MemoryMapFlags flags)
 
bool unmap (uchar *ptr)
 
virtual IteratorUniquePtr endEntryList ()
 
virtual qint64 readLine (char *data, qint64 maxlen)
 This function reads one line, terminated by a '\n' character, from the file info data.
 
virtual qint64 write (const char *data, qint64 len)
 Writes len bytes from data to the file.
 
QFile::FileError error () const
 Returns the QFile::FileError that resulted from the last failed operation.
 
QString errorString () const
 Returns the human-readable message appropriate to the current error reported by error().
 
virtual bool extension (Extension extension, const ExtensionOption *option=nullptr, ExtensionReturn *output=nullptr)
 
virtual bool supportsExtension (Extension extension) const
 

Additional Inherited Members

- Public Types inherited from QAbstractFileEngine
enum  FileFlag {
  ReadOwnerPerm = 0x4000 , WriteOwnerPerm = 0x2000 , ExeOwnerPerm = 0x1000 , ReadUserPerm = 0x0400 ,
  WriteUserPerm = 0x0200 , ExeUserPerm = 0x0100 , ReadGroupPerm = 0x0040 , WriteGroupPerm = 0x0020 ,
  ExeGroupPerm = 0x0010 , ReadOtherPerm = 0x0004 , WriteOtherPerm = 0x0002 , ExeOtherPerm = 0x0001 ,
  LinkType = 0x10000 , FileType = 0x20000 , DirectoryType = 0x40000 , BundleType = 0x80000 ,
  HiddenFlag = 0x0100000 , LocalDiskFlag = 0x0200000 , ExistsFlag = 0x0400000 , RootFlag = 0x0800000 ,
  Refresh = 0x1000000 , PermsMask = 0x0000FFFF , TypesMask = 0x000F0000 , FlagsMask = 0x0FF00000 ,
  FileInfoAll = FlagsMask | PermsMask | TypesMask
}
 The permissions and types of a file, suitable for OR'ing together. More...
 
enum  FileName {
  DefaultName , BaseName , PathName , AbsoluteName ,
  AbsolutePathName , AbsoluteLinkTarget , CanonicalName , CanonicalPathName ,
  BundleName , JunctionName , RawLinkPath , NFileNames
}
 These values are used to request a file name in a particular format. More...
 
enum  FileOwner { OwnerUser , OwnerGroup }
 \value OwnerUser The user who owns the file. More...
 
enum  Extension { AtEndExtension , FastReadLineExtension , MapExtension , UnMapExtension }
 
typedef QAbstractFileEngineIterator Iterator
 
using IteratorUniquePtr = std::unique_ptr<Iterator>
 
- Static Public Member Functions inherited from QAbstractFileEngine
static std::unique_ptr< QAbstractFileEnginecreate (const QString &fileName)
 Creates and returns a QAbstractFileEngine suitable for processing fileName.
 
- Protected Member Functions inherited from QAbstractFileEngine
void setError (QFile::FileError error, const QString &str)
 Sets the error type to error, and the error string to errorString.
 
 QAbstractFileEngine ()
 Constructs a new QAbstractFileEngine that does not refer to any file or directory.
 
 QAbstractFileEngine (QAbstractFileEnginePrivate &)
 
- Protected Attributes inherited from QAbstractFileEngine
QScopedPointer< QAbstractFileEnginePrivated_ptr
 

Detailed Description

Definition at line 15 of file qiosfileengineassetslibrary.h.

Constructor & Destructor Documentation

◆ QIOSFileEngineAssetsLibrary()

QIOSFileEngineAssetsLibrary::QIOSFileEngineAssetsLibrary ( const QString & fileName)

Definition at line 303 of file qiosfileengineassetslibrary.mm.

References fileName, and setFileName().

+ Here is the call graph for this function:

◆ ~QIOSFileEngineAssetsLibrary()

QIOSFileEngineAssetsLibrary::~QIOSFileEngineAssetsLibrary ( )

Definition at line 310 of file qiosfileengineassetslibrary.mm.

References close().

+ Here is the call graph for this function:

Member Function Documentation

◆ beginEntryList()

QAbstractFileEngine::IteratorUniquePtr QIOSFileEngineAssetsLibrary::beginEntryList ( const QString & path,
QDir::Filters filters,
const QStringList & filterNames )
overridevirtual

Returns a QAbstractFileEngine::IteratorUniquePtr, that can be used to iterate over the entries in path, using filters for entry filtering and filterNames for name filtering.

This function is called by QDirListing to initiate directory iteration.

See also
QDirListing

Reimplemented from QAbstractFileEngine.

Definition at line 442 of file qiosfileengineassetslibrary.mm.

References filters.

◆ close()

bool QIOSFileEngineAssetsLibrary::close ( )
overridevirtual

Closes the file, returning true if successful; otherwise returns false.

The default implementation always returns false.

Reimplemented from QAbstractFileEngine.

Definition at line 332 of file qiosfileengineassetslibrary.mm.

References QObject::deleteLater().

Referenced by ~QIOSFileEngineAssetsLibrary(), and setFileName().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ fileFlags()

QAbstractFileEngine::FileFlags QIOSFileEngineAssetsLibrary::fileFlags ( FileFlags type) const
overridevirtual

This function should return the set of OR'd flags that are true for the file engine's file, and that are in the type's OR'd members.

In your reimplementation you can use the type argument as an optimization hint and only return the OR'd set of members that are true and that match those in type; in other words you can ignore any members not mentioned in type, thus avoiding some potentially expensive lookups or system calls.

See also
setFileName()

Reimplemented from QAbstractFileEngine.

Definition at line 343 of file qiosfileengineassetslibrary.mm.

References QFileSelector::allSelectors(), QAbstractFileEngine::DirectoryType, QString::endsWith(), QAbstractFileEngine::ExistsFlag, QAbstractFileEngine::FileType, QAbstractFileEngine::FlagsMask, g_iteratorCurrentUrl, QAbstractFileEngine::PermsMask, QAbstractFileEngine::ReadGroupPerm, QAbstractFileEngine::ReadOtherPerm, QAbstractFileEngine::ReadOwnerPerm, QAbstractFileEngine::ReadUserPerm, selector, QString::startsWith(), and QAbstractFileEngine::TypesMask.

+ Here is the call graph for this function:

◆ fileName()

QString QIOSFileEngineAssetsLibrary::fileName ( FileName file) const
overridevirtual

Return the file engine's current file name in the format specified by file.

If you don't handle some FileName possibilities, return the file name set in setFileName() when an unhandled format is requested.

See also
setFileName(), FileName

Reimplemented from QAbstractFileEngine.

Definition at line 418 of file qiosfileengineassetslibrary.mm.

References file, and Q_UNUSED.

◆ open()

bool QIOSFileEngineAssetsLibrary::open ( QIODevice::OpenMode openMode,
std::optional< QFile::Permissions > permissions )
overridevirtual

Opens the file in the specified mode.

Returns true if the file was successfully opened; otherwise returns false.

The mode is an OR combination of QIODevice::OpenMode and QIODevice::HandlingMode values.

If the file is created as a result of this call, its permissions are set according to permissision. Null value means an implementation- specific default.

Reimplemented from QAbstractFileEngine.

Definition at line 322 of file qiosfileengineassetslibrary.mm.

References Q_UNUSED, QIODeviceBase::Text, and QIODeviceBase::WriteOnly.

◆ pos()

qint64 QIOSFileEngineAssetsLibrary::pos ( ) const
overridevirtual

Returns the current file position.

This is the position of the data read/write head of the file.

Reimplemented from QAbstractFileEngine.

Definition at line 405 of file qiosfileengineassetslibrary.mm.

Referenced by seek().

+ Here is the caller graph for this function:

◆ read()

qint64 QIOSFileEngineAssetsLibrary::read ( char * data,
qint64 maxlen )
overridevirtual

Reads a number of characters from the file into data.

At most maxlen characters will be read.

Returns -1 if a fatal error occurs, or 0 if there are no bytes to read.

Reimplemented from QAbstractFileEngine.

Definition at line 383 of file qiosfileengineassetslibrary.mm.

References QAbstractFileEngine::error(), qMin(), QFileDevice::ReadError, setError(), and size().

+ Here is the call graph for this function:

◆ seek()

bool QIOSFileEngineAssetsLibrary::seek ( qint64 offset)
overridevirtual

Sets the file position to the given offset.

Returns true if the position was successfully set; otherwise returns false.

The offset is from the beginning of the file, unless the file is sequential.

See also
isSequential()

Reimplemented from QAbstractFileEngine.

Definition at line 410 of file qiosfileengineassetslibrary.mm.

References pos(), and size().

+ Here is the call graph for this function:

◆ setError()

void QIOSFileEngineAssetsLibrary::setError ( QFile::FileError error,
const QString & str )
inline

Definition at line 36 of file qiosfileengineassetslibrary.h.

References QAbstractFileEngine::error(), QAbstractFileEngine::setError(), and str.

Referenced by read().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ setFileName()

void QIOSFileEngineAssetsLibrary::setFileName ( const QString & file)
overridevirtual

Sets the file engine's file name to file.

This file name is the file that the rest of the virtual functions will operate on.

See also
rename()

Reimplemented from QAbstractFileEngine.

Definition at line 424 of file qiosfileengineassetslibrary.mm.

References close(), and file.

Referenced by QIOSFileEngineAssetsLibrary().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ size()

qint64 QIOSFileEngineAssetsLibrary::size ( ) const
overridevirtual

Returns the size of the file.

Reimplemented from QAbstractFileEngine.

Definition at line 376 of file qiosfileengineassetslibrary.mm.

References size().

Referenced by read(), seek(), and size().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

The documentation for this class was generated from the following files: