函数
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
。
函数的调用者将拥有这些数据,并负责释放它。 |