ansible.builtin.basename 过滤器 – 获取路径的基本名称

注意

此过滤器插件是 ansible-core 的一部分,包含在所有 Ansible 安装中。在大多数情况下,您可以使用简短的插件名称 basename。但是,我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.basename,以便轻松链接到插件文档并避免与可能具有相同过滤器插件名称的其他集合冲突。

概要

  • 返回路径的最后一个名称组件,即字符串中剩余的非“dirname”部分。

输入

此部分描述过滤器的输入,即 | ansible.builtin.basename 之前的数值。

参数

注释

输入

路径 / 必需

一个路径。

备注

注意

  • 此过滤器的结果与 Unix basename 程序不同;其中,对于 /foo/bar/,basename 返回 bar,而 basename 过滤器返回空字符串 ('')。

另请参见

另请参见

ansible.builtin.dirname 过滤器插件

获取路径的目录名称。

示例

# To get the last name of a file path, like 'foo.txt' out of '/etc/asdf/foo.txt'.
{{ mypath | basename }}

返回值

描述

返回值

字符串

提供的路径的基本名称。

返回:成功

作者

  • Ansible 核心团队

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如,列表中较低的变量将覆盖较高的变量。