# C 语言标准库函数 isgraph

/*********************************************
 * @brief 判断一个字符是否是图形字符
 * @param ch 要判断的字符
 * @return 是（非 0）否（0）是图形字符
 ********************************************/
int isgraph(int ch);

!subtitle:说明

判断字符 ch 是否是图形字符。

如果 ch 的值超出 unsigned char 的范围且不等于 EOF，则是未定义行为。

以下字符属于图形字符：

• 数字（0123456789）

• 大写字母 (ABCDEFGHIJKLMNOPQRSTUVWXYZ)

• 小写字母（abcdefghijklmnopqrstuvwxyz）

• 标点符号（!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~）

• 当前语言环境下的文字和符号，例如汉字

空格、制表符、换行符等 不属于 图形字符，而属于 可打印字符。

!subtitle:参数

• ch - 要判断的字符

!subtitle:返回值

• 如果 ch 是图形字符，则返回非 0

• 如果不是，则返回 0

# 示例

#include <stdio.h>
#include <ctype.h>

int main(void) {
    int values[] = {'a', 'F', 'Z', '1', '2', ',', '*', ' ', '\t', '\n'};

    for (int i = 0; i < sizeof(values) / sizeof(int); i += 1)
    {
        printf("isgraph(%c) 的结果为 %d\n", values[i], isgraph(values[i]));
    }

    return 0;
}

运行结果：

isgraph(a) 的结果为 32768
isgraph(F) 的结果为 32768
isgraph(Z) 的结果为 32768
isgraph(1) 的结果为 32768
isgraph(2) 的结果为 32768
isgraph(,) 的结果为 32768
isgraph(*) 的结果为 32768
isgraph( ) 的结果为 0
isgraph(	) 的结果为 0
isgraph(
) 的结果为 0

# 推荐阅读

• C 语言标准库类型 iscntrl

• C 语言标准库函数 isspace

• C 语言标准库函数 isblank

• C 语言标准库函数 isprint

• C 语言标准库函数 ispunct

# 外部参考

• isgraph - cppreference

• isgraph - POSIX

# 参考标准

• C23 standard (ISO/IEC 9899:2024):

  • 7.4.1.6 The isgraph function (p: TBD)

• C17 standard (ISO/IEC 9899:2018):

  • 7.4.1.6 The isgraph function (p: 145)

• C11 standard (ISO/IEC 9899:2011):

  • 7.4.1.6 The isgraph function (p: 200)

• C99 standard (ISO/IEC 9899:1999):

  • 7.4.1.6 The isgraph function (p: 181)

• C89/C90 standard (ISO/IEC 9899:1990):

  • 4.3.1.5 The isgraph function