DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Crée et ouvre un fichier temporaire. Le système fournit un nom de fichier temporaire unique.
Exemple
WEBDEV - Code ServeurPHPAjax
// Récupération de l'identifiant du fichier temporaire
ResFichierTempUnique = fOuvreFichierTemp(foSuppressionAutomatique, "ABC", "C:\MesRépertoires")
SI ResFichierTempUnique = -1 ALORS 
Erreur(ErreurInfo()) 
SINON
fEcritLigne(ResFichierTempUnique, "Compte-rendu du " + DateSys())
...
FIN
WEBDEV - Code ServeurPHPAjax
MonFichierTempUnique est un FichierDisque
MonFichierTempUnique = fOuvreFichierTemp(foSuppressionAutomatique, "ABC", "C:\MesRépertoires")
SI ErreurDétectée ALORS
Erreur(ErreurInfo()) 
SINON
fEcritLigne(MonFichierTempUnique, "Compte-rendu du " + DateSys())
...
FIN
WEBDEV - Code ServeurPHPAjax
// Ouverture d'un fichier temporaire
MonFichierTemporaire est un FichierDisque
ResOuverture est un booléen
ResOuverture = fOuvreFichierTemp(MonFichierTemporaire, foLectureEcriture, "ABC", "C:\MesRépertoires")
SI ResOuverture ALORS
...
FIN
Syntaxe

Créer et ouvrir un fichier temporaire Masquer les détails

<Résultat> = fOuvreFichierTemp([<Mode d'ouverture> [, <Préfixe du fichier temporaire> [, <Répertoire du fichier temporaire>]]])
<Résultat> : Entier ou variable de type FichierDisque
Correspond à :
  • un entier :
    • Identifiant du fichier temporaire. Cet identifiant sera utilisé dans toutes les fonctions de manipulation des fichiers externes.
    • -1 en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
  • une variable de type FichierDisque. En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
    PHP Non disponible.
<Mode d'ouverture> : Constante (ou combinaison de constantes) optionnelle
Constantes permettant de définir le mode d'ouverture du fichier, le mode d'accès au fichier et le mode de blocage du fichier.
  • Mode de blocage du fichier et mode d'ouverture du fichier :
    foBloqueEcritureLes autres applications ne pourront pas modifier le fichier en cours.

    LinuxPHP Cette constante n'est pas disponible.
    foBloqueLectureLes autres applications ne pourront pas lire le fichier en cours.

    LinuxPHP Cette constante n'est pas disponible.
    foSansSuppressionLe fichier ne sera pas automatiquement supprimé à sa fermeture.
    Linux Valeur par défaut.
    foSuppressionAutomatiqueLe fichier est bloqué lors de son ouverture et sera automatiquement supprimé à sa fermeture (appel de la fonction fFerme ou à la fin de l'application).
    Si le fichier a été ouvert par une autre application, il sera supprimé automatiquement par le système lorsque toutes les applications auront fermé le fichier.
    Linux Cette constante n'est pas disponible.
  • Mode d'accès au fichier. Ce type est utilisé par les fonctions fLitLigne et fEcritLigne pour déterminer le type des informations à lire et écrire dans le fichier externe :
    foAnsiFichier de type Ansi. Cette constante permet de gérer un fichier Ansi lorsque le mode "Utiliser les chaînes Unicode en exécution" est activé au niveau de la configuration de projet.
    Mode utilisé par défaut :
    • dans les projets WINDEV et WEBDEV inférieurs à la version 17.
    • dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Ansi en exécution" à partir de la version 17.
    foUnicodeFichier de type Unicode. Cette constante permet de gérer un fichier Unicode lorsque le mode "Utiliser les chaînes Ansi en exécution" est activé au niveau de la configuration de projet.
    Mode utilisé par défaut :
    • dans les projets WINDEV Mobile quels que soient le mode et la version utilisés.
    • dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Unicode en exécution" à partir de la version 17.
    PHP Cette constante n'est pas disponible.
<Préfixe du fichier temporaire> : Chaîne de caractères optionnelle
Préfixe (3 lettres) du nom du fichier temporaire. Ce paramètre permet de préfixer le nom du fichier temporaire. Seules les trois premières lettres seront prises en compte.
WindowsLinuxPHP Ce paramètre peut être au format Ansi ou Unicode.
<Répertoire du fichier temporaire> : Chaîne de caractères optionnelle
Répertoire (complet ou relatif) du fichier temporaire (260 caractères maximum). Un chemin de type UNC peut être utilisé. Ce nom de répertoire peut être terminé indifféremment par le caractère "\" ou non. Ce répertoire doit exister. Dans le cas contraire, une erreur WLangage est affichée.
Si ce paramètre n'est pas précisé, le répertoire par défaut sera :
  • le répertoire temporaire de Windows (si ce répertoire existe sur le poste en cours),
  • le répertoire en cours (si le répertoire temporaire de Windows n'existe pas sur le poste en cours).
WindowsLinuxPHP Ce paramètre peut être au format Ansi ou Unicode.
WEBDEV - Code ServeurAjax

Créer et ouvrir un fichier temporaire dans une variable de type fichierDisque Masquer les détails

<Résultat> = fOuvreFichierTemp(<FichierDisque> [, <Mode d'ouverture> [, <Préfixe du fichier temporaire> [, <Répertoire du fichier temporaire>]]])
<Résultat> : Booléen
  • Vrai si le fichier temporaire a été créé, ouvert et associé à la variable de type FichierDisque,
  • Faux dans le cas contraire. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<FichierDisque> : Variable de type FichierDisque
Nom de la variable FichierDisque qui sera associée au fichier temporaire manipulé.
<Mode d'ouverture> : Constante (ou combinaison de constantes) optionnelle
Constantes permettant de définir le mode d'ouverture du fichier, le mode d'accès au fichier et le mode de blocage du fichier.
  • Mode de blocage du fichier et mode d'ouverture du fichier :
    foBloqueEcritureLes autres applications ne pourront pas modifier le fichier en cours.

    LinuxPHP Cette constante n'est pas disponible.
    foBloqueLectureLes autres applications ne pourront pas lire le fichier en cours.

    LinuxPHP Cette constante n'est pas disponible.
    foSansSuppressionLe fichier ne sera pas automatiquement supprimé à sa fermeture.
    Linux Valeur par défaut.
    foSuppressionAutomatiqueLe fichier est bloqué lors de son ouverture et sera automatiquement supprimé à sa fermeture (appel de la fonction fFerme ou à la fin de l'application).
    Si le fichier a été ouvert par une autre application, il sera supprimé automatiquement par le système lorsque toutes les applications auront fermé le fichier.
    Linux Cette constante n'est pas disponible.
  • Mode d'accès au fichier. Ce type est utilisé par les fonctions fLitLigne et fEcritLigne pour déterminer le type des informations à lire et écrire dans le fichier externe :
    foAnsiFichier de type Ansi. Cette constante permet de gérer un fichier Ansi lorsque le mode "Utiliser les chaînes Unicode en exécution" est activé au niveau de la configuration de projet.
    Mode utilisé par défaut :
    • dans les projets WINDEV et WEBDEV inférieurs à la version 17.
    • dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Ansi en exécution" à partir de la version 17.
    foUnicodeFichier de type Unicode. Cette constante permet de gérer un fichier Unicode lorsque le mode "Utiliser les chaînes Ansi en exécution" est activé au niveau de la configuration de projet.
    Mode utilisé par défaut :
    • dans les projets WINDEV Mobile quels que soient le mode et la version utilisés.
    • dans les configurations de projet WINDEV et WEBDEV utilisant le mode "Utiliser les chaînes Unicode en exécution" à partir de la version 17.
    PHP Cette constante n'est pas disponible.
<Préfixe du fichier temporaire> : Chaîne de caractères optionnelle
Préfixe (3 lettres) du nom du fichier temporaire. Ce paramètre permet de préfixer le nom du fichier temporaire. Seules les trois premières lettres seront prises en compte.
WindowsLinuxPHP Ce paramètre peut être au format Ansi ou Unicode.
<Répertoire du fichier temporaire> : Chaîne de caractères optionnelle
Répertoire (complet ou relatif) du fichier temporaire (260 caractères maximum). Un chemin de type UNC peut être utilisé. Ce nom de répertoire peut être terminé indifféremment par le caractère "\" ou non. Ce répertoire doit exister. Dans le cas contraire, une erreur WLangage est affichée.
Si ce paramètre n'est pas précisé, le répertoire par défaut sera :
  • le répertoire temporaire de Windows (si ce répertoire existe sur le poste en cours),
  • le répertoire en cours (si le répertoire temporaire de Windows n'existe pas sur le poste en cours).
WindowsLinuxPHP Ce paramètre peut être au format Ansi ou Unicode.
Remarques
La fonction fOuvreFichierTemp génère une erreur dans les cas suivants :
  • le répertoire indiqué n'existe pas,
  • le fichier est bloqué par un autre poste ou par une autre application,
  • l'utilisateur n'a pas les droits en lecture ou en écriture sur le fichier à ouvrir.
Classification Métier / UI : Code métier
Composante : wd290std.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 17/11/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale