trim

関数の概要

PHPの trim 関数は、文字列の先頭と末尾から不要な空白文字や指定した文字を取り除くための関数です。特にユーザーからの入力データの前後の空白を除去したい時に便利で、データのクレンジングや整形でよく使われます。

パラメータの説明

  • string $str: トリミング対象の文字列を指定します。
  • string $character_mask(省略可能): 削除したい文字のリストを文字列で指定します。省略時は空白やタブ、改行などの空白文字全般が対象となります。

戻り値

トリミング処理後の文字列を返します。オリジナルの文字列から、先頭と末尾の指定した文字が取り除かれた新しい文字列です。

使用例

基本的な使い方

<?php
$str = "  こんにちは PHP  ";
$trimmed = trim($str);
echo $trimmed; // 出力: "こんにちは PHP"
?>

この例では、文字列の前後にある半角スペースが取り除かれ、中央のスペースはそのまま残ります。

改行やタブも削除する例

<?php
$str = "ntHello Worldtn";
$trimmed = trim($str);
echo $trimmed; // 出力: "Hello World"
?>

標準では空白だけでなく改行(n)やタブ(t)も削除されます。

特定の文字を削除する例

<?php
$str = "xxxyHello Worldyyyxx";
$trimmed = trim($str, "xy");
echo $trimmed; // 出力: "Hello World"
?>

第2引数に指定した文字(ここでは ‘x’ と ‘y’)が先頭と末尾から取り除かれます。

数字を削除する例

<?php
$str = "123test123";
$trimmed = trim($str, "0123456789");
echo $trimmed; // 出力: "test"
?>

このように数字の文字も削除対象として指定可能です。

関連する関数

  • ltrim: 文字列の先頭からのみ指定した文字を取り除く関数
  • rtrim: 文字列の末尾からのみ指定した文字を取り除く関数
  • str_replace: 文字列中の特定文字や文字列を別のものに置換する関数

まとめ

trim はPHPで文字列の前後の空白や不要な文字を簡単に取り除くための基本的かつ重要な関数です。ユーザー入力の整形やデータの前処理で欠かせない役割を果たし、指定した文字を削除できる柔軟性もあります。
初めてでもシンプルに使えるため、文字列操作時には積極的に活用しましょう。