复制源路径下的文件或目录至目标路径指定的位置。如复制目录，函数将递归复制所有内容至新的位置。该函数不能用于复制LLB中的文件，或复制文件至LLB。


icon

输入/输出

  • cstr.png 对话框窗口（选择或输入文件路径） —

    对话框窗口是在文件对话框的文件或目录列表以及文件夹上方显示的信息。

  • cpath.png 源路径 —

    源路径指定要操作的文件或目录的绝对路径。如指定空路径或相对路径，函数可返回错误。

  • cpath.png 目标路径（使用对话框） —

    目标路径是要操作的文件或文件夹的新的绝对路径（包括新的文件名或文件夹名）。

    如目标路径为空（默认值），函数可显示用于选择文件或文件夹的文件对话框。如指定空路径或相对路径，函数将返回错误。如取消对话框则取消值为TRUE。

  • cbool.png 覆盖(F) —

    覆盖确定函数是否替换目标路径中的现有文件或文件夹。如覆盖包含已编译文件的文件夹，LabVIEW可使该文件移至新文件夹。（macOS和Linux） 即使该参数的值为TRUE，LabVIEW也不会覆盖只读文件。

  • cerrcodeclst.png 错误输入 —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • ipath.png 新路径 —

    新路径指定文件或目录的新位置。

    如操作不成功，函数可设置新路径为<非法路径>。

  • ibool.png 取消 —

    取消如取消文件对话框则值为TRUE。

    否则，即使函数返回错误，取消的值仍为FALSE。

  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

    • 该函数复制原文件或目录，并将副本重命名为目标路径中最后部分指定的名称。如目标路径为现有文件的路径，该函数会返回“路径重复”错误。如目标路径为现有目录，该函数将在现有目录下新建文件或目录，并使用原文件名或目录名来命名。

    例如，如将目录c:\app复制到d:\app2，该函数将新建一个目录d:\app2，内容与c:\app一致。第二次复制该目录时，函数将创建一个新的子目录d:\app2\app，将app中的内容置于该目录下。第三次复制该目录时，函数将返回“重复路径”错误。

    如目标路径为非法路径（例如，指定的上级目录为非法目录），该函数也会返回错误。

    注： 复制或移动文件时，该功能不会自动在文件名后附加文件扩展名（如 .txt）。因此，必须在目标路径中明确指定扩展名作为新文件名的一部分。

    如无权限对目标路径中指定的文件或目录进行写入操作，函数无法对其进行复制并将返回错误。使用设置权限函数，可设置文件或目录的权限。