Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk::IO (3)

Name

Tk::IO - high level interface to Tk's 'fileevent' mechanism

Synopsis

my $fh = Tk::IO->new(-linecommand => callback, -childcommand => callback);
$fh->exec("command")
$fh->wait
$fh->kill

Description

User Contributed Perl Documentation                                      IO(3)



NAME
       Tk::IO - high level interface to Tk's 'fileevent' mechanism

SYNOPSIS
         my $fh = Tk::IO->new(-linecommand => callback, -childcommand => callback);
         $fh->exec("command")
         $fh->wait
         $fh->kill

WARNING
       INTERFACES TO THIS MODULE MAY CHANGE AS PERL'S IO EVOLVES AND WITH PORT
       OF TK4.1

DESCRIPTION
       Tk::IO is now layered on perl's IO::Handle class. Interfaces have
       changed, and are still evolving.

       In theory C methods which enable non-blocking IO as in earlier Tk-b*
       release(s) are still there. I have not changed them to use perl's
       additional Configure information, or tested them much.

       Assumption is that exec is used to fork a child process and a callback
       is called each time a complete line arrives up the implied pipe.

       "line" should probably be defined in terms of perl's input record
       separator but is not yet.

       The -childcommand callback is called when end-of-file occurs.

       $fh->wait can be used to wait for child process while processing other
       Tk events.

       $fh->kill can be used to send signal to child process.

BUGS
       Still not finished.  Idea is to use "exec" to emulate "system" in a
       non-blocking manner.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------------+
       |ATTRIBUTE TYPE |      ATTRIBUTE VALUE       |
       +---------------+----------------------------+
       |Availability   | library/perl-5/perl-tk-532 |
       +---------------+----------------------------+
       |Stability      | Volatile                   |
       +---------------+----------------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/S/SR/SREZIC/Tk-804.036.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~srezic/Tk.



perl v5.32.0                      2013-11-15                             IO(3)