R语言:normalizePath()函数中文帮助文档(中英文对照)

loveR

normalizePath(base)
normalizePath()所属R语言包：base

                                        Express File Paths in Canonical Form
                                         表达范式的文件路径

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Convert file paths to canonical form for the platform, to display them in a user-understandable form and so that relative and absolute paths can be compared.
文件路径转换为平台，以规范的形式，显示在用户理解的形式，所以可以比较的相对路径和绝对路径。


用法----------Usage----------


normalizePath(path, winslash = "\\", mustWork = NA)



参数----------Arguments----------

参数：path
character vector of file paths.
文件路径的特征向量。


参数：winslash
the separator to be used on Windows – ignored elsewhere.  Must be one of c("/", "\\").
Windows上使用的分隔符 - 忽略其他地方。必须c("/", "\\")之一。


参数：mustWork
logical: if TRUE then an error is given if the result cannot be determined; if NA then a warning.
逻辑：如果TRUE然后一个错误，如果不能确定结果;如果NA然后一个警告。


Details

详情----------Details----------

Tilde-expansion (see path.expand) is first done on paths (as from R 2.13.0).
波浪线膨胀（见path.expand）paths（2.13.0从R）是第一次做。

Where the Unix-alike platform supports it attempts to turn paths into absolute paths in their canonical form (no ./, ../ nor symbolic links).  It relies on the POSIX system function realpath: if the platform does not have that (we know of no current example) then the result will be an absolute path but might not be canonical.  Even where realpath is used the canonical path need not be unique, for example via hard links or multiple mounts.
凡一样的Unix平台的支持，它试图把其典型形式的路径成绝对路径（没有./，../也不符号链接）。它依赖于POSIX系统功能realpath：如果平台没有，（我们知道没有当前的例子），那么结果将是一个绝对路径，但可能不典型。即使realpath使用规范的路径不是唯一的，例如通过硬链接或多个坐骑。

On Windows it converts relative paths to absolute paths, converts short names for path elements to long names and ensures the separator is that specified by winslash.  It will match paths case-insensitively and return the canonical case. UTF-8-encoded paths not valid in the current locale can be used.
Windows上的相对路径转换成绝对路径，转换为长文件名的路径元素的短名称，并确保分离器，通过winslash指定。这将匹配路径不区分大小写和返回的典型情况。可以使用UTF-8编码的路径，在当前语言环境的有效。

mustWork = FALSE is useful for expressing paths for use in messages.
mustWork = FALSE是用于表示在邮件中使用的路径。


值----------Value----------

A character vector.
字符向量。

If an input is not a real path the result is system-dependent (unless mustWork = TRUE, when this should be an error).  It will be either the corresponding input element or a transformation of it into an absolute path.
如果输入是不是一个真正的路径，结果是系统依赖（除非mustWork = TRUE，这应该是一个错误）。这将是相应的输入元素或它转变成一个绝对路径。

Converting to an absolute file path can fail for a large number of reasons.  The most common are
可以转换成一个绝对的文件路径失败的原因有大量。最常见的是

One of more components of the file path does not exist.
文件路径的组件之一，并不存在。

A component before the last is not a directory, or there is insufficient permission to read the directory.
前的最后一个组件是不是一个目录，或没有足够的权限读取目录。

For a relative path, the current directory cannot be determined.
对于一个相对路径，当前目录不能确定。

A symbolic link points to a non-existent place or links form a loop.
一个符号链接指向一个不存在的地方或链接，形成一个循环。

The canonicalized path would be exceed the maximum supported length of a file path.
规范化路径将超过支持文件路径的最大长度。


参见----------See Also----------

shortPathName
shortPathName


举例----------Examples----------


cat(normalizePath(c(R.home(), tempdir())), sep = "\n")

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。