函数文档

wp_iso_descrambler()

💡 云策文档标注

概述

wp_iso_descrambler() 是一个 WordPress 核心函数,用于将电子邮件主题行从编码格式转换为 ASCII 字符串。它主要处理基于 ISO-8859-1 的 Q-encoded 格式。

关键要点

  • 函数接受一个字符串参数 $subject,代表电子邮件主题行。
  • 如果主题行不匹配 Q-encoded 格式,函数直接返回原字符串。
  • 函数内部使用正则表达式匹配和替换,将下划线转换为空格,并调用 _wp_iso_convert 回调函数处理十六进制编码字符。
  • 返回转换后的 ASCII 字符串。

代码示例

function wp_iso_descrambler( $subject ) {
    /* this may only work with iso-8859-1, I'm afraid */
    if ( ! preg_match( '#=?(.+)?Q?(.+)?=#i', $subject, $matches ) ) {
        return $subject;
    }

    $subject = str_replace( '_', ' ', $matches[2] );
    return preg_replace_callback( '#=([0-9a-f]{2})#i', '_wp_iso_convert', $subject );
}

📄 原文内容

Converts to ASCII from email subjects.

Parameters

$subjectstringrequired
Subject line.

Return

string Converted string to ASCII.

Source

function wp_iso_descrambler( $subject ) {
	/* this may only work with iso-8859-1, I'm afraid */
	if ( ! preg_match( '#=?(.+)?Q?(.+)?=#i', $subject, $matches ) ) {
		return $subject;
	}

	$subject = str_replace( '_', ' ', $matches[2] );
	return preg_replace_callback( '#=([0-9a-f]{2})#i', '_wp_iso_convert', $subject );
}

Changelog

Version Description
1.2.0 Introduced.