trusty (3) fifo2.3tcllib.gz

Provided by: tcllib_1.15-dfsg-2_all bug

NAME

       tcl::chan::fifo2 - In-memory interconnected fifo channels

SYNOPSIS

       package require Tcl  8.5

       package require TclOO

       package require tcl::chan::events  ?1?

       package require tcl::chan::halfpipe  ?1?

       package require tcl::chan::fifo2  ?1?

       ::tcl::chan::fifo2

_________________________________________________________________

DESCRIPTION

       The  tcl::chan::fifo2  package  provides a command creating pairs of channels which live purely in memory
       and are connected to each other in a fifo manner. What is written to one half of the  pair  can  be  read
       from  the  other  half,  in  the same order. One particular application for this is communication between
       threads, with one half of the pair moved to the thread to talk to.   This  is  equivalent  to  the  fifo2
       channels  provided  by  the package Mmechan, except that this is written in pure Tcl, not C. On the other
       hand, Memchan is usable with Tcl 8.4 and before, whereas this package requires Tcl  8.5  or  higher,  and
       TclOO.

       The  internal  TclOO  class  implementing  the  channel  handler  is a sub-class of the tcl::chan::events
       framework.

API

       ::tcl::chan::fifo2
              This command creates a new connected pair of fifo channels and returns their handles,  as  a  list
              containing two elements.

BUGS, IDEAS, FEEDBACK

       This  document,  and  the package it describes, will undoubtedly contain bugs and other problems.  Please
       report     such     in     the     category     virtchannel     of     the     Tcllib     SF     Trackers
       [http://sourceforge.net/tracker/?group_id=12883].   Please also report any ideas for enhancements you may
       have for either package and/or documentation.

KEYWORDS

       connected fifos, fifo, in-memory channel, inter-thread communication, reflected channel, tip 219, virtual
       channel

CATEGORY

       Channels

       Copyright (c) 2009 Andreas Kupries <andreas_kupries@users.sourceforge.net>