R语言【base】——match.arg通过部分匹配校正参数输入,参数的输入值从首字母开始,保持连续,宁缺勿错

Package base version 4.3.2

match.arg通过部分匹配校正参数输入

R 复制代码
match.arg(arg, choices, several.ok = FALSE)

match.arg 的功能是:将参数【arg】的传入值与参数【choices】的传入值进行匹配,参数choices的传入值可以视为一个候选值列表。


match.arg的参数

  • 参数【arg】:当参数【serveral.ok】为 FALSE时,既可以传入一个长度为1的字符型向量,也可以传入NULL,NULL表示执行 choices[1] 。当参数【serveral.ok】为 TRUE时,则传入的字符型向量的长度可以大于1。

  • 参数【choices】:作为候选值列表的字符型向量,经常忽略。

  • 参数【serveral.ok】:通过逻辑值判断参数【arg】拥有的元素个数是否可以超过1。


match.arg的使用技巧

当使用match.arg 时只给参数【arg】传入值,即match.arg(arg) ,那么调用match.arg的函数中对参数【arg】定义的默认值就将作为参数【choices】的传入值。

匹配过程通过pmatch完成,根据pmatch的特性:参数【arg】可以是缩写,但是当参数【arg】的传入值为空字符串("")时不会有任何匹配项,甚至不会匹配另一个空字符串。

传入参数【arg】的简写必须是从首字母开始的连续字符串。


match.arg的返回值说明

如果有完全匹配或唯一部分匹配,则是该匹配的未缩写版本;否则,如果 参数【several.ok】为 FALSE(默认值),则表示出错。当 参数【several.ok】为TRUE且参数【arg】中(至少)有一个元素匹配时,将返回所有未缩写的匹配结果。


match.arg的实例说明

为了更直白地了解match.arg的功能用法,笔者将通过一个示例进行展示。

R 复制代码
test_match.arg <- function(
    taxon_rank = c("species", "genus", "supragenus", "family", "order"))
{
  taxon_rank <- match.arg(taxon_rank)
  print(taxon_rank)
}
  1. 测试完全匹配
R 复制代码
> test_match.arg(taxon_rank = "species")
[1] "species"
> test_match.arg(taxon_rank = c("species"))
[1] "species"
  1. 测试拼写错误
R 复制代码
> test_match.arg(taxon_rank = c("specise"))
Error in match.arg(taxon_rank) : 
  'arg' should be one of "species", "genus", "supragenus", "family", "order"
  1. 测试从首字母开始的连续字符串
R 复制代码
> test_match.arg(taxon_rank = c("sp"))
[1] "species"
> test_match.arg(taxon_rank = c("s"))
Error in match.arg(taxon_rank) : 
  'arg' should be one of "species", "genus", "supragenus", "family", "order"

因为以"s"开头的候选值有两个:"species"和"supragenus",所以报错!

  1. 测试从非首字母开始的连续字符串
R 复制代码
> test_match.arg(taxon_rank = c("pecies"))
Error in match.arg(taxon_rank) : 
  'arg' should be one of "species", "genus", "supragenus", "family", "order"
相关推荐
czhc114007566311 小时前
LINUX913 shell:set ip [lindex $argv 0],\r,send_user,spawn ssh root@ip “cat “
tcp/ip·r语言·ssh
zhangfeng113318 小时前
win7 R 4.4.0和RStudio1.25的版本兼容性以及系统区域设置有关 导致Plots绘图面板被禁用,但是单独页面显示
开发语言·人工智能·r语言·生物信息
zhangfeng11331 天前
在 R 语言里,`$` 只有一个作用 按名字提取“列表型”对象里的单个元素 对象 $ 名字
开发语言·windows·r语言
高-老师1 天前
R语言生物群落(生态)数据统计分析与绘图实践技术应用
开发语言·r语言·生物群落
WangYan20222 天前
R语言:数据读取与重构、试验设计(RCB/BIB/正交/析因)、ggplot2高级绘图与统计检验(t检验/方差分析/PCA/聚类)
r语言·ggplot2·dplyr
zhangfeng11332 天前
错误于make.names(vnames, unique = TRUE): invalid multibyte string 9 使用 R 语言进行数据处理时
开发语言·r语言·生物信息
zhangfeng11332 天前
R geo 然后读取数据的时候 make.names(vnames, unique = TRUE): invalid multibyte string 9
开发语言·chrome·r语言·生物信息
梦想的初衷~3 天前
R语言生物群落数据分析全流程:从数据清洗到混合模型与结构方程
机器学习·r语言·生态·环境
没有梦想的咸鱼185-1037-16635 天前
基于R语言机器学习方法在生态经济学领域中的实践技术应用
开发语言·机器学习·数据分析·r语言
zhangfeng11335 天前
R 语法高亮为什么没有,是需要安装专用的编辑软件,R语言自带的R-gui 功能还是比较简单
开发语言·r语言