정의 및 사용 방법

PHP 버전
4.0.4+

ctype_digit() 함수는 주어진 문자열이 0부터 9까지의 숫자로만 구성되어 있는지 확인합니다.
매개변수로 전달된 문자열이 모두 숫자로 이루어져 있다면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

특징

  • 공백 문자는 숫자가 아닌 것으로 해석합니다.
  • 빈 문자열('')은 숫자가 아닌 것으로 해석합니다.
  • '3.14'와 같은 부동소수점 숫자(float 타입)은 숫자에 . 부호가 포함되어 있는 문자열이므로 숫자가 아닌 것으로 해석합니다.
  • '-123'와 같이 음의 정수와 같이 숫자에 - 등의 부호가 포함되어 있는 문자열은 숫자가 아닌 것으로 해석합니다.
  • PHP 8.1.0 이전에는 문자열이 아닌 인수를 전달할 수 있었지만, PHP 8.1.0부터는 문자열이 아닌 인수를 전달하는 것이 더 이상 지원되지 않습니다.

기본 예제

PHP 
var_dump(ctype_digit('1234'));  // bool(true)
var_dump(ctype_digit('0123'));  // bool(true)

var_dump(ctype_digit(' 123 ')); // bool(false)
var_dump(ctype_digit('3.14'));  // bool(false)
var_dump(ctype_digit('-123'));  // bool(false)
var_dump(ctype_digit(''));      // bool(false)

/* PHP 8.1.0부터는 문자열이 아닌 인수를 전달하는 것이 더 이상 지원되지 않습니다. */
var_dump(ctype_digit(123)); // bool(false)
var_dump(ctype_digit(1e3)); // bool(false)

이 함수의 관련 함수를 참조하세요.

구문

PHP 
ctype_digit(mixed $text): bool

매개변수

ctype_digit() 함수의 매개변수
$text 필수. 모든 문자가 숫자인지 확인할 문자열

참고 사항

ctype_digit() 함수는 ASCII 문자 코드를 기준으로 숫자인지 판단하며, ASCII 문자 코드에는 0부터 9까지의 숫자만 포함되어 있습니다. ASCII 문자의 범위는 0x00부터 0x7F까지 총 128개의 문자를 포함하는데 0부터 9까지의 숫자도 여기에 포함됩니다.

하지만, 매개변수로 전달되는 값이 정수일 경우 반드시 다음의 내용을 참고하세요.

매개변수로 전달되는 값으로 -128에서 255 사이의 정수가 제공된 경우, 이는 하나의 문자의 ASCII 값으로 해석됩니다. 즉 해당 정수가 문자열로 변환된다는 의미입니다.

PHP 
/* int 타입, ASCII 범위(-128에서 255 사이의 정수) 내 정수 */
$x = 65; // -128에서 255 사이의 정수인 65는 'A' 문자의 ASCII 값으로 간주됨
var_dump(ctype_digit($x)); // false => 문자열 'A'로 간주됨

/* int 타입, ASCII 범위(-128에서 255 사이의 정수) 밖 정수 */
$y = 1234; // -128에서 255 밖의 정수인 1234는 문자열로 변환된 '1234'로 간주됨
var_dump(ctype_digit($y)); // true => 문자열 '1234'로 간주됨

위의 예시 코드에 대해 설명하겠습니다.

$x = 65의 경우
  1. -128에서 255 사이의 정수인 65는 ASCII 값으로 간주됩니다. 따라서 이는 문자열 'A'의 ASCII 값과 일치합니다.
  2. 그래서 매개변수로 전달되는 값은 'A'로 간주됩니다.
  3. 따라서 매개변수로 전달된 'A' 문자열은 숫자로만 구성되어 있지 않기 때문에 false를 반환합니다.
$y = 1234의 경우
  1. 정수 1234는 -128에서 255 사이의 정수가 아니므로 하나의 문자의 ASCII 값으로 해석되지 않는 원래의 정수 1234입니다.
  2. 문자열을 매개변수로 기대하는 ctype_digit() 함수에 정수 1234가 전달되면 해당 정수는 문자열로 변환되어 '1234'로 간주됩니다.
  3. 따라서 매개변수로 전달된 '1234' 문자열은 모두 숫자로만 구성되어 있으므로 true를 반환합니다.

PHP 8.1.0 버전부터의 변경 사항

PHP 8.1.0부터는 ctype_digit() 함수에 문자열이 아닌 인수를 전달하는 것이 더 이상 지원되지 않습니다.

반환 값

매개변수로 전달된 문자열이 모두 숫자로 이루어져 있다면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

주의할 점

ctype_digit() 함수를 사용할 때 주의할 점이 있습니다.

인수를 문자열로 변환해서 사용하기

위에서 언급한 바와 같이 -128에서 255 범위 내의 정수 값인 경우에는 의도하지 않은 결과가 발생하게 됩니다. 또한, PHP 8.1.0부터는 ctype_digit() 함수에 문자열이 아닌 인수를 전달하는 것이 더 이상 지원되지 않기 때문에 인수로 사용될 값은 문자열로 변환 후 사용해야 합니다.

PHP 
$x = 65;

var_dump( ctype_digit($x)); // false => 의도하지 않은 결과
var_dump( ctype_digit((string)$x)); // true

trim() 함수를 사용하여 문자열 앞뒤 공백 제거

ctype_digit() 함수는 공백 문자를 숫자로 판단하지 않습니다. ctype_digit() 함수를 더 엄격하게 적용하기 위해서는 주어진 문자열의 앞뒤에 공백이 있을 수 있으므로 trim() 함수를 사용하여 앞뒤의 공백을 제거하는 것이 좋습니다. 이렇게 하면 문자열에 공백이 포함되어 있더라도 숫자로만 이루어진 문자열인지를 정확하게 확인할 수 있습니다.

부연설명
trim() 함수는 문자열의 양쪽 끝에서 공백 또는 매개변수로 지정된 문자열을 제거(trim)하는 함수입니다.

PHP 
$var = ' 123 ';

var_dump(ctype_digit($var));       // false
var_dump(ctype_digit(trim($var))); // true

활용 예제

ctype_digit() 함수는 다음과 같은 경우에 사용하면 편리하거나 유용합니다.

사용자 입력 검사

양식 입력 값 검사에서 사용자가 숫자만 입력하도록 제한할 때 유용합니다.

PHP 
$user_input = trim($_POST['age']);

if (ctype_digit($user_input)) {
    // 입력이 숫자로만 이루어져 있다면 처리합니다.
    $age = intval($user_input); // 숫자로 변환하여 사용할 수 있음
    echo "나이는 {$age}세입니다.";
} else {
    echo "나이는 숫자로 입력해주세요.";
}

코드 부연설명
intval() 함수는 인수로 전달된 값을 정수로 변환하여 반환합니다.

참고문헌

같이 보기