ThreadPool-FP

ThreadPool-FP is a small, dependency-free thread pool library for Free Pascal and Lazarus. It runs ordinary procedures and object methods across a managed set of worker threads, so you can parallelise work without writing thread runbooks by hand.

It is practical software: four callback forms, two pool styles (unbounded, and a bounded producer-consumer queue), task handles with pending cancellation, worker-error capture, and a clear lifecycle contract.

Getting started#

• Installation & Quick Start — add the units to your project and run the smallest complete program
• Beginner Guide — learn the core ideas in order, from one queued callback to observable tasks and batches
• Choose a Pool — decide between the unbounded ThreadPool.Simple pool and the bounded ThreadPool.ProducerConsumer pool
• Cheat Sheet — the operational rules on one page

Guides#

• Callback Forms — the four callback signatures
• Simple Thread Pool — GlobalThreadPool, TSimpleThreadPool, and the fire-and-forget Queue workflow
• Tasks & Batches — submit observable work, inspect states, and coordinate groups of handles
• Parallel Ranges — process an inclusive integer range efficiently with SubmitRange
• Cancellation — what cancellation can and cannot do
• Error Handling — worker failures, LastError, Errors, and OnError
• Producer-Consumer Queue — bounded work queues
• Backpressure — submission deadlines and queue monitoring
• Lifecycle & Shutdown — waiting, draining, and stopping a pool cleanly
• Thread Safety — the concurrency contracts you can rely on, and the hazards to avoid
• Platform Requirements — cthreads, FPC and Lazarus versions, and platform notes
• Common Recipes — compiled programs for real tasks

Reference#

• Simple API
• Tasks API
• Producer-Consumer API
• Types & Interfaces
• Contracts & Limitations

Internals#

• Simple Pool Internals
• Producer-Consumer Internals
• Interface Reference Counting in FPC

Project#

• Changelog
• Contributing

This online documentation is versioned. The top-level site opens the current release under /0.9.1/, and the version selector in the header switches between published documentation releases.