函数文档

_search_terms_tidy()

💡 云策文档标注

概述

_search_terms_tidy() 是一个已弃用的 WordPress 内部函数,用于清理搜索词,如去除多余空格和引号。自 WordPress 3.7.0 版本起不再推荐使用。

关键要点

  • 函数 _search_terms_tidy() 已弃用,自 3.7.0 版本起标记为过时。
  • 参数 $tstring 是必需的搜索词,函数返回修剪后的字符串。
  • 内部实现使用 trim() 函数去除特定字符,包括双引号、单引号、换行符和空格。
  • 相关函数 _deprecated_function() 用于标记弃用并通知使用情况。

代码示例

function _search_terms_tidy( $t ) {
    _deprecated_function( __FUNCTION__, '3.7.0' );
    return trim( $t, ""'nr " );
}

注意事项

  • 开发者应避免在新代码中使用此函数,因为它已弃用,可能导致兼容性问题。
  • 如果需要在代码中处理搜索词,建议使用替代方法或自定义函数。

📄 原文内容

Formerly used internally to tidy up the search terms.

Parameters

$tstringrequired
Search terms to “tidy”, e.g. trim.

Return

string Trimmed search terms.

Source

function _search_terms_tidy( $t ) {
	_deprecated_function( __FUNCTION__, '3.7.0' );
	return trim( $t, ""'nr " );
}

Changelog

Version Description
3.7.0 Deprecated.
2.9.0 Introduced.