NAME

       HTMLDocument::readFromString - Convert a String to HTML

SYNOPSIS

       Void readFromString( ElementTree location, String input, WhiteList safety, Doctype doctype
       )

ARGUMENTS

       location The location in the document to append the converted String

       input The String to convert

       safety The allowed elements and attributes

       doctype The document type of the input string. This is independent of the document type of
       the  document  and  controls  certain  aspects of parsing - for example, if the doctype is
       HTML4Strict , the end tags for p or td elements may be omitted, and the code will be case-
       insensitive.

DESCRIPTION

       Convert  a  String  to HTML. An Exception will be thrown if the parser cannot construct an
       unambiguous tree from the string, and it is considerably less forgiving than  the  parsers
       in  most  web  browsers.  (On  the  other hand, it's a bit more forgiving in places than a
       strict XML parser, especially if the HTML4Strict doctype is used). As usual, parsing  with
       XHTML strictness will be quicker.

       Read  the HTMLDocument.WhiteList (3kaya) documentation for important information on safety
       when converting these Strings

       If you need to read poor-quality HTML, you can use the TagSoup  setting  for  the  doctype
       parameter,  but  this  will  be somewhat slower - if you're writing the HTML yourself it's
       much more efficient to write good quality code in the  first  place.  This  parsing  model
       rarely throws an Exception (though it is still possible on very poor code)

    str = "<p>This is a <strong>crucial</strong> paragraph</p>";
    readFromString(parent,str,AllElements(Safe),HTML4Strict);

AUTHORS

       Kaya  standard  library  by  Edwin Brady, Chris Morris and others (kaya@kayalang.org). For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the  terms  of the GNU Lesser General Public License (version 2.1 or any later version) as
       published by the Free Software Foundation.

RELATED

       HTMLDocument.Doctype (3kaya)
       HTMLDocument.WhiteList (3kaya)
       HTMLDocument.readFromTemplate (3kaya)
       HTMLDocument.string (3kaya)