Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
BOUNDARY_FOPEN(3) FreeBSD Library Functions Manual BOUNDARY_FOPEN(3)

read from a stream until a boundary string is matched

PDEL Library (libpdel, -lpdel)

#include <stdio.h>
#include <pdel/io/boundary_fp.h>

boundary_fopen(FILE *fp, const char *boundary, int closeit);

boundary_fopen() creates a new read-only stream that reads data from the underlying stream fp until the boundary string is encountered, after which EOF is returned. If the boundary string does not appear in the underlying stream input, the entire input is passed through unaltered.

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.

boundary_fopen() returns NULL to indicate an error, with errno set appropriately.

count_fopen(3), string_fp(3), libpdel(3)

N. Freed and N. Borenstein, Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types, RFC 2046.

The PDEL library was developed at Packet Design, LLC.

Archie Cobbs ⟨⟩
April 22, 2002 FreeBSD 13.1-RELEASE

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.