函数文档

rawurlencode_deep()

💡 云策文档标注

概述

rawurlencode_deep() 是一个 WordPress 函数,用于遍历数组、对象或标量值,并对值进行原始 URL 编码,以便在 URL 中使用。

关键要点

  • 参数 $value 是必需的,可以是数组或字符串,用于指定要编码的值。
  • 返回值是编码后的值,类型与输入相同。
  • 该函数内部调用 map_deep() 函数,将 rawurlencode 应用于所有非可迭代元素。
  • 在 WordPress 3.4.0 版本中引入。

代码示例

function rawurlencode_deep( $value ) {
	return map_deep( $value, 'rawurlencode' );
}

注意事项

  • 该函数主要用于处理 URL 中的特殊字符,确保数据在传输时正确编码。
  • 相关函数包括 map_deep(),用于将函数映射到数组或对象的非可迭代元素。
  • 被 get_avatar_data() 和 redirect_canonical() 等函数使用。

📄 原文内容

Navigates through an array, object, or scalar, and raw-encodes the values to be used in a URL.

Parameters

$valuemixedrequired
The array or string to be encoded.

Return

mixed The encoded value.

Source

function rawurlencode_deep( $value ) {
	return map_deep( $value, 'rawurlencode' );
}

Changelog

Version Description
3.4.0 Introduced.