函数

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,则必须将其初始化为 NULLGError*
如果没有错误,则函数将保留初始化为 NULL 的参数。
发生错误时,参数将被设置为一个新的 GError;调用者将拥有这些数据,并负责释放它。

返回值

类型: GIOChannel

成功时返回 GIOChannel,失败时返回 NULL

函数的调用者将拥有这些数据,并负责释放它。