SECTION$ returns a section from a document starting and ending with lines containing specific strings
SECTION$(Document$, PageHeader$, PageEnd$, [AddLines%=>0])
Arguments
is Document$ is a string containing the source document.
is PageHeader$ is a sub string of which of Document$ which indicates the first line of the section.
is PageEnd$ is a sub string of that of Document$ that indicates the end of the section.
The result starts with the first line of containing PageHeader$ and of Document$ containing PageHeader$ and ends with the line just before the line containing PageEnd$.
is 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 is containing PageEnd$ is included.
...
Assuming a document with the following text:
"Turning and turning in the widening gyre
The falcon cannot hear the falconer;
Things fall apart; the centre cannot hold;
Mere anarchy is loosed upon the world
The blood-dimmed tide is loosed, and everywhere
The ceremony of innocence is drowned;
The best lack all conviction, while the worst
Are full of passionate intensity"
then
SECTION$(Document$, "fall apart", "ceremony")
returns
"Things fall apart; the centre cannot hold;
Mere anarchy is loosed upon the world
The blood-dimmed tide is loosed, and everywhere
"
SECTION$(Document$, "fall apart", "Ceremony")
returns
"Things fall apart; the centre cannot hold;
Mere anarchy is loosed upon the world
The blood-dimmed tide is loosed, and everywhere
The ceremony of innocence is drowned;
The best lack all conviction, while the worst
Are full of passionate intensity
"
Because "Ceremony" does not occur in Document$. Note, the function is case sensitive.
SECTION$(Document$, "falls apart", "ceremony")
returns
since "falls apart" is not present in Document$.
SECTION$(Document$, "fall apart", "ceremony", 2)
returns
"Things fall apart; the centre cannot hold;
Mere anarchy is loosed upon the world
The blood-dimmed tide is loosed, and everywhere
The ceremony of innocence is drowned;
The best lack all conviction, while the worst
"
Two more lines are included.
Quick links: Function Functions overview | Attribute overview | Constants overview | Dimensions overview