1 /* 2 * This file is part of gtkD. 3 * 4 * gtkD is free software; you can redistribute it and/or modify 5 * it under the terms of the GNU Lesser General Public License 6 * as published by the Free Software Foundation; either version 3 7 * of the License, or (at your option) any later version, with 8 * some exceptions, please read the COPYING file. 9 * 10 * gtkD is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public License 16 * along with gtkD; if not, write to the Free Software 17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA 18 */ 19 20 // generated automatically - do not change 21 // find conversion definition on APILookup.txt 22 // implement new conversion functionalities on the wrap.utils pakage 23 24 25 module gio.SeekableIF; 26 27 private import gio.Cancellable; 28 private import glib.ErrorG; 29 private import glib.GException; 30 private import gtkc.gio; 31 public import gtkc.giotypes; 32 33 34 /** 35 * #GSeekable is implemented by streams (implementations of 36 * #GInputStream or #GOutputStream) that support seeking. 37 * 38 * Seekable streams largely fall into two categories: resizable and 39 * fixed-size. 40 * 41 * #GSeekable on fixed-sized streams is approximately the same as POSIX 42 * lseek() on a block device (for example: attmepting to seek past the 43 * end of the device is an error). Fixed streams typically cannot be 44 * truncated. 45 * 46 * #GSeekable on resizable streams is approximately the same as POSIX 47 * lseek() on a normal file. Seeking past the end and writing data will 48 * usually cause the stream to resize by introducing zero bytes. 49 */ 50 public interface SeekableIF{ 51 /** Get the main Gtk struct */ 52 public GSeekable* getSeekableStruct(); 53 54 /** the main Gtk struct as a void* */ 55 protected void* getStruct(); 56 57 /** 58 */ 59 60 /** 61 * Tests if the stream supports the #GSeekableIface. 62 * 63 * Return: %TRUE if @seekable can be seeked. %FALSE otherwise. 64 */ 65 public bool canSeek(); 66 67 /** 68 * Tests if the stream can be truncated. 69 * 70 * Return: %TRUE if the stream can be truncated, %FALSE otherwise. 71 */ 72 public bool canTruncate(); 73 74 /** 75 * Seeks in the stream by the given @offset, modified by @type. 76 * 77 * Attempting to seek past the end of the stream will have different 78 * results depending on if the stream is fixed-sized or resizable. If 79 * the stream is resizable then seeking past the end and then writing 80 * will result in zeros filling the empty space. Seeking past the end 81 * of a resizable stream and reading will result in EOF. Seeking past 82 * the end of a fixed-sized stream will fail. 83 * 84 * Any operation that would result in a negative offset will fail. 85 * 86 * If @cancellable is not %NULL, then the operation can be cancelled by 87 * triggering the cancellable object from another thread. If the operation 88 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. 89 * 90 * Params: 91 * offset = a #goffset. 92 * type = a #GSeekType. 93 * cancellable = optional #GCancellable object, %NULL to ignore. 94 * 95 * Return: %TRUE if successful. If an error 96 * has occurred, this function will return %FALSE and set @error 97 * appropriately if present. 98 * 99 * Throws: GException on failure. 100 */ 101 public bool seek(long offset, GSeekType type, Cancellable cancellable); 102 103 /** 104 * Tells the current position within the stream. 105 * 106 * Return: the offset from the beginning of the buffer. 107 */ 108 public long tell(); 109 110 /** 111 * Truncates a stream with a given #offset. 112 * 113 * If @cancellable is not %NULL, then the operation can be cancelled by 114 * triggering the cancellable object from another thread. If the operation 115 * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an 116 * operation was partially finished when the operation was cancelled the 117 * partial result will be returned, without an error. 118 * 119 * Params: 120 * offset = a #goffset. 121 * cancellable = optional #GCancellable object, %NULL to ignore. 122 * 123 * Return: %TRUE if successful. If an error 124 * has occurred, this function will return %FALSE and set @error 125 * appropriately if present. 126 * 127 * Throws: GException on failure. 128 */ 129 public bool truncate(long offset, Cancellable cancellable); 130 }