r - Roxygen 如何处理中缀二元运算符(例如 %in%)？

Question

作为一个简单而具体的例子:

#' Inverse Value Matching
#' 
#' Complement of \code{%in%}. Returns the elements of \code{x} that are
#' not in \code{y}.
#' @usage x %nin% y
#' @param x a vector
#' @param y a vector
#' @export
"%nin%" <- function(x, y) {
  return( !(x %in% y) )
}

但是，当我尝试构建包时，该函数似乎被忽略并且没有生成任何文档。

在 http://cran.r-project.org/doc/manuals/r-release/R-exts.html#Documenting-functions 处似乎有一个关于二元中缀函数的单行简介，但我很难解析它，以及它对 Roxygen 文档的意义。

Answer 1

您需要逃离 % s 在使用部分。另外，我认为您可能需要指定一个 rdname

#' Inverse Value Matching
#' 
#' Complement of \code{%in%}. Returns the elements of \code{x} that are
#' not in \code{y}.
#' @usage x \%nin\% y
#' @param x a vector
#' @param y a vector
#' @export
#' @rdname nin
"%nin%" <- function(x, y) {
  return( !(x %in% y) )
}

这是我在个人包中的一个功能。我想我从来没有真正使用过这个功能，但是 roxygenize确实创建了一个帮助文件并且包通过了 R CMD check .

#' percent in
#' 
#' calculate the percentage of elements of \code{table} that are in \code{x}
#' 
#' @param x vector or NULL: the values to be matched
#' @param table vector or NULL: the values to be matched against
#' @return percentage of elements of \code{x} that are in \code{table}
#' @author gsee
#' @usage x \%pctin\% table
#' @examples
#' letters[1:10] %pctin% letters[1:3] # 30% of the second arg ar in the first
#' @export
#' @rdname PctIn
"%pctin%" <- function(x, table) length(x[x %in% table])/length(x)