If a string contains only XML, or has a single XML code section which start the string, it can be autodetected so specific stream parsing is not needed. Initial stream parsing is needed if:
- the XML does not start the string, but has other non-XML content before it.
- the there are several discrete sections of XML code embedded in the string and a specific section is needed.
In these scenarios, normal string parsing operators can be used to advance the stream parsing cursor to the start of the desired code and then use String.captureXML() to capture the whole XML code segment detected at that point. Note the code captured is only ever from one continuous section of XML code even if others lie further along in the stream after other sections of non-code text.
See more on XML processing.