找回密码
 注册
查看: 1763|回复: 0

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

[复制链接]
发表于 2012-2-16 19:17:46 | 显示全部楼层 |阅读模式
files2(base)
files2()所属R语言包:base

                                        Manipulaton of Directories and File Permissions
                                         manipulaton的目录和文件权限

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

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

These functions provide a low-level interface to the computer's file system.
这些功能提供了一个低级别的计算机的文件系统接口。


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


dir.create(path, showWarnings = TRUE, recursive = FALSE, mode = "0777")
Sys.chmod(paths, mode = "0777", use_umask=TRUE)
Sys.umask(mode = NA)



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

参数:path
a character vector containing a single path name.  Tilde expansion (see path.expand) is done.
一个字符向量包含一个单一的路径名。 TILDE扩张(见path.expand)完成。


参数:paths
character vectors containing file or directory paths.  Tilde expansion (see path.expand) is done.
特征向量包含文件或目录路径。 TILDE扩张(见path.expand)完成。


参数:showWarnings
logical; should the warnings on failure be shown?
逻辑;应显示失败的警告?


参数:recursive
logical. Should elements of the path other than the last be created?  If true, like the Unix command mkdir -p.
逻辑。应该比去年其他路径的元素被创建?如果情况属实,像Unix命令mkdir -p。


参数:mode
the mode to be used on Unix-alikes: it will be coerced by as.octmode.  For Sys.chmod it is recycled along paths.
在Unix相似者使用的模式:它会被强迫as.octmode。为Sys.chmod它回收沿paths。


参数:use_umask
logical: should the mode be restricted by the umask setting?
逻辑:umask设置限制模式呢?


Details

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

dir.create creates the last element of the path, unless recursive = TRUE.  Trailing path separators are discarded. On Windows drives are allowed in the path specification and unless the path is rooted, it will be interpreted relative to the current directory on that drive.  mode is ignored on Windows.
dir.create创建的路径的最后一个元素,除非recursive = TRUE。尾随的路径分隔符将被丢弃。在Windows驱动器允许在路径规范,除非路径是根深蒂固的,它会被解释相对该驱动器上的当前目录。 mode Windows上被忽略。

One of the idiosyncrasies of Windows is that directory creation may report success but create a directory with a different name, for example dir.create("G.S.") creates ""G.S"".  This is undocumented, and what are the precise circumstances is unknown (and might depend on the version of Windows).  Also avoid directory names with a trailing space.  
Windows的特质之一就是创建目录可能会报告成功,但用不同的名称创建一个目录,例如dir.create("G.S.")创建"G.S"。这是无证的,什么是精确的情况是未知的(可能取决于Windows版本)。也避免与尾随空格的目录名。

Sys.chmod sets the file permissions of one or more files. The interpretation of mode in the Windows system functions is non-POSIX and only supports setting the read-only attribute of the file.  So R interprets mode to mean set read-only if and only if (mode & 0200) == 0 (interpreted in octal).  Windows has a much more extensive system of file permissions on some file systems (e.g. versions of NTFS) which are unrelated to this system call.
Sys.chmod设置一个或多个文件的文件权限。 mode是在Windows系统功能的非POSIX,并且只支持设置文件的只读属性的解释。所以R解释mode是指设置为只读,当且仅当(mode & 0200) == 0(八进制的解释)。 Windows有一个更广泛的一些文件系统(如NTFS的版本),这是这个系统调用无关的文件权限的系统。

Sys.umask sets the umask and returns the previous value: as a special case mode = NA just returns the current value. All files on Windows are regarded as readable, and files being executable is not a Windows concept.  So umask only controls whether a file is writable: a setting of "200" makes files (but not directories) created subsequently read-only.
Sys.umask设置umask“返回以前的价值:作为一种特殊的情况下mode = NA只是返回当前值。 Windows上的所有文件被视为可读和可执行文件是一个Windows的概念。所以umask只有控制文件是否是可写的:设置"200"使得随后只读文件(而不是目录)创建。

How modes are handled depends on the file system, even on Unix-alikes (although their documentation is often written assuming a POSIX file system).  So treat documentation cautiously if you are using, say, a FAT/FAT32 or network-mounted file system.
如何处理模式是依赖于文件系统,即使在Unix相似者,(虽然他们的文档往往假定一个POSIX文件系统)。所以谨慎地处理文件,如果您使用的,也就是说,一个FAT/FAT32上或网络上的文件系统。


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

dir.create and Sys.chmod return invisibly a logical vector indicating if the operation succeeded for each of the files attempted. Using a missing value for a path name will always be regarded as a failure.  dir.create indicates failure if the directory already exists.  If showWarnings = TRUE, dir.create will give a warning for an unexpected failure (e.g. not for a missing value nor for an already existing component for recursive = TRUE).
dir.create和Sys.chmod返回无形逻辑的向量,如果操作成功尝试的每个文件。使用路径名失踪的价值将永远被视为失败。 dir.create表示失败,如果目录已经存在。如果showWarnings = TRUE,dir.create会给一个意外故障(如不为缺失值,也为recursive = TRUE现有的组件)的警告。

Sys.umask returns the previous value of the umask, as a length-one object of class "octmode": the visibility flag is off unless mode is NA.
Sys.umaskumask返回以前的值,如长度,一类对象"octmode":除非mode是NA是关闭的可视性标志。


注意----------Note----------

There is no guarantee that these functions will handle Windows relative paths of the form "d:path": try "d:./path" instead.  In particular, "d:" is not recognized as a directory. Nor are \\?\ prefixes (and similar) supported.
谁也不能保证,这些功能将处理相对路径形式d:path的的Windows:尝试d:./path代替。特别是,d:不是一个目录确认。也不是\\?\前缀(以及类似)支持。

UTF-8-encoded dirnames not valid in the current locale can be used.  
可以使用UTF-8编码dirnames在当前语言环境的有效。


作者(S)----------Author(s)----------



Ross Ihaka, Brian Ripley




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

file.info, file.exists, file.path, list.files, unlink, basename, path.expand.
file.info,file.exists,file.path,list.files,unlink,basename,path.expand。


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


## Fix up maximal allowed permissions in a file tree[#修正了在文件树中的最大允许的权限]
Sys.chmod(list.dirs("."), "777")
f <- list.files(".", all.files = TRUE, full.names = TRUE,
                recursive =TRUE)
Sys.chmod(f, (file.info(f)$mode | "664"))


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


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

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

手机版|小黑屋|生物统计家园 网站价格

GMT+8, 2025-1-24 09:31 , Processed in 0.026699 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表