read from a stream until a boundary string is matched
LIBRARYPDEL Library (libpdel, -lpdel)
When the boundary string appears, the last character readable from the newly created boundary stream will be the character just before the first character of the boundary string. Therefore, the boundary string itself does not appear in the input from the boundary stream. In no case are any characters beyond the last character of the boundary string read out from the underlying stream, i.e., the last character read from the underlying stream will be the last character of the boundary string.
The boundary matching algorithm runs in linear time. However, the boundary string is limited to 255 characters in length (not counting the terminating '\0' byte).
fclose(3) should be used to close the returned stream. The closeit parameter determines whether the underlying stream fp is also closed when the boundary stream is closed.
Boundary streams are useful for online parsing of multipart MIME document body parts as defined in RFC 2046.
SEE ALSOcount_fopen(3), string_fp(3), libpdel(3)
N. Freed and N. Borenstein, Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types, RFC 2046.
HISTORYThe PDEL library was developed at Packet Design, LLC.
AUTHORSArchie Cobbs ⟨firstname.lastname@example.org⟩
Visit the GSP FreeBSD Man Page Interface.