1tcl::chan::cat(n)      Reflected/virtual channel support     tcl::chan::cat(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       tcl::chan::cat - Concatenation channel
9

SYNOPSIS

11       package require Tcl  8.5
12
13       package require TclOO
14
15       package require tcl::chan::core  ?1?
16
17       package require tcl::chan::cat  ?1?
18
19       ::tcl::chan::cat chan...
20
21______________________________________________________________________________
22

DESCRIPTION

24       The  tcl::chan::cat  package  provides a command creating concatenation
25       channels. These are non-seekable channels owning a list of  subordinate
26       channels  whose contents they return in order, until all are exhausted.
27       In this manner the channel is the concatentation of the contents of all
28       the sub-ordinate channels.
29
30       Note that the created channels take ownership of the channels they were
31       constructed with. Whenever they have exhausted one of their channel  it
32       will  be  closed. Similarly, closing the cat channel will close all the
33       sub-ordinates it still has.
34
35       The internal TclOO class implementing the channel  handler  is  a  sub-
36       class of the tcl::chan::core framework.
37
38       Event handling is delegated to the currently active sub-channel.
39

API

41       ::tcl::chan::cat chan...
42              This  command  creates  the  concatenation channel using all the
43              provided channels, and returns its handle.
44

BUGS, IDEAS, FEEDBACK

46       This document, and the package it describes, will  undoubtedly  contain
47       bugs  and other problems.  Please report such in the category virtchan‐
48       nel  of  the  Tcllib  Trackers  [http://core.tcl.tk/tcllib/reportlist].
49       Please  also  report any ideas for enhancements you may have for either
50       package and/or documentation.
51
52       When proposing code changes, please provide unified diffs, i.e the out‐
53       put of diff -u.
54
55       Note  further  that  attachments  are  strongly  preferred over inlined
56       patches. Attachments can be made by going  to  the  Edit  form  of  the
57       ticket  immediately  after  its  creation, and then using the left-most
58       button in the secondary navigation bar.
59

KEYWORDS

61       concatenation channel, reflected channel, tip 219, virtual channel
62

CATEGORY

64       Channels
65

67       Copyright (c) 2011 Andreas Kupries <andreas_kupries@users.sourceforge.net>
68
69
70
71
72tcllib                                 1                     tcl::chan::cat(n)
Impressum