函数
GLibIOChannelnew_file
声明 [源码]
GIOChannel*
g_io_channel_new_file (
const gchar* filename,
const gchar* mode,
GError** error
)
描述 [源码]
以 mode 模式打开文件 filename 作为 GIOChannel。此通道将在最后一个对其的引用释放时关闭,因此不需要调用 g_io_channel_close()(尽管这样做不会造成问题,只要在通道关闭后不尝试访问该通道)。
参数
filename-
类型:
const gchar*包含文件名的字符串。
数据由函数的调用者拥有。 值是一个平台本机字符串,在 Unix 上使用首选的 OS 编码,在 Windows 上使用 UTF-8。 mode-
类型:
const gchar*“r”,“w”,“a”,“r+”,“w+”,“a+”之一。这些与 fopen() 中的含义相同。
数据由函数的调用者拥有。 值是一个以 NUL 终止的 UTF-8 字符串。 error-
类型:
GError **恢复性错误的返回位置。
参数可以是 NULL。如果返回位置不为 NULL,则必须将其初始化为NULL的GError*。如果没有错误,则函数将保留初始化为 NULL的参数。发生错误时,参数将被设置为一个新的 GError;调用者将拥有这些数据,并负责释放它。
返回值
类型: GIOChannel
成功时返回 GIOChannel,失败时返回 NULL。
| 函数的调用者将拥有这些数据,并负责释放它。 |