Ctype.h

ctype.h

Стандартная библиотека языка программирования С

assert.h complex.h ctype.h errno.h fenv.h float.h inttypes.h iso646.h limits.h locale.h math.h setjmp.h signal.h stdarg.h stdbool.h stddef.h stdint.h stdio.h stdlib.h string.h tgmath.h time.h wchar.h wctype.h

ctype.h — заголовочный файл стандартной библиотеки языка программирования С, содержащий объявления функций для классификации и преобразования отдельных символов.

Основные функции

Все перечисленные ниже функции имеют прототипы следующего вида:

int имя_функции( int );

Все эти функции принимают в качестве аргумента int-эквивалент символа и возвращают значение типа int, которое может представлять или другой символ (в случае функций преобразования), или логическое значение: 0 означает «Ложь», а отличное от нуля значение — «Истина» (это относится к функциям классификации).

Результат применения этих функций к символам с кодами 128—255 зависит от платформы и локализации.

Функции классификации

Имя функции	Проверяет, является ли аргумент…
isalnum	…буквой или цифрой
isalpha	…буквой
iscntrl	…управляющим символом
isdigit	…цифрой
isgraph	…символом, имеющим графическое представление
islower	…буквой в нижнем регистре
isprint	…символом, который может быть напечатан
ispunct	…символом, имеющим графическое представление, но не являющимся при этом буквой или цифрой
isspace	…разделительным символом
isupper	…буквой в верхнем регистре
isxdigit	…цифрой шестнадцатиричной системы счисления

Функции преобразования

Имя функции	Описание
tolower	Преобразует аргумент в его строчный аналог (нижний регистр), если это возможно; иначе возвращается неизмененный аргумент.
toupper	Преобразует аргумент в его прописной аналог (верхний регистр), если это возможно; иначе возвращается неизмененный аргумент.

Реализация функций

В большинстве библиотек языка C подпрограммы классификации используют статические таблицы поиска вместо макросов или функций. Например, создается массив из 256 восьмибитовых целых чисел, где каждый бит означает определенныое свойство символа (является цифрой, буквой и т. д.). Если бит 1 показывает, цифра данный символ или нет, то код мог бы быть записан так:

#define isdigit(x) (TABLE[x] & 1)

Ранние версии Linux использовали потенциально опасный код, подобный следующему:

#define isdigit(x) ((x) >= '0' && (x) <= '9')

Это могло вызвать проблемы, если в качестве аргумента использовался, например, вызов функции. В таком случае сразу не было видно, что функция вызывается дважды.

Неправильное использование

Во всех случаях аргумент имеет тип int, причем его значение должно принадлежать диапазону значений типа unsigned int, или же быть равным значению макроконстанты EOF. Если аргумент имеет любое другое значение, поведение функций не определено.

Тип char в зависимости от реализации может быть как знаковым, так и беззнаковым. Если тип char является знаковым, то неявное преобразование в int может привести к появлению отрицательных чисел, что вызовет неопределенное поведение функции. Чаще всего происходит выход за пределы таблицы поиска и аварийное завершение программы.

//Этот код может работать некорректно.
char test = 'b';
 
toupper( 'a' );
int res = ispunct( test );

Чтобы избежать этого, используя char-аргументы, сперва явно преобразуйте их в unsigned char.

int-значения, возвращаемые функциями getchar, getc, fgetc обязательно принадлежат диапазону значений типа unsigned char (или равны EOF), поэтому здесь преобразование не требуется.

Примеры использования

//Следующий код считывает символ и преобразует его в
//число типа int, если введена цифра.
#include <stdio.h>
#include <stdlib.h>
#include <ctype.h>
 
int main () {
  unsigned char c;
  do {
    scanf( "%c", &c );
    if ( isdigit( c ) )
      printf( "You have input a number %i", atoi( &c ) );
    else
      printf( "It is not a number!" );
  } while ( c != EOF );
  return 0;
}

Ссылки

• ctype.h — основные определения, The Single UNIX® Specification, выпуск 7 от The Open Group (англ.)
• ctype.h на C++ Reference