tlaSkip
Skip Down or Up Over Space or Text Lines
CodeWright® - API Macro - Royalty Free - 2005.01.01 17:15
Send Comments

Purpose

Skip Down or Up Over Space or Text Lines.

Operation

This function moves the cursor to the first character of a line of a block of information. The operation can go either up or down and can skip over lines that contain nothing but whitespace or lines that contain some text.

Example

Default - move cursor down to first line that contains text.

tlaSkip( );

Specified - move cursor up to first line that contains all whitespace.

tlaSkip( "up", "text" );

Input Parameters

Parm Name Code Meaning
1 Direction   Move cursor down.
"down" Move cursor down.
"up" Move cursor up.
2 Skip Over   Skip over spaces.
"space" Skip over spaces.
"text" Skip over text.

Return Codes

Code Message/Meaning
-1 tlaSkip: Parameter missing.
-1 tlaSkip: Direction (parm 1) not null, "down", or "up".
-1 tlaSkip: Skip Over (parm 2) not null, "space", or "text".
-1 tlaSkip: Direction (parm 1) not null, "down", or "up" and Skip Over (parm 2) not null, "space", or "text".
0 No match found.
1 Match found.

Reference

This function calls tlaError.

Compatibility

Current version verified under:

  • CodeWright 7.0b
  • CodeWright 7.0c
  • CodeWright 7.5.1
  • CodeWright 7.5.2
  • CodeWright for .NET 7.0

CodeWright for .NET Restriction

None.

Installation

There are three primary methods for installing this macro on your system. Method A uses the tlaMDE tool available for purchase from this website. Method B manipulates the macro repository directly. Method C uses the API Macro... tool provided in every copy of CodeWright (but not CodeWright for .NET).

Method A - tlaMDE - CodeWright or CodeWright for .NET

  • Select the Code button on this page.
  • When the second window opens, select all the text in the text box.
  • Issue Ctl-C (copy).
  • Create a new file in CodeWright or CodeWright for .NET.
  • Issue Ctl-V (paste).
  • Issue tlaMDE C (save and compile).

Method B - Copy to Repository - CodeWright or CodeWright for .NET

  • Select the Code button on this page.
  • When the second window opens, select all the text in the text box for a macro.
  • Issue Ctl-C (copy).
  • Load the macro repository "cwright.mac" from your CodeWright or CodeWright for .NET root:
  • issue Ctl-End to go to the end of file.
  • Issue Ctl-V (paste).
  • Close the file and respond yes to the write request.

Method C - API Macro ... - CodeWright Only

  • Select the Code button on this page.
  • When the second window opens, select text from the text box for a macro:
    • Do not select the [API Macro ... header line.
    • Select all other lines in the macro.
  • Issue Ctl-C (copy).
  • Open the CodeWright Tools | API Macros... dialog.
  • Press the New button.
  • Select the Edit box.
  • Issue Ctl-V (paste).
  • Double-click on the function name in the header of the macro.
  • Issue Ctl-C (copy).
  • Select the Name box.
  • Issue Ctl-V (paste).
  • Delete the trailing blank from the name.
  • Select the Save button.
  • Select the Close button.
  • Repeat this process for each macro in the text box.

Purchase

tlaTools is a Dynamic Link Library that contains most of the API macros on this website in a single easy to install package. The tlaTools DLL can be purchased by selecting the Buy button on this page.

tlaSkip is included as a function in tlaTools.

Copyright © 1993-2005 Thom Little Associates, Ltd. revised 2005.01.01 17:15
One Central Square, Keene, NH 03431-3787 phone 603-357-7567