Manual Pages for UNIX Operating System command usage for man Tcl_Concat

Tcl Library Procedures                           Tcl_Concat(3TCL)



_________________________________________________________________

NAME
     Tcl_Concat - concatenate a collection of strings

SYNOPSIS
     #include 

     CONST char *
     Tcl_Concat(argc, argv)

ARGUMENTS
     int          argc               (in)      Number of strings.

     CONST char * CONST              argv[](in)
                                               Array  of  strings
                                               to    concatenate.
                                               Must   have   argc
                                               entries.
_________________________________________________________________


DESCRIPTION
     Tcl_Concat is a utility procedure used by several of the Tcl
     commands.   Given  a  collection of strings, it concatenates
     them together  into  a  single  string,  with  the  original
     strings  separated  by  spaces.  This procedure behaves dif-
     ferently than Tcl_Merge, in that the  arguments  are  simply
     concatenated:   no  effort  is  made  to  ensure proper list
     structure.  However, in most common usage the arguments will
     all  be  proper lists themselves;  if this is true, then the
     result will also have proper list structure.

     Tcl_Concat eliminates leading and trailing white space as it
     copies  strings  from  argv to the result.  If an element of
     argv consists of nothing but white space, then  that  string
     is  ignored entirely.  This white-space removal was added to
     make the output of the concat command cleaner-looking.

     The result string is dynamically allocated using  Tcl_Alloc;  |
     the  caller  must  eventually  release  the space by calling  |
     Tcl_Free.                                                     |

SEE ALSO                                                           |
     Tcl_ConcatObj                                                 |

KEYWORDS                                                           |
     concatenate, strings                                          |

ATTRIBUTES                                                         |
     See attributes(5) for descriptions of the  following  attri-  |
     butes:                                                        |



Tcl                     Last change: 7.5                        1






Tcl Library Procedures                           Tcl_Concat(3TCL)



     _______________________________________                       |
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|                       |
    |____________________|__________________|_                       |
    | Availability       |  runtime/tcl-8  |                       |
    |____________________|__________________|_                       |
    | Interface Stability|  Uncommitted    |                       |
    |____________________|_________________|                       ||||

NOTES                                                              |
     Source for Tcl is available on http://opensolaris.org.        |













































Tcl                     Last change: 7.5                        2