库:加载/附加和列出包

图书馆R文件

包装的装载/附加和列表

描述

图书馆要求加载并附加附加软件包。

用法

库(包,帮助,pos=2,lib.loc=NULL,character.only=假,logical.return=假,warn.conflicts,悄悄地=FALSE,verbose=getOption(“verbose”),mask.ok、exclude、include.only、,attach.required=缺少(仅包含))require(包,lib.loc=NULL,悄悄=FALSE,警告冲突,character.only=假,mask.ok、exclude、include.only、,attach.required=缺少(仅包含))冲突规则(pkg,mask.ok=NULL,exclude=NULL)

参数

包,帮助

包的名称,以名称或文字字符串或字符串,具体取决于是否仅字符错误的(默认)或真的

销售时点情报系统

搜索列表上要附加已加载命名空间。也可以是当前位置的名称搜索列表,如下所示搜索()

库.loc

描述位置的字符向量R(右)要搜索的库树,或无效的。默认值属于无效的对应于当前已知的所有库.lib路径()不存在的库树将被静默地忽略。

仅字符

逻辑表示是否包裹帮助可以假定为字符串。

逻辑返回

符合逻辑。如果是的话真的错误的真的返回以指示成功。

警告.冲突

符合逻辑。如果真的,个警告是关于打印冲突从附加新包裹。冲突是一个函数屏蔽了一个函数,或非函数掩盖非函数。默认值为真的除非另有规定错误的在中冲突.政策选项。

冗长的

合乎逻辑的。如果真的,其他诊断包括印刷的。

安静地

合乎逻辑的。如果真的,无消息确认打印包裹附件,通常无错误/警告如果包裹连接失败,则打印。

包装

命名包的字符串。

掩码.ok

可以遮罩的对象名称的字符向量搜索路径上的对象,严格时不发出错误信号已启用冲突检查

排除,仅包含

对象名称的字符向量排除或包含在附加的框架中。只有一个参数可用于呼叫图书馆要求

所需附件

逻辑指定是否需要程序包在中列出取决于条款描述文件应自动附加。

细节

库(包)需要(包)两者都加载名称为的包的命名空间包裹并将其连接到搜索列表。要求设计用于其他内部功能;它会回来错误的并发出警告(而不是错误为库()默认情况下为存在。这两个功能都检查并更新当前附加的列表包,并且不重新加载已加载的命名空间。(如果如果您想重新加载这样的包,请致电分离(卸载=正确)卸载命名空间第一个。)如果要加载未将其附加到搜索列表中的程序包,请参见requireNamespace(必需命名空间)

要在加载包期间禁止显示消息,请使用禁止打包启动消息:这将抑制所有来自的消息R(右)本身,但不一定是包中的所有内容作者。

如果图书馆调用时没有包装帮助参数,它列出指定库中所有可用的包通过库.loc,并返回类的对象“库IQR”.(该类的结构可以未来版本中的更改。)使用.packages(全部=TRUE)仅获取所有可用包的名称,以及已安装.packages()获取更多信息。

库(help=somename)计算有关包裹某人,并在类的对象中返回此“packageInfo”.(该类的结构可能会在未来版本。)与默认值一起使用时(无效的)的库.loc,在库之前搜索附加的包。

价值

通常情况下图书馆返回(不可见)附加的列表包,但真的错误的如果逻辑返回真的。当被称为库()它返回一个对象“库IQR”、和用于库(帮助=),其中之一“packageInfo”

要求返回(不可见)一个逻辑值,指示是否需要包可用。

冲突

冲突的处理取决于冲突.政策选项。如果未设置此选项,则如果参数警告冲突真的。如果选项设置为字符串“严格”,则所有未解决的冲突都会发出信号错误。可以使用掩码.ok排除、和仅包括参数到图书馆要求。的默认值掩码.ok排除可以是使用指定冲突规则

如果冲突.政策选项设置为字符串“视情况而定。确定”则附加声明导致的冲突依赖关系不会产生错误,但其他冲突会产生错误。这可能是大多数用户想要的最佳设置针对意外冲突提供额外保护。

可以通过指定冲突.政策选项作为命名列表,具有以下内容领域:

错误:

逻辑;如果真的处理未解决的问题冲突是错误。

警告:

逻辑;除非错误的发出警告发现冲突时的消息。

通用.ok:

逻辑;如果真的忽略冲突通过为搜索路径上的函数定义S4泛型创建。

取决于.ok:

逻辑;如果真的不治疗与所需的程序包冲突作为错误。

can.mask:

包名称的字符向量被允许戴面具。这些通常是基本包默认情况下附加。

许可证

一些软件包具有限制性许可证,并且有一种机制可以允许用户了解此类许可证。如果getOption(“checkPackageLicense”)==真,然后开始使用带有not-known-to-be-FOSS(见下文)的包来许可要求用户查看并接受许可证:已接受的列表许可证存储在文件中'~/.R/许可’. 在非交互式会话使用许可证没有的这样的包是错误的已记录为接受。

自起R(右)3.4.0在加载命名空间时完成许可证检查。

自由或开源软件(FOSS,例如https://en.wikipedia.org/wiki/FOSS)程序包是由使用的相同过滤器确定可用的包但只适用于电流包,而不是其依赖项。

也可以有站点范围的文件R_HOME/etc/licensed.site网站第个,共个包(每行一个)。

形式化方法

图书馆打包时采取一些进一步的操作方法已附加(默认情况下)。包可以定义正式的泛型函数以及在其他包中重新定义函数(特别是基础)是通用的,并且每当这样的命名空间在方法和重新定义的功能(隐式泛型)被排除在冲突列表之外。缓存和检查冲突需要查找以下模式物体;通过定义对象可以避免搜索.noGenerics(通用)(具有任何值)。当然,如果包裹有任何这样的方法,这将阻止他们正在使用。

注释

图书馆要求只能加载/附加已安装包,通过使用描述'文件包含建造:字段。

在Unix-alikes下,代码检查包是否已安装在类似的操作系统下R.version$平台(编译R的平台的规范名称),前提是它包含编译的代码。不包含编译后的代码可以在Unix-alike之间共享,但不能共享给其他操作系统因为行尾和操作系统特定帮助可能存在问题文件夹。如果使用子体系结构,则操作系统的相似性不是选中,因为用于生成的操作系统可能不同(例如。i386-pc-linux-gnu代码可以构建在x86_64未知linux-gnu操作系统)。

指定给的包名称图书馆要求必须匹配包中给定的名称'描述'文件准确,甚至在区分大小写的文件系统上,例如在Windows和macOS。

工具书类

Becker,R.A.、Chambers,J.M.和Wilks,A.R.(1988年)新S语言沃兹沃思和布鲁克斯/科尔。

另请参见

.lib路径.个包

贴上分离搜索物体自动加载requireNamespace(必需命名空间)动态库数据安装.包已安装的.packages;安装删除

附加的初始包集由设置选项(defaultPackages=):另请参见启动

示例

library()#列出所有可用包library(lib.loc=.library)#列出默认库中的所有包library(help=splines)#关于包“splines”的文档库(splines)#附加包“splines”需要(样条曲线)#相同search()#也是“样条线”分离(“包:样条线”)#如果包名称位于字符向量中,请使用pkg<-“花键”库(pkg,character.only=TRUE)分离(pos=匹配(粘贴(“package”,pkg,sep=“:”),搜索()))要求(pkg,character.only=TRUE)分离(pos=匹配(粘贴(“package”,pkg,sep=“:”),搜索()))require(不存在)#FALSE##未运行:##如果你想尽量少遮罩,使用库(mypkg,pos=“package:base”)##结束(未运行)