...

• Document$ is a string containing the source document.
• PageHeader$ is a sub string of Document$ which indicates the first line of the section.
• PageEnd$ is a sub string of Document$ that indicates the end of the section.
  The result starts with the first line of Document$ containing PageHeader$ and ends with the line just before the line containing PageEnd$.
• AddLines% is an optional value, containing the number of lines to be added at the end of the section. E.g. when AddLines%=1, also the line containing PageEnd$ is included.

Remarks

1. If PageHeader$="NullString", the function returns "NullString".
2. If PageHeader$ is not found, the function also returns "NullString".
3. If PageEnd$="NullString", the function returns all text from Document starting with PageHeader$.
4. If PageEnd$ is not found, the function also returns all text from Document starting with PageHeader$.
5. The last line of the result returned by SECTION$() is always terminated by a CrLf a CrLf (Carriage Return + LineFeed: Chr$ Chr$(13)+Chr$(10) ). Multiple repeating CrLfrepeating CrLf's at the end of an extracted section are removed as well as trailing strings from each line in that result.
6. One can also use the PARAGRAPH$the PARAGRAPH$() function to return a section of a document.

...

SECTION$(Document$, "falls apart", "ceremony")

returns

"NullString"

since "falls apart" is not present in Document$.

...

Two more lines are included.

Quick links: Function overview | Attribute overview | Constants overview | Dimensions  Function overview | Attribute overview | Constants overview | Dimensions overview