📄 gfileoutputstream.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>GFileOutputStream</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GIO Reference Manual"><link rel="up" href="streaming.html" title="Streaming I/O"><link rel="prev" href="GFileInputStream.html" title="GFileInputStream"><link rel="next" href="GFilterInputStream.html" title="GFilterInputStream"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="pt01.html" title="Part I. GIO Overview"><link rel="chapter" href="ch01.html" title="Introduction"><link rel="chapter" href="ch02.html" title="Compiling GIO applications"><link rel="chapter" href="ch03.html" title="Running GIO applications"><link rel="chapter" href="gio-extension-points.html" title="Extending GIO"><link rel="part" href="pt02.html" title="Part II. API Reference"><link rel="chapter" href="file_ops.html" title="File Operations"><link rel="chapter" href="file_mon.html" title="File System Monitoring"><link rel="chapter" href="async.html" title="Asynchronous I/O"><link rel="chapter" href="streaming.html" title="Streaming I/O"><link rel="chapter" href="types.html" title="File types and applications"><link rel="chapter" href="volume_mon.html" title="Volumes and Drives"><link rel="chapter" href="icons.html" title="Icons"><link rel="chapter" href="utils.html" title="Utilities"><link rel="chapter" href="extending.html" title="Extending GIO"><link rel="part" href="migrating.html" title="Part III. Migrating to GIO"><link rel="chapter" href="ch14.html" title="Migrating from POSIX to GIO"><link rel="chapter" href="ch15.html" title="Migrating from GnomeVFS to GIO"><link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy"><link rel="index" href="ix01.html" title="Index"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GFileInputStream.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="streaming.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GIO Reference Manual</th><td><a accesskey="n" href="GFilterInputStream.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3059624" class="shortcut">Top</a>  |  <a href="#id3189375" class="shortcut">Description</a>  |  <a href="#id3189324" class="shortcut">Object Hierarchy</a>  |  <a href="#id3189354" class="shortcut">Implemented Interfaces</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="GFileOutputStream"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3059624"></a><span class="refentrytitle">GFileOutputStream</span></h2><p>GFileOutputStream — File output streaming operations</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gio/gio.h> <a class="link" href="GFileOutputStream.html#GFileOutputStream-struct">GFileOutputStream</a>;<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a>* <a class="link" href="GFileOutputStream.html#g-file-output-stream-query-info">g_file_output_stream_query_info</a> (<a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *stream, char *attributes, <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable, <ahref="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error);void <a class="link" href="GFileOutputStream.html#g-file-output-stream-query-info-async">g_file_output_stream_query_info_async</a> (<a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *stream, char *attributes, int io_priority, <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable, <a class="link" href="GAsyncResult.html#GAsyncReadyCallback">GAsyncReadyCallback</a> callback, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a>* <a class="link" href="GFileOutputStream.html#g-file-output-stream-query-info-finish">g_file_output_stream_query_info_finish</a> (<a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *stream, <a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result, <ahref="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error);char* <a class="link" href="GFileOutputStream.html#g-file-output-stream-get-etag">g_file_output_stream_get_etag</a> (<a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *stream);</pre></div><div class="refsect1" lang="en"><a name="id3189324"></a><h2>Object Hierarchy</h2><pre class="synopsis"> <ahref="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> +----<a class="link" href="GOutputStream.html" title="GOutputStream">GOutputStream</a> +----GFileOutputStream</pre></div><div class="refsect1" lang="en"><a name="id3189354"></a><h2>Implemented Interfaces</h2><p>GFileOutputStream implements <a class="link" href="GSeekable.html" title="GSeekable">GSeekable</a>.</p></div><div class="refsect1" lang="en"><a name="id3189375"></a><h2>Description</h2><p>GFileOutputStream provides output streams that write theircontent to a file.</p><p>GFileOutputStream implements <a class="link" href="GSeekable.html" title="GSeekable"><span class="type">GSeekable</span></a>, which allows the output stream to jump to arbitrary positions in the file and to truncatethe file, provided the filesystem of the file supports these operations. In addition to the generic g_seekable_ API, GFileOutputStream has its own API for seeking and positioning. To find the position of a file output stream, use <code class="function">g_file_output_stream_tell()</code>. To find out if a file output stream supports seeking, use <code class="function">g_file_output_stream_can_seek()</code>.To position a file output stream, use <code class="function">g_file_output_stream_seek()</code>.To find out if a file output stream supports truncating, use<code class="function">g_file_output_stream_can_truncate()</code>. To truncate a file outputstream, use <code class="function">g_file_output_stream_truncate()</code>.</p><p></p></div><div class="refsect1" lang="en"><a name="id3189459"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3189470"></a><h3><a name="GFileOutputStream-struct"></a>GFileOutputStream</h3><a class="indexterm" name="id3189482"></a><pre class="programlisting">typedef struct _GFileOutputStream GFileOutputStream;</pre><p>A subclass of GOutputStream for opened files. This addsa few file-specific operations and seeking and truncating.</p><p><a class="link" href="GFileOutputStream.html" title="GFileOutputStream"><span class="type">GFileOutputStream</span></a> implements GSeekable.</p><p></p></div><hr><div class="refsect2" lang="en"><a name="id3189515"></a><h3><a name="g-file-output-stream-query-info"></a>g_file_output_stream_query_info ()</h3><a class="indexterm" name="id3189528"></a><pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a>* g_file_output_stream_query_info (<a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *stream, char *attributes, <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable, <ahref="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError">GError</a> **error);</pre><p>Queries a file output stream for the given <em class="parameter"><code>attributes</code></em>. This function blocks while querying the stream. For the asynchronous version of this function, see <a class="link" href="GFileOutputStream.html#g-file-output-stream-query-info-async"><code class="function">g_file_output_stream_query_info_async()</code></a>. While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will fail with <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING:CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a>.</p><p>Can fail if the stream was already closed (with <em class="parameter"><code>error</code></em> being set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-CLOSED:CAPS"><code class="literal">G_IO_ERROR_CLOSED</code></a>), the stream has pending operations (with <em class="parameter"><code>error</code></em> beingset to <a class="link" href="gio-GIOError.html#G-IO-ERROR-PENDING:CAPS"><code class="literal">G_IO_ERROR_PENDING</code></a>), or if querying info is not supported for the stream's interface (with <em class="parameter"><code>error</code></em> being set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a>). Inall cases of failure, <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.</p><p>If <em class="parameter"><code>cancellable</code></em> is not <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled bytriggering the cancellable object from another thread. If the operationwas cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be set, and <ahref="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.</p><p></p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -