当前浏览:首页 / WordPress函数 / _deprecated_argument()

_deprecated_argument( string $function, string $version, string $message = '' )

将函数参数标记为已弃用,并在使用时通知

e 翻译more...

  • __() 检索$text的翻译
  • _e() 显示翻译文本
  • _ex() 使用gettext上下文显示翻译后的字符串
  • _n_noop() 在POT文件中注册多个字符串,但不翻译它们
  • _n() 基于提供的数字翻译和检索单数或复数形式
  • _nx_noop() 在POT文件中使用gettext上下文注册多个字符串,但不翻译它们
  • _nx() 使用gettext上下文,根据提供的数字检索单/复数形式进行翻译
  • _x() 使用gettext上下文检索已翻译的字符串
  • esc_attr__() 检索$text的翻译并将其转义,以便在属性中安全使用
  • esc_attr_e() 显示为在属性中安全使用而转义的翻译文本

orderby


描述

每当使用不推荐使用的函数参数时,都将使用此函数。在调用此函数之前,必须通过将参数与其默认值进行比较或评估参数是否为空来检查参数是否已被使用。例如:

if ( ! empty( $deprecated ) ) {
    _deprecated_argument( __FUNCTION__, '3.0.0' );
}

将调用一个钩子deprecated_argument_run,该钩子可用于回溯到使用不推荐的参数的文件和函数。

如果WP_DEBUG为真,则当前行为将触发用户错误。


参数

$function

(string)(必填) 调用的函数。

$version

(string)(必填) 不推荐使用的参数的WordPress版本。

$message

(string)(可选) 关于更改的消息。

默认值: ''



源码

查看源码 官方文档


更新日志

版本描述
5.4.0错误类型现在分类为E_USER_DEPRECATED(用于默认为E_USER_NOTICE)
3.0.0开始引入