FBB::Pipe

FBB::Pipe

libbobcat1-dev_2.02.03-x.tar.gz

2005-2009


FBB::Pipe(3bobcat)

FBB::Pipe(3bobcat)

libbobcat1-dev_2.02.03-x.tar.gz Error handler

2005-2009

NAME

FBB::Pipe - Defines a system level pipe

SYNOPSIS

#include <bobcat/pipe>
Linking option: -lbobcat

DESCRIPTION

FBB::Pipe objects may be used to construct a pipe. FBB::Pipe objects offer a simple interface to the reading and writing ends of pipes. FBB::Pipe objects are object-wrappers around the pipe(2) system call.

NAMESPACE

FBB
All constructors, members, operators and manipulators, mentioned in this man-page, are defined in the namespace FBB.

INHERITS FROM

-

CONSTRUCTORS

The copy constructor is available.

Note that when the pipe goes out of scope, no close(2) operation is performed on the pipe's ends. If the pipe should be closed by the desctructor, derive a class from Pipe(3bobcat), whose destructor performs the required closing-operation.

MEMBER FUNCTIONS

PROTECTED ENUMERATION

The RW protected enumeration has the following elements:

PROTECTED DATA

EXAMPLE


    #include <bobcat/pipe>
    #include <sys/types.h>
    #include <sys/wait.h>
    #include <unistd.h>
    #include <iostream>
    #include <string>
    
    using namespace std;
    using namespace FBB;
    
    int main()
    {
        Pipe p;                         // construct a pipe
    
        cout << "Read file descriptor: " << p.getReadFd() << endl;
        cout << "Write file descriptor: " << p.getWriteFd() << endl;
    
        int pid = fork();
    
        if (pid == -1)
            return 1;
    
        if (!pid)                       //child
        {
            p.readFrom(STDIN_FILENO);   // read what goes into the pipe
    
            string s;

            getline(cin, s);
            cout << "CHILD: Got `" << s << "'" << endl;    
    
            getline(cin, s);
            cout << "CHILD: Got `" << s << "'" << endl;    
    
            return 0;
        }
    
        p.writtenBy(STDOUT_FILENO);      // write to the pipe via cout
    
        cout << "first line" << endl;
        cout << "second line" << endl;
    
        waitpid(pid, 0, 0);
    
        return 0;
    }
        

FILES

bobcat/pipe - defines the class interface

SEE ALSO

bobcat(7), pipe(2)

BUGS

Note that when the pipe goes out of scope, no close(2) operation is performed on the pipe's ends. If the pipe should be closed by the desctructor, derive a class from Pipe(3bobcat), whose destructor performs the required closing-operation.

DISTRIBUTION FILES

BOBCAT

Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.

COPYRIGHT

This is free software, distributed under the terms of the GNU General Public License (GPL).

AUTHOR

Frank B. Brokken (f.b.brokken@rug.nl).