Copie le fichier ou le répertoire désigné par chemin de la source à l'emplacement désigné par chemin de la cible. Si vous copiez un répertoire, cette fonction copie tout son contenu au nouvel emplacement et ce, de façon récursive. Vous ne pouvez pas utiliser cette fonction pour copier des fichiers vers ou à partir d'une LLB.


icon

Entrées/Sorties

  • cstr.png message (sélectionnez ou entrez le chemin de destination de la copie) —

    message est le message qui apparaît au-dessous de la liste des fichiers et des répertoires, ou dossier, dans la boîte de dialogue de fichier.

  • cpath.png chemin de la source —

    chemin de la source spécifie un chemin absolu vers le fichier ou le répertoire sur lequel vous voulez travailler. Si vous spécifiez un chemin vide ou relatif, cette fonction renvoie une erreur.

  • cpath.png chemin de la cible (utiliser une boîte de dialogue) —

    chemin de la cible est le nouveau chemin absolu du fichier ou du dossier sur lequel vous souhaitez travailler (ce chemin comprend le nom du nouveau fichier ou dossier).

    Si le chemin de la cible est vide (valeur par défaut), la fonction affiche une boîte de dialogue dans laquelle vous pouvez sélectionner un fichier ou un dossier. Si vous spécifiez un chemin vide ou relatif, cette fonction renvoie une erreur. annulé est VRAI si vous cliquez sur Annuler dans la boîte de dialogue.

  • cbool.png écraser (F) —

    écraser détermine si la fonction remplace des dossiers ou des fichiers existants dans le chemin cible. Si vous écrasez un dossier qui contient des fichiers uniques, LabVIEW déplace ces fichiers dans un nouveau dossier. (macOS et Linux) LabVIEW n'écrase pas les fichiers en lecture seule, même si vous définissez ce paramètre à VRAI.

  • cerrcodeclst.png entrée d'erreur —

    entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.

  • ipath.png nouveau chemin —

    nouveau chemin spécifie le nouvel emplacement du fichier ou du répertoire.

    Si l'opération échoue, cette fonction définit nouveau chemin à <Pas un chemin>.

  • ibool.png annulé —

    annulé est VRAI si vous cliquez sur Annuler dans la boîte de dialogue de fichier.

    Sinon, annulé est FAUX même si cette fonction renvoie une erreur.

  • ierrcodeclst.png sortie d'erreur —

    sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.

    • Cette fonction copie le fichier ou le répertoire d'origine et renomme la copie en utilisant le nom que vous avez spécifié dans le dernier élément de chemin de la cible. Si chemin de la cible est le chemin d'accès à un fichier existant, cette fonction renvoie une erreur de chemin dupliqué. Si chemin de la cible est le chemin d'accès à un répertoire existant, cette fonction place le nouveau fichier ou le nouveau répertoire dans le répertoire existant en utilisant le nom du fichier ou du répertoire d'origine.

    Par exemple, si vous copiez le répertoire c:\app à d:\app2, la fonction crée un nouveau répertoire d:\app2 avec le même contenu que c:\app. La deuxième fois que vous copiez ce répertoire, la fonction crée un nouveau sous-répertoire d:\app2\app dans lequel elle place le contenu de app. La troisième fois que vous copiez ce répertoire, la fonction renvoie un erreur de chemin dupliqué.

    Cette fonction renvoie aussi une erreur si chemin de la cible n'est pas un chemin valide, comme par exemple, lorsque le répertoire parent spécifié n'est pas valide.

    Remarque Cette fonction n'ajoute pas automatiquement les extensions de fichiers, telles que .txt, aux noms de fichiers lorsqu'elle copie ou déplace des fichiers. Vous devez inclure l'extension de manière explicite dans le nouveau nom de fichier que vous spécifiez dans chemin de la cible.

    Si vous n'avez pas d'autorisation d'écriture pour le fichier ou le répertoire que vous spécifiez dans chemin de la cible, cette fonction ne copie pas le fichier ou le répertoire et renvoie une erreur. Utilisez la fonction Définir les autorisations pour définir les autorisations d'un fichier ou d'un répertoire.