View source for CoCoA:OpenOString

  <command>
    <title>OpenOString</title>
    <short_description>open output string</short_description>

    <description>
This function opens strings for output.  The string S
serves as the name of the device opened for input or output; one may
use the empty string.  <tt>OpenOString</tt> is used to write to a
string with the help of <tt>Print On</tt>.

<example>
  D := OpenOString(<quotes/>);  -- open a string for output from CoCoA
  L := [1,2,3]; -- a list
  Print L On D;  -- print to D
  D;
Record[Name = <quotes/>, Type = <quotes>OString</quotes>, Protocol = <quotes>CoCoAL</quotes>]
-------------------------------
  S := Cast(D,STRING);  -- S is the string output to D
  S; -- a string
[1, 2, 3]
-------------------------------
  Print <quotes> more characters</quotes> On D;  -- append to the existing output string
  Cast(D,STRING);
[1, 2, 3] more characters
-------------------------------
</example>
    </description>

    <syntax>
OpenOString(S:STRING):DEVICE
</syntax>

    <see>Close</see>
    <see>Introduction to IO</see>
    <see>OpenIFile</see>
    <see>OpenOFile</see>
    <see>OpenIString</see>
    <see>Source</see>
    <see>Sprint</see>

    <type>io</type>
    <type>printing</type>
    <type>string</type>

    <key>openostring</key>
  </command>