FPOPEN |
Ouvrir |
|---|---|
| Free Pascal | BaseUnix |
Syntaxe
| Function FpOpen(path:PChar;flags:cInt;Mode:TMode):cInt; |
| Function FpOpen(path:PChar;flags:cint):cint; |
| Function FpOpen(path:AnsiString;flags:cint):cint; |
| Function FpOpen(path:AnsiString;flags:cint;Mode:TMode):cint; |
| Function FpOpen(path:String;flags:cint):cint; |
| Function FpOpen(path:String;flags:cint;Mode:TMode):cint; |
Paramètres
| Nom | Description | |
|---|---|---|
| path | Ce paramètre permet d'indiquer le nom du fichier à ouvrir. | |
| Mode | Ce paramètre permet d'indiquer le mode d'ouverture du fichier : | |
| Constante | Description | |
| O_RdOnly | Cette constante permet d'indiquer qu'il faut ouvrir le fichier en lecture seulement. | |
| O_WrOnly | Cette constante permet d'indiquer qu'il faut ouvrir le fichier en écriture seulement. | |
| O_RdWr | Cette constante permet d'indiquer qu'il faut ouvrir le fichier en lecture et écriture. | |
| flags | Ce paramètre permet d'indiquer les options à appliquer à la l'ouverture du fichier. On peut combiner avec un «OR» les constantes suivantes : | |
| Constante | Description | |
| O_Creat | Cette constante permet d'indiquer que le fichier doit être créé s'il n'existe pas. | |
| O_Excl | Cette constante permet d'indiquer que si le fichier est ouvert avec la constante «O_Creat» et qu'il existe déjà, il faut provoquer un échec. | |
| O_NoCtty | Cette constante permet d'indiquer que si le fichier est un périphérique de terminal, il ne deviendra pas le processus de contrôle du terminal. | |
| O_Trunc | Cette constante permet d'indiquer que si le fichier existe, il doit être tronqué. | |
| O_Append | Cette constante permet d'indiquer que le fichier doit être ouvert en mode ajout. | |
| O_NonBlock | Cette constante permet d'indiquer que le fichier est ouvert en mode sans bloc. | |
| O_NDelay | Cette constante permet d'indiquer que le fichier est ouvert en mode sans bloc. | |
| O_Sync | Cette constante permet d'indiquer que le fichier est ouvert pour la synchronisation d'entrée/sortie. | |
| O_NoFollow | Cette constante permet d'indiquer que si le fichier est un lien symbolique, un échec est provoqué. Disponible à partir du noyau de Linux 2.1.126. | |
| O_Directory | Cette constante permet d'indiquer que si le fichier n'est pas un répertoire, un échec est provoqué. Disponible à partir du noyau de Linux 2.1.126. | |
Retour
| Valeur | Description |
|---|---|
| Supérieur à 0 | Ces valeurs permettent d'indiquer l'identificateur Handle du fichier ouvert avec succès. |
| Inférieur à 0 | Ces valeurs permettent d'indiquer qu'une erreur s'est produite. |
Description
Cette fonction permet d'ouvrir un fichier et retourne un descripteur de fichier. Le chemin indiqué pour l'ouverture du fichier dans la fonction FpOpen peuvent être de type de données PChar (chaîne de caractères de style C) ou String (standard au Pascal). Le paramètre mode est facultatif et spécifie les autorisations à définir lors de l'ouverture du fichier. Il est modifié par l'option umask du système d'exploitation. Ainsi, les autorisations réelles sont indiqués par mode et non pas umask. La valeur de retour de la fonction est une valeur de descripteur de fichier, ou une valeur négative en cas d'erreur.
Remarques
- Des informations étendues sur l'erreur s'étend produite peuvent être demandé à la fonction fpGetErrno.
- L'unité BaseUnix a été intégré par Marco Van de Voort. Il contient les fonctionnalités de base du système d'exploitation Unix. Il remplace l'unité Linux de la version 1.0.X du compilateur, mais intègre uniquement un sous-ensemble nettoyé et portable de cette unité. De plus, puisqu'il est destiné au système d'exploitation Unix à l'origine, il n'est pas supporté ou disponible pour tous les systèmes d'exploitation.
Dernière mise à jour : Samedi, le 18 juillet 2015