Document Class
Description
.creationDate
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.creationDate : Date
Description
The .creationDate
property returns the creation date of the file.
Cette propriété est en lecture seule.
.creationTime
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.creationTime : Time
Description
The .creationTime
property returns the creation time of the file (expressed as a number of seconds beginning at 00:00).
Cette propriété est en lecture seule.
.exists
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.exists : Boolean
Description
The .exists
property returns true if the file exists on disk, and false otherwise.
Cette propriété est en lecture seule.
.extension
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.extension : Text
Description
The .extension
property returns the extension of the file name (if any). Une extension commence toujours par ".". La propriété renvoie une chaîne vide si le nom du fichier n'a pas d'extension.
Cette propriété est en lecture seule.
.fullName
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.fullName : Text
Description
The .fullName
property returns the full name of the file, including its extension (if any).
Cette propriété est en lecture seule.
.hidden
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.hidden : Boolean
Description
The .hidden
property returns true if the file is set as "hidden" at the system level, and false otherwise.
This property is read/write.
.isAlias
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.isAlias : Boolean
Description
The .isAlias
property returns true if the file is an alias, a shortcut, or a symbolic link, and false otherwise.
Cette propriété est en lecture seule.
.isFile
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.isFile : Boolean
Description
The .isFile
property returns always true for a file.
Cette propriété est en lecture seule.
.isFolder
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.isFolder : Boolean
Description
The .isFolder
property returns always false for a file.
Cette propriété est en lecture seule.
.isWritable
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.isWritable : Boolean
Description
The .isWritable
property returns true if the file exists on disk and is writable.
The property checks the ability of the 4D application to write on the disk (access rights), it does not solely rely on the writable attribute of the file.
Cette propriété est en lecture seule.
Example
$myFile:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)
If($myFile.isWritable)
$myNewFile:=$myFile.setText("Added text")
End if
.modificationDate
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.modificationDate : Date
Description
The .modificationDate
property returns the date of the file's last modification.
Cette propriété est en lecture seule.
.modificationTime
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.modificationTime : Time
Description
The .modificationTime
property returns the time of the file's last modification (expressed as a number of seconds beginning at 00:00).
Cette propriété est en lecture seule.
.name
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.name : Text
Description
The .name
property returns the name of the file without extension (if any).
Cette propriété est en lecture seule.
.original
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.original : 4D.File
.original : 4D.Folder
Description
The .original
property returns the target element for an alias, a shortcut, or a symbolic link file. L'élément cible peut être :
- un objet File
- un objet Folder
Pour les fichiers sans alias, la propriété retourne le même objet File que le fichier.
Cette propriété est en lecture seule.
.parent
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.parent : 4D.Folder
Description
The .parent
property returns the parent folder object of the file. Si le chemin représente un filesystem (ex : "/DATA/"), le filesystem est retourné.
Cette propriété est en lecture seule.
.path
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.path : Text
Description
The .path
property returns the POSIX path of the file. Si le chemin représente un filesystem (ex : "/DATA/"), le filesystem est retourné.
Cette propriété est en lecture seule.
.platformPath
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.platformPath : Text
Description
The .platformPath
property returns the path of the file expressed with the current platform syntax.
Cette propriété est en lecture seule.
.size
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.size : Real
Description
The .size
property returns the size of the file expressed in bytes. Si le fichier n'existe pas sur le disque, la taille est de 0.
Cette propriété est en lecture seule.
.copyTo()
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.copyTo( destinationFolder : 4D.Folder { ; newName : Text } { ; overwrite : Integer } ) : 4D.File
Paramètres | Type | Description | |
---|---|---|---|
dossierDestination | 4D.Folder | -> | Dossier de destination |
nouveauNom | Text | -> | Nom de la copie |
overwrite | Integer | -> | fk overwrite to replace existing elements |
Résultat | 4D.File | <- | Fichier copié |
Description
The .copyTo()
function copies the File
object into the specified destinationFolder .
The destinationFolder must exist on disk, otherwise an error is generated.
Par défaut, le fichier est copié avec le nom du fichier original. If you want to rename the copy, pass the new name in the newName parameter. Le nouveau nom doit être conforme aux règles de nommage (ex : il ne doit pas contenir de caractères tels que ":", "/", etc.), sinon une erreur est retournée.
If a file with the same name already exists in the destinationFolder, by default 4D generates an error. You can pass the fk overwrite
constant in the overwrite parameter to ignore and overwrite the existing file
Constante | Valeur | Commentaire |
---|---|---|
fk overwrite | 4 | Écrase les éléments existants, le cas échéant |
Valeur retournée
The copied File
object.
Exemple
You want to copy a picture file from the user's document folder to the application folder:
var $source; $copy : Object
$source:=Folder(fk documents folder).file("Pictures/photo.png")
$copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite)
.getContent()
Historique
Release | Modifications |
---|---|
19 R2 | Retourne 4D.Blob |
17 R5 | Ajout |
.getContent( ) : 4D.Blob
Paramètres | Type | Description | |
---|---|---|---|
Résultat | 4D.Blob | <- | Contenu du fichier |
Description
The .getContent()
function returns a 4D.Blob
object containing the entire content of a file. For information on BLOBs, please refer to the BLOB section.
Valeur retournée
A 4D.Blob
object.
Exemple
To save a document's contents in a BLOB
field:
var $vPath : Text
$vPath:=Select document("";"*";"Select a document";0)
If(OK=1) //Si un document a été sélectionné
[aTable]aBlobField:=File($vPath;fk platform path).getContent()
End if
.getIcon()
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.getIcon( { size : Integer } ) : Picture
Paramètres | Type | Description | |
---|---|---|---|
size | Integer | -> | Longueur du côté de l'image retournée (pixels) |
Résultat | Picture | <- | Icône |
Description
The .getIcon()
function returns the icon of the file.
The optional size parameter specifies the dimensions in pixels of the returned icon. Cette valeur représente la longueur latérale du côté du carré contenant l'icône. La taille des icônes est généralement de 32x32 pixels (“grandes icônes”) ou de 16x16 pixels (“petites icônes”). Si vous passez 0 ou si vous omettez ce paramètre, la version "grandes icônes" est retournée.
Si le fichier n'existe pas sur disque, une icône par défaut vide est retournée.
Valeur retournée
File icon picture.
.getText()
Historique
Release | Modifications |
---|---|
17 R5 | Ajout |
.getText( { charSetName : Text { ; breakMode : Integer } } ) : Text
.getText( { charSetNum : Integer { ; breakMode : Integer } } ) : Text
Paramètres | Type | Description | |
---|---|---|---|
charSetName | Text | -> | Nom du jeu de caractères |
charSetNum | Integer | -> | Numéro du jeu de caractères |
breakMode | Integer | -> | Mode de traitement des retours à la ligne |
Résultat | Text | <- | Texte du document |
Description
The .getText()
function returns the contents of the file as text .
Optionnellement, vous pouvez indiquer le jeu de caractères à utiliser pour la lecture du contenu. Vous pouvez passer soit :
- in charSetName, a string containing the standard set name (for example "ISO-8859-1" or "UTF-8"),
- or in charSetNum, the MIBEnum ID (number) of the standard set name.
For the list of character sets supported by 4D, refer to the description of the
CONVERT FROM TEXT
command.
If the document contains a Byte Order Mark (BOM), 4D uses the character set that it has set instead of the one specified in charSetName or charSetNum (this parameter is then ignored). If the document does not contain a BOM and if charSetName or charSetNum is omitted, by default 4D uses the "UTF-8" character set.
In breakMode, you can pass a number indicating the processing to apply to end-of-line characters in the document. Les constantes suivantes du thème "Documents système" sont disponibles :
Constante | Valeur | Commentaire |
---|---|---|
Document unchanged | 0 | Aucun traitement |
Document with native format | 1 | (Défaut) Les fins de ligne sont convertis au format natif de la plate-forme d’exécution : CR (carriage return) sous OS X, CRLF (carriage return + line feed) sous Windows |
Document with CRLF | 2 | Les fins de ligne sont convertis au format Windows : CRLF (carriage return + line feed) |
Document with CR | 3 | Les fins de ligne sont convertis au format OS X : CR (carriage return) |
Document with LF | 4 | Les fins de ligne sont convertis au format Unix : LF (line feed) |
By default, when you omit the breakMode parameter, line breaks are processed in native mode (1).
Valeur retournée
Texte du fichier.
Exemple
Considérons le document texte suivant (les champs sont séparés par des tabulations ) :
id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6
Lorsque vous exécutez ce code :
$myFile:=Folder(fk documents folder).file("Billing.txt") //UTF-8 par défaut
$txt:=$myFile.getText()
... you get the following for $txt
:
"id\tname\tprice\tvat\r\n3\tthé\t1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"
with \t
(tab) as separator and \r\n
(CRLF) as line delimiter.
Voici un autre exemple avec le même fichier, mais un délimiteur de ligne différent :
$txt:=$myFile.getText("UTF-8"; Document with LF)
In this case, the contents of $txt
are as follows:
"id\tname\tprice\tvat\n3\tthé\t1.06€\t19.6\n2\tcafé\t1.05€\t19.6"
This time \n
(LF) is used as line delimiter.