虚拟方法

GioFilereplace_readwrite

自版本 2.22

声明 [源代码]

GFileIOStream*
replace_readwrite (
  GFile* file,
  const char* etag,
  gboolean make_backup,
  GFileCreateFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [源代码]

返回一个输出流以在读写模式下覆盖文件，可能首先创建文件备份。如果文件不存在，则创建它。

对于行为的详细信息，请参阅 g_file_replace，它执行相同的操作但仅返回输出流。

注意，在许多非本地文件情况下，不支持读写流，请确保您确实需要执行读写流操作，而不仅仅是打开读取或写入。

从版本 2.22 可用

参数

etag

类型: const char*

当前GFile的可选实体标签，或NULL以忽略。

参数可以NULL。

数据由方法的调用者拥有。

值是一个以NUL终止的UTF-8字符串。

make_backup

类型: gboolean

true表示应该创建备份。

flags

类型: GFileCreateFlags

一组GFileCreateFlags。

cancellable

类型: GCancellable

可选的 GCancellable 对象，NULL以忽略。

参数可以NULL。

数据由方法的调用者拥有。

error

类型: GError **

一个可恢复错误的返回位置。

参数可以NULL。

如果返回位置不是NULL，则必须将其初始化为NULL GError*。

如果没有错误，虚拟函数将把参数留空初始化为NULL。

如果发生错误，参数将被设置为新分配的GError；调用者将拥有数据，并负责释放它。

返回值

类型: GFileIOStream

一个GFileIOStream或在错误时为NULL。使用 g_object_unref 释放返回的对象。

方法的调用者拥有返回的数据，并负责释放它。