UConverter::setSubstChars()函式—用法及示例

函式名稱：UConverter::setSubstChars() 

適用版本：PHP 7.4.0 或更高版本

用法：UConverter::setSubstChars(string $chars) : bool

說明：UConverter::setSubstChars() 方法用於設定替代字元序列，以替代在轉換期間無法轉換的字元。替代字元序列是一個字串，其中包含一個或多個字元。

引數：

• $chars：一個字串，表示替代字元序列。

返回值：

• 如果成功設定替代字元序列，則返回 true。
• 如果設定替代字元序列失敗，則返回 false。

示例：

// 建立一個 UConverter 物件
$converter = UConverter::create("UTF-8", "ISO-8859-1");

// 設定替代字元序列為 "?"
$converter->setSubstChars("?");

// 轉換一個包含無法轉換字元的字串
$input = "Hello, 世界!";
$output = $converter->convert($input);

echo $output; // 輸出：Hello, ?!

// 設定替代字元序列為 "??"
$converter->setSubstChars("??");

// 再次轉換同樣的字串
$output = $converter->convert($input);

echo $output; // 輸出：Hello, ??

// 設定替代字元序列為空字串
$converter->setSubstChars("");

// 再次轉換同樣的字串
$output = $converter->convert($input);

echo $output; // 輸出：Hello, 世界!

在上面的示例中，我們首先建立了一個 UConverter 物件，並設定了源編碼為 "UTF-8"，目標編碼為 "ISO-8859-1"。然後，我們使用 setSubstChars() 方法將替代字元序列設定為 "?"。接下來，我們將包含無法轉換字元的字串進行轉換，並將結果輸出。輸出中的無法轉換字元將被替代為 "?"。然後，我們再次使用 setSubstChars() 方法將替代字元序列設定為 "??"，再次進行轉換並輸出結果。最後，我們將替代字元序列設定為空字串，再次進行轉換並輸出結果，此時無法轉換字元將被忽略。