docs
| Home | Getting Started | Browse by Category | Class Methods | Low-Level API |
ProTOML
Current Version: ProTOML 1.1.0
Release Date: 2026-10-07
Last Updated: 2026-10-07
Copyright (c) 2026 Clarion ProSeries by LANSRAD. All rights reserved.
ProTOML gives Clarion developers an easy way to create, read, edit, store, and exchange TOML data.
The ProTOML global template supplies a ready-to-use high-level object. Most developers use that object and never need to call the low-level DLL API functions directly. Ordinary GROUP, QUEUE, and FILE RECORD declarations work without BINDABLE.
Use the links below to browse the documentation.
- Introduction
- Requirements
- Installation Instructions
- Registering the Template
- Using the Template in Your Application
- Getting Started
- Browse Methods by Category
- View All High-Level Methods
- Low-Level API Reference
- Hand-Coded Integration Without the Template
- Demo and Licensing
- Deployment
- What’s New
- Version History
- Support
- About ProHelp Studio
How to get started
For a normal Clarion application:
- Install ProTOML.
- Register the ProTOML template if the installer did not register it automatically.
- Add the ProTOML global template to the EXE application.
- Enter the developer license in the template.
- Write the high-level calls your application needs.
- Compile and run the application.
Toml.StartDocument()
Toml.WriteGroup('settings',AppSettings)
Toml.WriteQueue('contacts',ContactQueue)
Toml.SaveMemo(SettingsFile,STO:TomlMemoIndex)
Start here
| Page | Purpose |
|---|---|
| Getting Started | Task-based guides for the quickest path to useful results. |
| What Most Developers Actually Use | The small set of high-level methods most applications use first. |
| Using the ProTOML Template | Add the template, enter the developer license, and use the generated Toml object. |
| Create Your First TOML Document | See Clarion values, the calls that store them, and the resulting TOML document. |
| Store and Restore Clarion Data | Map a GROUP, current FILE record buffer, and QUEUE without naming every field in code. |
| Store Structured Data in One Field | Put several kinds of Clarion data into one MEMO or BLOB field. |
What ProTOML can do
- Store individual strings, numbers, Boolean values, dates, and times.
- Write and read a GROUP with one high-level call.
- Write and read the current FILE record buffer with one high-level call.
- Write and read a QUEUE as a TOML array of tables.
- Combine several kinds of data in one readable document.
- Store that document in text, a MEMO, a BLOB, or a normal .toml file.
- Exchange data with modern languages and tools that support TOML.
See What ProTOML Can Do for Your Clarion Application and Why Use ProTOML Instead of INI Files?.
High-level wrapper and low-level API
The high-level Clarion wrapper is the normal ProTOML interface and is the interface used by the supplied demo applications.
The 40 low-level API functions remain available for developers who need direct access or a specialized integration. Most applications do not need them.
| Home | Getting Started | Browse by Category | Class Methods | Low-Level API |