PHPで文字列が半角カタカナであるかを正規表現でチェックする

2024年3月24日 2024年3月24日

たかよこ

文字列が半角カタカナであるかを正規表現でチェックするには「^[ｦ-ﾟ]+$」のパターンを使います。この正規表現は「1文字以上の半角カタカナの組み合わせで構成される文字列」という意味になり「ﾊﾟﾀｰﾝ」や「ｳﾞｨｰﾅｽ」など長音や濁点、半濁点を含む半角カタカナの文字列にマッチします。

このパターンをPHPで正しく動作させるためには、文字エンコーディングがUTF-8であることを示すパターン修飾子「u（PCRE_UTF8）」を指定し「/^[ｦ-ﾟ]+$/u」のように記述します。

基本的な半角カタカナチェックで利用できる正規表現のパターンは以下になります。

#	マッチさせたい条件	正規表現パターン
1	すべて半角カタカナである	^[ｦ-ﾟ]+$
2	n桁の半角カタカナである	^[ｦ-ﾟ]{n}$
3	n桁以上の半角カタカナである	^[ｦ-ﾟ]{n,}$
4	m桁以下の半角カタカナである	^[ｦ-ﾟ]{1,m}$
5	n桁以上m桁以下の半角カタカナである	^[ｦ-ﾟ]{n,m}$

半角カタカナのチェックで利用できる正規表現パターン

ソースコード

すべて半角カタカナであるかをチェックする

/**
 * 文字列が半角カタカナかチェックします
 * @param string $str 文字列
 * @return bool 文字列が半角カタカナの場合はtrue、それ以外はfalse
 */
function isHalfWidthKatakana(string $str) {
	return preg_match('/^[ｦ-ﾟ]+$/u', $str);
}

検証

引数の入力

isHalfWidthKatakana("

");

実行

検証結果

n桁の半角カタカナであるかをチェックする

/**
 * 文字列が指定した桁数の半角カタカナかチェックします
 * @param string $str 文字列
 * @param int $n 桁数
 * @return bool 文字列が指定した桁数の半角カタカナの場合はtrue、それ以外はfalse
 */
function isHalfWidthKatakanaFixedLength(string $str, int $n) {
	return preg_match(sprintf('/^[ｦ-ﾟ]{%d}$/u', $n), $str);
}

検証

引数の入力

isHalfWidthKatakanaFixedLength("

);

長さは桁数で入力してください。

実行

検証結果

n桁以上の半角カタカナであるかをチェックする

/**
 * 文字列が最小桁数以上の半角カタカナかチェックします
 * @param string $str 文字列
 * @param int $n 最小桁数
 * @return bool 文字列が最小桁数以上の半角カタカナの場合はtrue、それ以外はfalse
 */
function isHalfWidthKatakanaMinLength(string $str, int $n) {
	return preg_match(sprintf('/^[ｦ-ﾟ]{%d,}$/u', $n), $str);
}

検証

引数の入力

isHalfWidthKatakanaMinLength("

);

長さは桁数で入力してください。

実行

検証結果

m桁以下の半角カタカナであるかをチェックする

/**
 * 文字列が最大桁数以下の半角カタカナかチェックします
 * @param string $str 文字列
 * @param int $m 最大桁数
 * @return bool 文字列が最大桁数以下の半角カタカナの場合はtrue、それ以外はfalse
 */
function isHalfWidthKatakanaMaxLength(string $str, int $m) {
	return preg_match(sprintf('/^[ｦ-ﾟ]{1,%d}$/u', $m), $str);
}

検証

引数の入力

isHalfWidthKatakanaMaxLength("

);

長さは桁数で入力してください。

実行

検証結果

n桁以上m桁以下の半角カタカナであるかをチェックする

/**
 * 文字列が指定した桁数範囲の半角カタカナかチェックします
 * @param string $str 文字列
 * @param int $n 最小桁数
 * @param int $m 最大桁数
 * @return bool 文字列が指定した桁数範囲の半角カタカナの場合はtrue、それ以外はfalse
 */
function isHalfWidthKatakanaInRange(string $str, int $n, int $m) {
	return preg_match(sprintf('/^[ｦ-ﾟ]{%d,%d}$/u', $n, $m), $str);
}