関数・クラス解説

strlen

version:PHP 4, PHP 5, PHP 7 (公式)

文字列の長さ(バイト数)を返却する

フォーマット

int : strlen ( string $string )

パラメータ

string $string
バイト数を調べたい文字列を指定

返値 int
string のバイト数が返却されます。 string が空文字の場合は、0 が返ります。

解説

渡された文字列(string)の長さを返却します。ここでいう「長さ」とは文字数ではなく、バイト数となります。シングルバイト文字列の場合はバイト数=文字数と考えてほぼ間違いありませんが、マルチバイト文字を指定する場合は注意する必要があります。マルチバイト文字を利用して「文字数」を得たい場合にはmb_strlen()関数を利用することができます。

注意: 配列に対して strlen() を実行すると NULL を返し、 E_WARNING レベルのエラーが発生します。

記述サンプル

//PHP 7.4.6で実行
//文字列を指定
$str = 'abc ABC';

//実行
$result = strlen($str);

//結果表示
echo $result;
7

/* ----------------------------- */

//マルチバイト文字列を指定(UTF-8を使用して実行。UTF-8は1文字につき3バイト)
$str = 'あいうえおかきくけこ';

//実行
$result = strlen($str);

//結果表示
echo $result;
30

/* ----------------------------- */

//シングルバイト文字とマルチバイト文字(UTF-8)の混在の場合
$str = 'あいうえおabcdefg';

//実行
$result = strlen($str);

//結果表示
echo $result;
22

参考リンク

iconv_strlen 文字列の文字数を返す
grapheme_strlen 書記素単位で文字列の長さを取得する
mb_strlen 文字列の長さを得る
count 変数に含まれるすべての要素、 あるいはオブジェクトに含まれる何かの数を数える

タグ

バイト数 長さ String 文字列


公式リファレンス

書式

strlen ( string $string ) : int

説明

与えられた string の長さを返します。

パラメータ

string
長さを調べる文字列。

返値

成功した場合に string の長さ、 string が空の文字列だった場合に 0 を返します。

注意

注意: strlen() が返すのはバイト数であり、 文字数ではありません。
注意: 配列に対して strlen() を実行すると NULL を返し、 E_WARNING レベルのエラーが発生します。

サンプル

例1 strlen() の例

$str = 'abcdef'; echo strlen($str); // 6 $str = ' ab cd '; echo strlen($str); // 7

参考

  • count() - 変数に含まれるすべての要素、 あるいはオブジェクトに含まれる何かの数を数える
  • grapheme_strlen() - 書記素単位で文字列の長さを取得する
  • iconv_strlen() - 文字列の文字数を返す
  • mb_strlen() - 文字列の長さを得る
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール