Here you'll find various self-published technical papers written by yours truly...
As anyone familiar with my software might guess, based on the amount of documentation, i like to write. i admit it: i'm one of those rare programmers who gets a signicant amount of joy out of writing documentation (gasp!).
This page hosts several papers i have written during the development of various projects. These papers are not specifically geared towards any given project, but cover topics which are generally applicable to many 21st-century C++ projects.
Any and all constructive feedback on these papers is very happily received. Useful feedback will be published in future, updated revisions of these papers, of course with full credit going to those who provide suggestions.
If you happen to re-distribute any of these papers, or get any use whatsoever out of them, i would be absolutely flattered if you would tell me so.
Fair warnings to potential readers:
- i am not a C/C++ guru. i can get by with both languages, but i'm always learning new things about them (often things which surprise me!). Thus these papers may contain some factual errors about C or C++. If the reader notices any, i would ask that he please gently prod me along in the proper direction...
- All of these papers are released into the Public Domain, and of course carry No Warranties of any type.
Context SingletonsLast updated: 14 June 2004
This is a paper discussing the use of what i call Context Singletons, written during the development of libs11n's first classloader layer. It also develops a non-intrusive, light-weight Phoenix Singleton class.
"Context Singleton" is a bit of a misnomer: this paper probably should have been called "Context Monostates", or something similar.
The latest source code for the phoenix class developed in this paper is available here:
Context TypesDoc last updated: 14 June 2004
Like the Context Singletons paper, this one discusses the idea of using types as contexts in C++. It is a gentler introduction to the topic as given in the Context Singletons paper, and is more generic.
SupermacrosDoc last updated: 22 August 2004
"Supermacros" are a technique the s11n project uses to get at the code generation possibilities implied by traditional C++ macros, while eliminating some of their more notorious problems. This short paper gives an overview of what they are, how they can be used, and their advantages (and one tiny disadvantage) over classic macros.
Lexical castingDoc last updated: 14 Aug 2005
This paper covers the topic of "lexical casting." That is, the conversion of non-string data to and from strings. Loosely-typed languages (e.g., Perl and PHP) inherently support this, but strongly-typed languages (e.g., C++) do not have such a feature built-in. This paper develops a class which generically adds this capability to C++ software.
The source code for the lex_t class developed in this paper can be found here:
Classloading in C++: bringing it into the 21st centuryDoc last updated: 3 Jan 2005
This paper addresses the topic of classloading in C++, and presents a generic back-end for adding such support to arbitrary classes and applications.
Generic Cleanup in C++Doc last updated: 14 Aug 2005
This paper develops an alternate approach to smart pointers for guaranteeing proper cleanup of unmanaged pointers in the face of errors. This approach is used in libs11n 1.1.3+ to provide leak-safety guarantees which it otherwise could not make.
Download the accompanying source code, including Makefile, test program, and doxygen file for generating API docs:
Doing OO in CDoc last updated: 8 Dec 2010
This paper develops presents a memory-light, generic approach to "doing OO in C." The model it develops is in use to good effect in several libraries and applications of my own, and it is documented in detail here with the hope that it might help some other C hacker out there. This article is targeted at seasoned C coders.