puts man page on OpenDarwin

Man page or keyword search:  
man Server   3202 pages
apropos Keyword Search (all sections)
Output format
OpenDarwin logo
[printable version]

puts(n)			     Tcl Built-In Commands		       puts(n)

______________________________________________________________________________

NAME
       puts - Write to a channel

SYNOPSIS
       puts ?-nonewline? ?channelId? string
_________________________________________________________________

DESCRIPTION
       Writes  the  characters	given  by string to the channel given by chan‐
       nelId.

       ChannelId must be an identifier for an open channel such as a Tcl stan‐ │
       dard channel (stdout or stderr), the return value from an invocation of │
       open or socket, or the result of a channel creation command provided by │
       a Tcl extension. The channel must have been opened for output.

       If  no channelId is specified then it defaults to stdout. Puts normally
       outputs a newline character after string, but this feature may be  sup‐
       pressed by specifying the -nonewline switch.

       Newline	characters  in	the output are translated by puts to platform-
       specific end-of-line sequences according to the current	value  of  the
       -translation  option  for the channel (for example, on PCs newlines are
       normally replaced with carriage-return-linefeed sequences;   on	Macin‐
       toshes  newlines are normally replaced with carriage-returns).  See the
       fconfigure manual entry for a discussion on ways	 in  which  fconfigure
       will alter output.

       Tcl  buffers output internally, so characters written with puts may not
       appear immediately on the output file or	 device;   Tcl	will  normally
       delay  output  until  the buffer is full or the channel is closed.  You
       can force output to appear immediately with the flush command.

       When the output buffer fills up, the puts command will  normally	 block
       until all the buffered data has been accepted for output by the operat‐
       ing system.  If channelId is in nonblocking mode then the puts  command
       will  not  block	 even  if the operating system cannot accept the data.
       Instead, Tcl continues to buffer the data and writes it	in  the	 back‐
       ground  as  fast	 as  the underlying file or device can accept it.  The
       application must use the Tcl event loop for nonblocking output to work;
       otherwise Tcl never finds out that the file or device is ready for more
       output data.  It is possible for an arbitrarily large amount of data to
       be  buffered  for  a channel in nonblocking mode, which could consume a
       large amount of memory.	 To  avoid  wasting  memory,  nonblocking  I/O
       should  normally	 be used in an event-driven fashion with the fileevent
       command (don't invoke puts unless you have recently been notified via a
       file event that the channel is ready for more output data).

SEE ALSO
       file(n), fileevent(n), Tcl_StandardChannels(3)

KEYWORDS
       channel, newline, output, write

Tcl				      7.5			       puts(n)
[top]

List of man pages available for OpenDarwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net