logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

memchan - Create and manipulate memory channels

Command

memchan ?-initial-size len?
              creates a chunk-oriented in-memory channel and returns its handle. If an initial size is specified
              the system will pre-allocate len bytes of buffer space for the contents. This is no restriction on
              the  ultimate  size of the channel, it will always grow as much as is necessary to accommodate the
              data written into it.

              The channels created here can be transferred between interpreters in the same thread  and  between
              threads,  but  only  as  a whole. It is not possible to use them to create a bi- or unidirectional
              connection between two interpreters.

       Memory channels created by memchan provide two read-only options which can be queried  via  the  standard
       fconfigure command. These are

       -length
              The value of this option is the number of bytes currently stored in the queried memory channel.

       -allocated
              The value of this option is the number of bytes currently allocated by the queried memory channel.
              This number is at least as big as the value of -length.

       As  the  channels  generated  by  memchan  grow  as necessary they are always writable. This means that a
       writable fileevent-handler will fire continuously.

       The channels are also readable if they contain more than zero bytes and the seek location is not and  the
       end of the channel. Under these conditions a readable fileevent-handler will fire continuously.

       Note  that  writing  to  such a channel usually occurs at the end, thus suppressing readable events. This
       also means that users have to take care to seek the channel to a location before the end before trying to
       read data back.

Description

       This  manpage  documents  both the overall package and the command memchan. The package itself provides a
       number of in-memory channels which can utilized to

       •      capture stream-like information in a natural way instead of using set  and  append  to  manipulate
              strings

       •      or to transfer data between interpreters, in the same thread or not.

Keywords

       channel, chunk, i/o, in-memory channel, memchan

Name

       memchan - Create and manipulate memory channels

See Also

       fifo, fifo2, null, random, zero

Synopsis

       package require Tcl

       package require memchanmemchan ?-initial-size len?

________________________________________________________________________________________________________________

See Also