annotate doc/libaudacious/tmpl/vfs.sgml @ 2060:53a3d5db6b58 trunk

[svn] - finish documenting the libaudacious API
author nenolod
date Mon, 04 Dec 2006 19:24:14 -0800
parents c43fb0845b71
children 0264fabf471d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2034
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
1 <!-- ##### SECTION Title ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
2 VFS
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
3
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
4 <!-- ##### SECTION Short_Description ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
5 Stream-based I/O in Audacious
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
6
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
7 <!-- ##### SECTION Long_Description ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
8 <para>
2060
53a3d5db6b58 [svn] - finish documenting the libaudacious API
nenolod
parents: 2034
diff changeset
9 Audacious uses the VFS subsystem for implementing the I/O transport layer. VFSConstructors provide a base table for deriving streams from. Stream
53a3d5db6b58 [svn] - finish documenting the libaudacious API
nenolod
parents: 2034
diff changeset
10 methods may be derived from the base classes registered with the VFS subsystem via vfs_register_transport().
2034
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
11 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
12
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
13 <!-- ##### SECTION See_Also ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
14 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
15
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
16 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
17
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
18 <!-- ##### SECTION Stability_Level ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
19
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
20
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
21 <!-- ##### STRUCT VFSFile ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
22 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
23
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
24 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
25
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
26 @uri:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
27 @handle:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
28 @base:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
29
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
30 <!-- ##### STRUCT VFSConstructor ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
31 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
32
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
33 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
34
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
35 @uri_id:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
36 @vfs_fopen_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
37 @vfs_fclose_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
38 @vfs_fread_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
39 @vfs_fwrite_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
40 @vfs_getc_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
41 @vfs_ungetc_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
42 @vfs_fseek_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
43 @vfs_rewind_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
44 @vfs_ftell_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
45 @vfs_feof_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
46 @vfs_truncate_impl:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
47
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
48 <!-- ##### FUNCTION vfs_fopen ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
49 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
50
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
51 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
52
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
53 @path:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
54 @mode:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
55 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
56
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
57
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
58 <!-- ##### FUNCTION vfs_fclose ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
59 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
60
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
61 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
62
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
63 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
64 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
65
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
66
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
67 <!-- ##### FUNCTION vfs_fread ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
68 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
69
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
70 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
71
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
72 @ptr:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
73 @size:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
74 @nmemb:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
75 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
76 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
77
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
78
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
79 <!-- ##### FUNCTION vfs_fwrite ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
80 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
81
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
82 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
83
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
84 @ptr:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
85 @size:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
86 @nmemb:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
87 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
88 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
89
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
90
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
91 <!-- ##### FUNCTION vfs_getc ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
92 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
93
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
94 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
95
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
96 @stream:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
97 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
98
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
99
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
100 <!-- ##### FUNCTION vfs_ungetc ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
101 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
102
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
103 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
104
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
105 @c:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
106 @stream:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
107 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
108
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
109
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
110 <!-- ##### FUNCTION vfs_fgets ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
111 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
112
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
113 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
114
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
115 @s:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
116 @n:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
117 @stream:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
118 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
119
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
120
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
121 <!-- ##### FUNCTION vfs_fseek ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
122 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
123
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
124 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
125
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
126 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
127 @offset:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
128 @whence:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
129 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
130
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
131
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
132 <!-- ##### FUNCTION vfs_rewind ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
133 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
134
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
135 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
136
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
137 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
138
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
139
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
140 <!-- ##### FUNCTION vfs_ftell ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
141 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
142
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
143 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
144
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
145 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
146 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
147
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
148
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
149 <!-- ##### FUNCTION vfs_feof ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
150 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
151
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
152 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
153
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
154 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
155 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
156
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
157
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
158 <!-- ##### FUNCTION vfs_file_test ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
159 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
160
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
161 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
162
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
163 @path:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
164 @test:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
165 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
166
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
167
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
168 <!-- ##### FUNCTION vfs_is_writeable ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
169 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
170
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
171 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
172
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
173 @path:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
174 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
175
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
176
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
177 <!-- ##### FUNCTION vfs_truncate ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
178 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
179
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
180 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
181
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
182 @file:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
183 @length:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
184 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
185
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
186
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
187 <!-- ##### FUNCTION vfs_fprintf ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
188 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
189
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
190 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
191
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
192 @stream:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
193 @format:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
194 @Varargs:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
195 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
196
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
197
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
198 <!-- ##### FUNCTION vfs_register_transport ##### -->
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
199 <para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
200
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
201 </para>
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
202
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
203 @vtable:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
204 @Returns:
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
205
c43fb0845b71 [svn] - update VFS documentation
nenolod
parents:
diff changeset
206