JUCE v8.0.9
JUCE API
 
Loading...
Searching...
No Matches
juce::AndroidDocumentInfo Class Reference

Some information about a document. More...

#include <juce_AndroidDocument.h>

Collaboration diagram for juce::AndroidDocumentInfo:

Public Member Functions

 AndroidDocumentInfo ()=default
 
bool canCopy () const
 True if this document can be copied.
 
bool canCreateChildren () const
 True if this is a directory and adding child documents is supported.
 
bool canDelete () const
 True if this document can be removed completely from the filesystem.
 
bool canMove () const
 True if this document can be moved.
 
bool canRead () const
 True if this process has permission to read this file.
 
bool canRename () const
 True if this document can be renamed.
 
bool canWrite () const
 True if this is a document that can be written, or a directory that can be modified.
 
bool exists () const
 True if this file really exists.
 
int64 getLastModified () const
 Timestamp when a document was last modified, in milliseconds since January 1, 1970 00:00:00.0 UTC.
 
String getName () const
 The user-facing name.
 
int64 getSizeInBytes () const
 The size of the document in bytes, if known.
 
String getType () const
 The MIME type of this document.
 
bool isDirectory () const
 True if this is a directory rather than a file.
 
bool isFile () const
 True if this is a file rather than a directory.
 
bool isLastModifiedValid () const
 True if the filesystem provided a modification time.
 
bool isSizeInBytesValid () const
 True if the filesystem provided a size in bytes.
 
bool isVirtual () const
 True if this document isn't a physical file on storage.
 

Private Types

enum  {
  flagSupportsWrite = 0x0002 ,
  flagSupportsDelete = 0x0004 ,
  flagDirSupportsCreate = 0x0008 ,
  flagSupportsRename = 0x0040 ,
  flagSupportsCopy = 0x0080 ,
  flagSupportsMove = 0x0100 ,
  flagVirtualDocument = 0x0200
}
 
enum  {
  flagExists = 1 << 0 ,
  flagValidModified = 1 << 1 ,
  flagValidSize = 1 << 2 ,
  flagHasReadPermission = 1 << 3 ,
  flagHasWritePermission = 1 << 4
}
 

Private Member Functions

 AndroidDocumentInfo (Args)
 
bool isJuceFlagSet (int flag) const
 
bool isNativeFlagSet (int flag) const
 

Private Attributes

int juceFlags = 0
 
int64 lastModified = 0
 
String name
 
int nativeFlags = 0
 
int64 sizeInBytes = 0
 
String type
 

Detailed Description

Some information about a document.

Each instance represents some information about the document at the point when the instance was created.

Instance information is not updated automatically. If you think some file information may have changed, create a new instance.

@tags{Core}

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
private
Enumerator
flagSupportsWrite 
flagSupportsDelete 
flagDirSupportsCreate 
flagSupportsRename 
flagSupportsCopy 
flagSupportsMove 
flagVirtualDocument 

◆ anonymous enum

anonymous enum
private
Enumerator
flagExists 
flagValidModified 
flagValidSize 
flagHasReadPermission 
flagHasWritePermission 

Constructor & Destructor Documentation

◆ AndroidDocumentInfo() [1/2]

juce::AndroidDocumentInfo::AndroidDocumentInfo ( )
default

◆ AndroidDocumentInfo() [2/2]

juce::AndroidDocumentInfo::AndroidDocumentInfo ( Args  )
explicitprivate

Member Function Documentation

◆ canCopy()

bool juce::AndroidDocumentInfo::canCopy ( ) const
inline

True if this document can be copied.

References flagSupportsCopy, and isNativeFlagSet().

◆ canCreateChildren()

bool juce::AndroidDocumentInfo::canCreateChildren ( ) const
inline

True if this is a directory and adding child documents is supported.

References flagDirSupportsCreate, and isNativeFlagSet().

◆ canDelete()

bool juce::AndroidDocumentInfo::canDelete ( ) const
inline

True if this document can be removed completely from the filesystem.

References flagSupportsDelete, and isNativeFlagSet().

◆ canMove()

bool juce::AndroidDocumentInfo::canMove ( ) const
inline

True if this document can be moved.

References flagSupportsMove, and isNativeFlagSet().

◆ canRead()

bool juce::AndroidDocumentInfo::canRead ( ) const
inline

True if this process has permission to read this file.

If this returns true, and the AndroidDocument refers to a file rather than a directory, then AndroidDocument::createInputStream should work on this document.

References flagHasReadPermission, isJuceFlagSet(), juce::String::isNotEmpty(), and type.

◆ canRename()

bool juce::AndroidDocumentInfo::canRename ( ) const
inline

True if this document can be renamed.

References flagSupportsRename, and isNativeFlagSet().

◆ canWrite()

bool juce::AndroidDocumentInfo::canWrite ( ) const
inline

True if this is a document that can be written, or a directory that can be modified.

If this returns true, and the AndroidDocument refers to a file rather than a directory, then AndroidDocument::createOutputStream should work on this document.

References flagDirSupportsCreate, flagHasWritePermission, flagSupportsDelete, flagSupportsWrite, isJuceFlagSet(), isNativeFlagSet(), juce::String::isNotEmpty(), and type.

◆ exists()

bool juce::AndroidDocumentInfo::exists ( ) const
inline

True if this file really exists.

References flagExists, and isJuceFlagSet().

◆ getLastModified()

int64 juce::AndroidDocumentInfo::getLastModified ( ) const
inline

Timestamp when a document was last modified, in milliseconds since January 1, 1970 00:00:00.0 UTC.

Use isLastModifiedValid() to determine whether or not the result of this function is valid.

References flagValidModified, isJuceFlagSet(), and lastModified.

◆ getName()

String juce::AndroidDocumentInfo::getName ( ) const
inline

The user-facing name.

This may or may not contain a file extension. For files identified by a URL, the MIME type is stored separately.

References name.

◆ getSizeInBytes()

int64 juce::AndroidDocumentInfo::getSizeInBytes ( ) const
inline

The size of the document in bytes, if known.

Use isSizeInBytesValid() to determine whether or not the result of this function is valid.

References flagValidSize, isJuceFlagSet(), and sizeInBytes.

◆ getType()

String juce::AndroidDocumentInfo::getType ( ) const
inline

The MIME type of this document.

References isDirectory(), and type.

◆ isDirectory()

bool juce::AndroidDocumentInfo::isDirectory ( ) const

True if this is a directory rather than a file.

Referenced by getType(), and isFile().

◆ isFile()

bool juce::AndroidDocumentInfo::isFile ( ) const
inline

True if this is a file rather than a directory.

References isDirectory(), juce::String::isNotEmpty(), and type.

◆ isJuceFlagSet()

bool juce::AndroidDocumentInfo::isJuceFlagSet ( int  flag) const
inlineprivate

◆ isLastModifiedValid()

bool juce::AndroidDocumentInfo::isLastModifiedValid ( ) const
inline

True if the filesystem provided a modification time.

References flagValidModified, and isJuceFlagSet().

◆ isNativeFlagSet()

bool juce::AndroidDocumentInfo::isNativeFlagSet ( int  flag) const
inlineprivate

◆ isSizeInBytesValid()

bool juce::AndroidDocumentInfo::isSizeInBytesValid ( ) const
inline

True if the filesystem provided a size in bytes.

References flagValidSize, and isJuceFlagSet().

◆ isVirtual()

bool juce::AndroidDocumentInfo::isVirtual ( ) const
inline

True if this document isn't a physical file on storage.

References flagVirtualDocument, and isNativeFlagSet().

Member Data Documentation

◆ juceFlags

int juce::AndroidDocumentInfo::juceFlags = 0
private

Referenced by isJuceFlagSet().

◆ lastModified

int64 juce::AndroidDocumentInfo::lastModified = 0
private

Referenced by getLastModified().

◆ name

String juce::AndroidDocumentInfo::name
private

Referenced by getName().

◆ nativeFlags

int juce::AndroidDocumentInfo::nativeFlags = 0
private

Referenced by isNativeFlagSet().

◆ sizeInBytes

int64 juce::AndroidDocumentInfo::sizeInBytes = 0
private

Referenced by getSizeInBytes().

◆ type

String juce::AndroidDocumentInfo::type
private

Referenced by canRead(), canWrite(), getType(), and isFile().


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