from small one page howto to huge articles all in one place
Last additions:
May 25th. 2007:
April, 26th. 2006:
| 
ZIP_FILE_SET_COMMENT
Section: C Library Functions (3) Index
Return to Main Contents
BSD mandoc
NAME
zip_file_set_comment
- set comment for file in zip
LIBRARY
libzip -lzip)
SYNOPSIS
In zip.h
Ft int
Fn zip_file_set_comment zip_t *archive zip_uint64_t index const char *comment zip_uint16_t len zip_flags_t flags
DESCRIPTION
The
Fn zip_file_set_comment
function sets the comment for the file at position
index
in the zip archive to
comment
of length
len
If
comment
is
NULL
and
len
is 0, the file comment will be removed.
The
flags
argument can be any of:
- ZIP_FL_ENC_GUESS
-
Guess encoding of
comment
(default).
(Only C-437 and UT-8 are recognized.)
- ZIP_FL_ENC_UTF_8
-
Interpret
comment
as UT-8.
- ZIP_FL_ENC_CP437
-
Interpret
comment
as code page 437 (C-437).
RETURN VALUES
Upon successful completion 0 is returned.
Otherwise, -1 is returned and the error information in
archive
is set to indicate the error.
ERRORS
Fn zip_file_set_comment
fails if:
- Bq Er ZIP_ER_INVAL
-
index
is not a valid file index in
archive
or
len
is less than 0 or longer than the maximum comment length in a zip file
(65535), or
comment
is not a valid UT-8 encoded string.
- Bq Er ZIP_ER_MEMORY
-
Required memory could not be allocated.
- Bq Er ZIP_ER_RDONLY
-
The
archive
was opened in rea-only mode.
SEE ALSO
libzip(3),
zip_file_get_comment3,
zip_get_archive_comment3,
zip_set_archive_comment3
HISTORY
Fn zip_file_set_comment
was added in libzip 0.11.
AUTHORS
An -nosplit
An Dieter Baron Aq Mt dillo@nih.at
and
An Thomas Klausner Aq Mt wiz@gatalith.at
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUES
-
- ERRORS
-
- SEE ALSO
-
- HISTORY
-
- AUTHORS
-
| 
|
|
- Running on 
-
:
