Imported Upstream version 1.1.3
[platform/upstream/libzip.git] / man / zip_source_seek_write.man
1 .TH "ZIP_SOURCE_SEEK_WRITE" "3" "November 18, 2014" "NiH" "Library Functions Manual"
2 .nh
3 .if n .ad l
4 .SH "NAME"
5 \fBzip_source_seek_write\fR
6 \- set write offset in zip source
7 .SH "LIBRARY"
8 libzip (-lzip)
9 .SH "SYNOPSIS"
10 \fB#include <zip.h>\fR
11 .sp
12 \fIint\fR
13 .PD 0
14 .HP 4n
15 \fBzip_source_seek_write\fR(\fIzip_source_t\ *source\fR, \fIzip_int64_t\ offset\fR, \fIint\ whence\fR);
16 .PD
17 .SH "DESCRIPTION"
18 The function
19 \fBzip_source_seek_write\fR()
20 sets the current write offset for
21 \fIsource\fR.
22 Just like in
23 fseek(3),
24 depending on the
25 \fIwhence\fR
26 argument, the
27 \fIoffset\fR
28 is counted relative from:
29 .RS 6n
30 .TP 12n
31 \fRSEEK_SET\fR
32 start of file
33 .TP 12n
34 \fRSEEK_CUR\fR
35 current write offset in file
36 .TP 12n
37 \fRSEEK_END\fR
38 end of file
39 .RE
40 .SH "RETURN VALUES"
41 Upon successful completion 0 is returned.
42 Otherwise, \-1 is returned and the error information in
43 \fIsource\fR
44 is set to indicate the error.
45 .SH "SEE ALSO"
46 libzip(3),
47 zip_source(3),
48 zip_source_begin_write(3),
49 zip_source_commit_write(3),
50 zip_source_rollback_write(3),
51 zip_source_tell_write(3),
52 zip_source_write(3)
53 .SH "AUTHORS"
54 Dieter Baron <\fIdillo@nih.at\fR>
55 and
56 Thomas Klausner <\fItk@giga.or.at\fR>