Skip to content

Latest commit

 

History

History
565 lines (393 loc) · 8.84 KB

code-editing.md

File metadata and controls

565 lines (393 loc) · 8.84 KB

Code Editing Tools

← Back to Documentation Home

Productivity features to write Clarion code faster.

Overview

The Clarion Extension provides powerful code editing tools:

  • 50+ code snippets - Quick insertion of common structures
  • Paste as Clarion String - Convert text to Clarion string format
  • Add Method Implementation - Generate method stubs automatically
  • Create New Class - Interactive class creation wizard
  • Code folding - Collapse/expand code blocks

Code Snippets

What Are Snippets?

Shortcuts that expand into full code structures:

  1. Type the trigger word (e.g., IF)
  2. Press Tab
  3. Full structure inserted with placeholders
  4. Tab again to jump to next placeholder

Structure Snippets

IF Statement

Trigger: IF

IF THEN
  
END

Trigger: IFE (IF with ELSE)

IF THEN
  
ELSE
  
END

LOOP Statement

Trigger: LOOP

LOOP
  
END

Trigger: LOOPFT (LOOP with FROM/TO)

LOOP var = from TO to
  
END

Trigger: LOOPFILE (File LOOP)

LOOP UNTIL ACCESS:FileName.Next()
  
END

CASE Statement

Trigger: CASE

CASE variable
OF value
  
END

Other Structures

  • MAP → MAP/END
  • MODULE → MODULE/END
  • CLASS → CLASS/END
  • GROUP → GROUP/END
  • QUEUE → QUEUE/END
  • FILE → FILE/END

See all snippets →

Variable Declaration Snippets

Basic Variables

Pattern: V{type} (V = Variable)

  • VS → Bar STRING(10)
  • VL → Bar LONG
  • VR → Bar REAL
  • VD → Bar DECIMAL(10,2)
  • VDT → Bar DATE
  • VTI → Bar TIME

Reference Variables

Pattern: RV{type} (RV = Reference Variable)

  • RVS → Bar &STRING
  • RVL → Bar &LONG
  • RVR → Bar &REAL

Procedure Parameters

Pattern: PV{type} (PV = Procedure Variable)

  • PVS → (STRING Foo)
  • PVL → (LONG Foo)

Pattern: PVR{type} (PVR = Procedure Reference)

  • PVRS → (*STRING Foo)
  • PVRL → (*LONG Foo)

Quick Variable Types

Shortcut Type
s STRING
l LONG
r REAL
d DECIMAL
dt DATE
ti TIME
b BYTE
sh SHORT
ul ULONG
us USHORT
cs CSTRING
ps PSTRING

Complete list →

Paste as Clarion String

What It Does

Converts clipboard text to Clarion string format:

  • Automatically escapes quotes
  • Converts unicode quotes to ASCII (for Clarion compatibility)
  • Adds line continuation (& |)
  • Handles multi-line text
  • Perfect for SQL, error messages, multi-line strings

Note: Unicode "smart quotes" (', ', ", ") from Word, web browsers, etc. are automatically converted to ASCII quotes (' and ") to ensure Clarion compiler compatibility.

How to Use

  1. Copy text to clipboard (any source)
  2. In VS Code, position cursor where you want string
  3. Press Ctrl+Shift+Alt+V
  4. Text pasted as Clarion string

Or:

  1. Ctrl+Shift+P → "Clarion: Paste as Clarion String"

Examples

Single Line

Clipboard:

Hello World

Pasted:

'Hello World'

Multiple Lines

Clipboard:

This is line 1
This is line 2
This is line 3

Pasted (default):

'This is line 1' & |
'This is line 2' & |
'This is line 3'

With Quotes

Clipboard:

He said "Hello"

Pasted:

'He said "Hello"'

Unicode Quotes (from Word/Web)

Clipboard (with "smart quotes"):

SELECT * FROM Customers WHERE Name = 'John's Store'

Pasted (automatically converted to ASCII):

'SELECT * FROM Customers WHERE Name = ''John''s Store'''

Note: Unicode quotes (', ', ", ") are converted to ASCII (' and ") before escaping. This ensures Clarion compiler compatibility.

SQL Query

Clipboard:

SELECT *
FROM Customers
WHERE Country = 'USA'
ORDER BY CustomerName

Pasted:

'SELECT *' & |
'FROM Customers' & |
'WHERE Country = ''USA''' & |
'ORDER BY CustomerName'

Note: Single quotes automatically doubled for SQL escaping!

Configuration

Line Terminator

Choose how lines are joined:

{
  "clarion.pasteAsClarionString.lineTerminator": "space"  // Default
}

Options:

"space" - Join with space (default)

'Line 1' & |
'Line 2'

"crlf" - Include CRLF characters

'Line 1' & |
'<13,10>' & |
'Line 2'

"none" - No line breaks

'Line 1Line 2'

Trim Leading Whitespace

Remove indentation from pasted text:

{
  "clarion.pasteAsClarionString.trimLeading": true  // Default
}

Example with trim enabled:

Clipboard:

    Indented line 1
    Indented line 2

Pasted:

'Indented line 1' & |
'Indented line 2'

Add Method Implementation

What It Does

Automatically generates method implementations from CLASS declarations:

  1. Finds the method declaration in CLASS
  2. Locates the MODULE file
  3. Checks for existing implementation
  4. Generates new implementation or jumps to existing

How to Use

  1. Place cursor on method name in CLASS declaration
  2. Press Ctrl+Shift+I
  3. Implementation generated in MODULE file
  4. Cursor moves to new implementation

Or:

  1. Ctrl+Shift+P → "Clarion: Add Method Implementation"

Example

In MyClass.inc:

MyClass CLASS,MODULE('MyClass.clw')
Init      PROCEDURE()  ← Cursor here, press Ctrl+Shift+I
        END

Generates in MyClass.clw:

MyClass.Init PROCEDURE
CODE
  ! Your code here

Method Overloads

Handles overloaded methods:

MyClass CLASS,MODULE('MyClass.clw')
Process   PROCEDURE(STRING value)
Process   PROCEDURE(*STRING reference)  ← Generates correct signature
        END

Generates:

MyClass.Process PROCEDURE(*STRING reference)
CODE

Uses parameter types to match correct overload!

Existing Implementation

If implementation already exists:

  • Jumps to existing implementation
  • Does NOT create duplicate
  • Cursor positioned at implementation

Create New Class

What It Does

Interactive wizard creates both .inc and .clw files:

  1. Prompts for class name
  2. Asks for folder location
  3. Creates .inc file with CLASS declaration
  4. Creates .clw file with MODULE stub
  5. Opens both files

How to Use

  1. Press Ctrl+Shift+P
  2. Type "Clarion: Create New Class"
  3. Enter class name (e.g., MyClass)
  4. Select destination folder
  5. Files created and opened

Generated Files

MyClass.inc:

MyClass CLASS,MODULE('MyClass.clw'),TYPE,THREAD
Init      PROCEDURE()
Kill      PROCEDURE()
        END

MyClass.clw:

  MEMBER('MyClass')

  MAP
  END

  INCLUDE('MyClass.inc'),ONCE

MyClass.Init PROCEDURE
CODE
  

MyClass.Kill PROCEDURE
CODE

Code Folding

What It Does

Collapse/expand code blocks:

  • Hides implementation details
  • Focus on structure
  • Navigate large files easier

Foldable Structures

All major Clarion structures:

  • PROCEDURE/END
  • CLASS/END
  • IF/END
  • LOOP/END
  • CASE/END
  • MAP/END
  • GROUP/END
  • ROUTINE/END

How to Use

Fold/unfold block:

  • Click ▼ icon in left gutter
  • Or press Ctrl+Shift+[ (fold)
  • Or press Ctrl+Shift+] (unfold)

Fold all:

  • Ctrl+K Ctrl+0 - Fold all
  • Ctrl+K Ctrl+J - Unfold all

Fold level:

  • Ctrl+K Ctrl+1 - Fold level 1
  • Ctrl+K Ctrl+2 - Fold level 2
  • etc.

Bracket Matching

Auto-Closing Pairs

Automatically closes:

  • ( → ()
  • [ → []
  • ' → ''
  • " → ""

Cursor positioned inside:

MyProc(|)  ← Cursor here after typing (

Bracket Highlighting

Matching brackets highlighted:

  • Place cursor next to bracket
  • Matching bracket highlighted
  • Makes nested structures easier to read

Tips & Tricks

Snippet Workflow

  1. Type trigger
  2. Tab to expand
  3. Type placeholder value
  4. Tab to next placeholder
  5. Repeat until done

Quick String Paste

  • Keep Paste as String shortcut handy
  • Use for any multi-line text
  • SQL queries, error messages, help text

Class Creation

  • Use wizard for consistent structure
  • Generates Init/Kill methods automatically
  • Proper MODULE reference

Folding Strategy

  • Fold completed procedures
  • Focus on current work
  • Unfold when needed

Related Features