PARAGRAPH$ returns a section from a document starting and ending with lines defined by their line numbers.


Syntax

PARAGRAPH$(Document$, FirstLineNo%, [LastLineNo%])

Arguments

  • Document$ is a string containing the source document.
  • FirstLineNo% is the number of the line at which you want the section to start.
  • LastLineNo% is an optional value, containing the number of the last line of the section.

Remarks

  1. When no last line is given, the function returns all text from Document$ starting with FirstLineNo%.
  2. If FirstLineNo% = 0, the function returns a string starting at the first line of the source document.
  3. If LastLineNo% = 0, the function returns all text from Document$ starting with FirstLineNo%.
  4. One can also use the SECTION$() function to return a section of a document.

Examples


Let Document$ contain the 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"

Example 1


PARAGRAPH$(Document$, 3) 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"

Example 2


PARAGRAPH$(Document$, 3, 5) returns

"Things fall apart; the centre cannot hold; 
Mere anarchy is loosed upon the world 
The blood-dimmed tide is loosed, and everywhere"


 

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

 

  • No labels