UseMethod("t")
告诉你这t()
是一个(S3)通用函数,它具有不同对象类的方法。
S3方法调度系统
对于 S3 类,您可以使用该methods
函数列出特定通用函数或类的方法。
> methods(t)
[1] t.data.frame t.default t.ts*
Non-visible functions are asterisked
> methods(class="ts")
[1] aggregate.ts as.data.frame.ts cbind.ts* cycle.ts*
[5] diffinv.ts* diff.ts kernapply.ts* lines.ts
[9] monthplot.ts* na.omit.ts* Ops.ts* plot.ts
[13] print.ts time.ts* [<-.ts* [.ts*
[17] t.ts* window<-.ts* window.ts*
Non-visible functions are asterisked
“不可见的函数带有星号”表示该函数未从其包的命名空间中导出。您仍然可以通过:::
函数(即stats:::t.ts
)或使用getAnywhere()
. getAnywhere()
很有用,因为您不必知道函数来自哪个包。
> getAnywhere(t.ts)
A single object matching ‘t.ts’ was found
It was found in the following places
registered S3 method for t from namespace stats
namespace:stats
with value
function (x)
{
cl <- oldClass(x)
other <- !(cl %in% c("ts", "mts"))
class(x) <- if (any(other))
cl[other]
attr(x, "tsp") <- NULL
t(x)
}
<bytecode: 0x294e410>
<environment: namespace:stats>
S4方法调度系统
S4 系统是一种较新的方法调度系统,是 S3 系统的替代方案。以下是 S4 函数的示例:
> library(Matrix)
Loading required package: lattice
> chol2inv
standardGeneric for "chol2inv" defined from package "base"
function (x, ...)
standardGeneric("chol2inv")
<bytecode: 0x000000000eafd790>
<environment: 0x000000000eb06f10>
Methods may be defined for arguments: x
Use showMethods("chol2inv") for currently available ones.
输出已经提供了很多信息。standardGeneric
是 S4 功能的指标。提供查看已定义 S4 方法的方法很有帮助:
> showMethods(chol2inv)
Function: chol2inv (package base)
x="ANY"
x="CHMfactor"
x="denseMatrix"
x="diagonalMatrix"
x="dtrMatrix"
x="sparseMatrix"
getMethod
可以用来查看其中一种方法的源码:
> getMethod("chol2inv", "diagonalMatrix")
Method Definition:
function (x, ...)
{
chk.s(...)
tcrossprod(solve(x))
}
<bytecode: 0x000000000ea2cc70>
<environment: namespace:Matrix>
Signatures:
x
target "diagonalMatrix"
defined "diagonalMatrix"
还有一些方法对每个方法都有更复杂的签名,例如
require(raster)
showMethods(extract)
Function: extract (package raster)
x="Raster", y="data.frame"
x="Raster", y="Extent"
x="Raster", y="matrix"
x="Raster", y="SpatialLines"
x="Raster", y="SpatialPoints"
x="Raster", y="SpatialPolygons"
x="Raster", y="vector"
要查看这些方法之一的源代码,必须提供整个签名,例如
getMethod("extract" , signature = c( x = "Raster" , y = "SpatialPolygons") )
提供部分签名是不够的
getMethod("extract",signature="SpatialPolygons")
#Error in getMethod("extract", signature = "SpatialPolygons") :
# No method found for function "extract" and signature SpatialPolygons
调用未导出函数的函数
在 和 的情况下,ts.union
是命名空间中未导出的函数。您可以使用运算符 或来查看未导出函数的源代码。.cbindts
.makeNamesTs
stats
:::
getAnywhere
> stats:::.makeNamesTs
function (...)
{
l <- as.list(substitute(list(...)))[-1L]
nm <- names(l)
fixup <- if (is.null(nm))
seq_along(l)
else nm == ""
dep <- sapply(l[fixup], function(x) deparse(x)[1L])
if (is.null(nm))
return(dep)
if (any(fixup))
nm[fixup] <- dep
nm
}
<bytecode: 0x38140d0>
<environment: namespace:stats>
调用编译代码的函数
请注意,“已编译”不是指由编译器包创建的字节编译的 R 代码。上面输出中的<bytecode: 0x294e410>
那一行表示该函数是字节编译的,您仍然可以从 R 命令行查看源代码。
调用.C
, .Call
, .Fortran
, .External
,.Internal
或.Primitive
正在调用编译代码中的入口点的函数,因此如果您想完全理解该函数,则必须查看编译代码的源代码。这个R 源代码的 GitHub 镜像是一个不错的起点。该函数pryr::show_c_source
可能是一个有用的工具,因为它会直接将您带到 GitHub 页面.Internal
并进行.Primitive
调用。包可以使用.C
, .Call
, .Fortran
, 和.External
; 但不是.Internal
or .Primitive
,因为它们用于调用内置于 R 解释器中的函数。
对上述某些函数的调用可能会使用对象而不是字符串来引用编译后的函数。在这些情况下,对象属于"NativeSymbolInfo"
、"RegisteredNativeSymbol"
或"NativeSymbol"
; 打印对象会产生有用的信息。例如,optim
调用.External2(C_optimhess, res$par, fn1, gr1, con)
(注意是C_optimhess
,不是"C_optimhess"
)。 optim
位于 stats 包中,因此您可以键入stats:::C_optimhess
以查看有关正在调用的已编译函数的信息。
包中的编译代码
如果要查看包中的编译代码,则需要下载/解包包源。安装的二进制文件不够用。包的源代码可从最初安装包的同一 CRAN(或 CRAN 兼容)存储库中获得。该download.packages()
功能可以为您获取包源。
download.packages(pkgs = "Matrix",
destdir = ".",
type = "source")
这将下载Matrix包的源代码版本并将相应的.tar.gz
文件保存在当前目录中。编译函数的源代码可以在src
未压缩和未去皮文件的目录中找到。解压缩和去皮的步骤可以在外部R
或R
使用untar()
函数内部完成。可以将下载和扩展步骤合并到一个调用中(注意一次只能下载和解压一个包):
untar(download.packages(pkgs = "Matrix",
destdir = ".",
type = "source")[,2])
或者,如果包开发是公开托管的(例如通过GitHub、R-Forge或RForge.net),您可能可以在线浏览源代码。
基础包中的编译代码
某些软件包被视为“基本”软件包。这些软件包随 R 一起提供,并且它们的版本被锁定为 R 的版本。示例包括base
、compiler
、stats
和utils
. 因此,如上所述,它们不能作为 CRAN 上的单独可下载包提供。相反,它们是 R 源代码树的一部分,位于/src/library/
. 下一节将介绍如何访问 R 源代码。
编译后的代码内置到 R 解释器中
如果要查看 R 解释器内置的代码,则需要下载/解压缩 R 源代码;或者您可以通过 R Subversion 存储库或Winston Chang 的 github 镜像在线查看源代码。
Uwe Ligges 的R 新闻文章 (PDF)(第 43 页)是关于如何查看源代码.Internal
和.Primitive
函数的很好的一般参考。基本步骤是先在 .in 中查找函数名,src/main/names.c
然后在src/main/*
.