Worksheet
ToString
convert an XML tree data structure representing a worksheet in the specified format and return it as a Maple string
Calling Sequence
Parameters
Description
Examples
ToString(xmlTree, format=output_format)
xmlTree
-
Maple XML tree; worksheet
format=output_format
(optional) equation; output_format can be one of "mws", "maple8_xml", or "mw" (default)
The ToString(xmlTree) calling sequence formats the XML document xmlTree representing a Maple worksheet as a MWS document (stored as a Maple string).
The xmlTree argument can either be the full document as read from a worksheet file, or a worksheet resulting from a call to DocumentTools:-Layout:-Worksheet (containing calls to other DocumentTools:-Layout and DocumentTools:-Components commands).
It is assumed that the XML document that is written to a string represents a valid worksheet. (Maple performs only a surface check.)
The returned XML document is formatted without line breaking or indentation of any kind. As a result, regardless of size, the document is returned as a single line of text.
The following examples demonstrate how a Maple XML tree data structure can be converted and returned as a string.
The ToString command converts the XML tree data structure doc and returns it as a Maple string str.
with⁡Worksheet:
str≔{VERSION 5 0 \"SUN SPARC SOLARIS\" \"5.0\" }{USTYLETAB }{SECT 0 {EXCHG {PARA 0 \"\" 0 \"\" {TEXT -1 21 \"Very simple worksheet\" }}{PARA 0 \"> \" 0 \"\"{MPLTEXT 1 0 16 \"with(Worksheet);\"}}}{EXCHG {PARA 0 \"> \" 0 \"\" {MPLTEXT 1 0 0 \"\" }}}}{MARK \"1 0 0\" 0 }{VIEWOPTS 1 1 0 1 1 1803 1 1 1 1 }{PAGENUMBERS 0 1 2 33 1 1 }
str≔{VERSION 5 0 "SUN SPARC SOLARIS" "5.0" }{USTYLETAB }{SECT 0 {EXCHG {PARA 0 "" 0 "" {TEXT -1 21 "Very simple worksheet" }}{PARA 0 "> " 0 ""{MPLTEXT 1 0 16 "with(Worksheet);"}}}{EXCHG {PARA 0 "> " 0 "" {MPLTEXT 1 0 0 "" }}}}{MARK "1 0 0" 0 }{VIEWOPTS 1 1 0 1 1 1803 1 1 1 1 }{PAGENUMBERS 0 1 2 33 1 1 }
doc≔FromString⁡str:
str1≔ToString⁡doc,format=mws:
str2≔ToString⁡doc,format=maple8_xml:
str3≔ToString⁡doc,format=mw:
The string str is parsed and converted back to an XML tree data structure doc1 by using the FromString command.
doc1≔FromString⁡str3:
The Display command launches the worksheets. The Display command launches the string str and the XML tree doc1. For information on Display command parameters, see Worksheet[Display].
Display⁡str:
Display⁡doc1:
To generate a similar document using the DocumentTools:-Layout commands, we can proceed as follows.
with⁡DocumentTools:-Layout:
txt≔Textfield⁡Very simple worksheet,alignment=left
txt≔_XML_Text-field⁡alignment=left,style=Text,layout=Normal,Very simple worksheet
withstmt≔Textfield⁡with(Worksheet);,alignment=left,layout=Maple,prompt=> ,style=MapleInput
withstmt≔_XML_Text-field⁡prompt=> ,alignment=left,style=Maple Input,layout=Maple Output,with(Worksheet);
emptystmt≔Textfield⁡alignment=left,layout=Maple,prompt=> ,style=MapleInput
emptystmt≔_XML_Text-field⁡prompt=> ,alignment=left,style=Maple Input,layout=Maple Output
dxml≔Worksheet⁡Group⁡Input⁡txt,Input⁡withstmt,Group⁡emptystmt
dxml≔_XML_Worksheet⁡_XML_Group⁡view=presentation,hide-input=false,hide-output=false,inline-output=false,drawlabel=true,_XML_Input⁡_XML_Text-field⁡alignment=left,style=Text,layout=Normal,Very simple worksheet,_XML_Input⁡_XML_Text-field⁡prompt=> ,alignment=left,style=Maple Input,layout=Maple Output,with(Worksheet);,_XML_Group⁡view=presentation,hide-input=false,hide-output=false,inline-output=false,drawlabel=true,_XML_Text-field⁡prompt=> ,alignment=left,style=Maple Input,layout=Maple Output
dstr≔ToString⁡dxml
dstr≔<Worksheet><Group view='presentation' hide-input='false' hide-output='false' inline-output='false' drawlabel='true'><Input><Text-field alignment='left' style='Text' layout='Normal'>Very simple worksheet</Text-field></Input><Input><Text-field prompt='> ' alignment='left' style='Maple Input' layout='Maple Output'>with(Worksheet);</Text-field></Input></Group><Group view='presentation' hide-input='false' hide-output='false' inline-output='false' drawlabel='true'><Text-field prompt='> ' alignment='left' style='Maple Input' layout='Maple Output'/></Group></Worksheet>
Display⁡dstr
See Also
Worksheet[FromString]
XMLTools
Download Help Document