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)

Kaya                                                July 2013                 HTMLDocument.readFromString(3kaya)