跳到主要内容

fgetchar

注意

这个$函数以小写字母开头。

描述​

从文件中读取单个字符。

名称描述
File:handle文件句柄（由 fopen 返回）
value此参数无实际作用，保持为 "0" 即可
bool:utf8若为 true 以 UTF-8 编码读取字符，否则以扩展 ASCII 编码读取（默认：true）

返回值​

成功时返回字符的扩展 ASCII 或 UTF-8 值，否则返回 EOF（文件末尾标识）。

示例​

// 以"只读"模式打开"file.txt"
new File:handle = fopen("file.txt", io_read);

// 声明变量"g_char"
new g_char;

// 检查"file.txt"是否成功打开
if (handle)
{
    // 读取所有字符（忽略UTF-8编码）
    while((g_char = fgetchar(handle, 0, false)) != EOF)
    {
        // 输出字符
        printf("[ \"file.txt\" ] 0x%x", g_char);
    }

    // 关闭"file.txt"
    fclose(handle);
}
else
{
    // 错误
    print("无法打开文件 \"file.txt\"。");
}

注意事项​

注意

使用无效句柄将导致服务器崩溃！请通过 fopen 或 ftemp 获取有效句柄。

相关函数​