summary refs log tree commit diff
path: root/doc/zlib/inflatePrime.3
blob: c89dc2c511ed3ffb0db6a4ed412d03334d54d3fa (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
.Dd January 15, 2017
.Dt INFLATEPRIME 3
.Os
.
.Sh NAME
.Nm inflatePrime
.Nd insert bits in inflate stream
.
.Sh LIBRARY
.Lb libz
.
.Sh SYNOPSIS
.In zlib.h
.Ft int
.Fn inflatePrime "z_streamp strm" "int bits" "int value"
.
.Sh DESCRIPTION
This function inserts bits
in the inflate input stream.
The intent is that this function
is used to start inflating
at a bit position
in the middle of a byte.
The provided bits will be used
before any bytes are used from
.Fa next_in .
This function should only be used with raw inflate,
and should be used before the first
.Xr inflate 3
call after
.Xr inflateInit2 3
or
.Xr inflateReset 3 .
.Fa bits
must be less than or equal to 16,
and that many of the least significant bits of
.Fa value
will be inserted in the input.
.
.Pp
If
.Fa bits
is negative,
then the input stream bit buffer is emptied.
Then
.Fn inflatePrime
can be called again
to put bits in the buffer.
This is used to clear out bits leftover
after feeding inflate a block description
prior to feeding inflate codes.
.
.Sh RETURN VALUES
.Fn inflatePrime
returns
.Dv Z_OK
if success,
or
.Dv Z_STREAM_ERROR
if the source stream state was inconsistent.
.
.Sh SEE ALSO
.Xr inflateInit2 3
.
.Sh HISTORY
This manual page was converted from
.In zlib.h
to mdoc format by
.An C. McEnroe Aq Mt june@causal.agency .
.
.Sh AUTHORS
.An Jean-loup Gailly Aq Mt jloup@gzip.org
.An Mark Adler Aq Mt madler@alumni.caltech.edu