Skip over navigation

Welcome to the all new DelphiDabbler website.

I hope you like it.

There are going to be bugs. Please report any you find on the website's issues page (GitHub account required). Thanks.

Click the close button and you won't see this message again.

I/O Utility Classes

Classes to assist in various I/O related tasks

Version 1.0.1
Released 11 Jan 2014
Platforms Win32 & Win64
Framework VCL
Compatibilty Delphi 2005 & later

Overview

These classes are designed to assist in various I/O related tasks. Classes are provided to:

  • Simplify the opening of files in various different modes with specified security attributes and provide access to the file handle.
  • Simplify working with un-named pipes.
  • Handle the formatting of data read from pipes, for example reading Unicode strings.

These classes used to be included in the Console Application Runner Classes project to help handle standard I/O redirection but were pulled out into their own project because they have wider uses.

There are no demo projects included with the download. However, much of the code is used in some of the demos included with the Console Application Runner Classes.

Get The Code

You can download the latest version of the I/O Utility Classes directly from SourceForge as dd-ioutils-1.0.1.zip.

Download v1.0.1

I/O Utility Classes is a sub-project of the DDabLib project which is maintained in a Subversion repository. The code is developed in the trunk/projects/ioutils branch.

Subversion users can check out the source code of the current release from the repository on SourceForge by doing:

svn checkout http://svn.code.sf.net/p/ddablib/code/tags/projects/ioutils/release-1.0.1 codedir

where codedir is the directory where you want to checkout code. To check out other versions, simply specify a different version number.

The latest development tree can be checked out using:

 svn checkout http://svn.code.sf.net/p/ddablib/code/trunk/projects/ioutils codedir

Check outs are read only, but you can easily contribute code: see Feedback & Queries below.

Installation

The I/O Utility Classes are supplied in a zip file. Before installing you need to extract all the files from the zip file, preserving the directory structure. The following files will be extracted:

  • PJFileHandle.pas – source code of the class used to open files in various sharing and security modes.
  • PJPipe.pas – source code of the class used to encapsulate un-named pipes.
  • PJPipeFilters.pas – source code of classes used to filter output from pipes.
  • ReadMe.htm – read-me file.
  • ChangeLog.txt – project change log.
  • MPL-2.txt – the Mozilla Public License v2.0.
  • Documentation.URL – short-cut to the unit's online documentation.

There are three possible ways to use the units.

  1. The simplest way is to add PJFileHandle.pas, PJPipe.pas and PJPipeFilters.pasto your projects as you need them.
  2. To make the units easier to re-use you can either copy them to a folder on your Delphi search path, or add the folder where you extracted the units to the search path. You then simply use the units as required without needing to add them to your project.
  3. For maximum portability you can add the units to a Delphi design time package. If you need help doing this see here.

Documentation

The I/O Utility Classes are comprehensively documented online here

The project's change log can be viewed on SourceForge

A read-me file (ReadMe.htm) is included in the project download.

Feedback & Queries

If you find any bugs or want to suggest a new feature please report them using the Issue Tracker.

Click the Create Ticket button to create a ticket then complete the form giving as much information as possible.

The issue tracker is shared among all the projects in the DelphiDabbler Code Library, so please make sure you enter ioutils in the Project edit box to make it clear which project you are referring to. You should also choose Defect in the Type drop down list to report a bug or Enhancement to request a new feature.

If you have created a bug fix or have implemented a new feature please attach a zip file to your ticket that contains your source code.

Should you have any queries about using the classes please read the documentation. If you can't find an answer in the documentation then post a message in the discussion group.

License

The I/O Utility Classes are open source. They are copyright © 2013-20414 by Peter Johnson. The source code is made available under the terms of the Mozilla Public License v2.0. All relevant trademarks are acknowledged.