Index of /archives/NetBSD/NetBSD-release-9/src/external/gpl2/gettext/dist/gettext-runtime/libasprintf
Name Last modified Size Description
![[PARENTDIR]](/icons/back.gif)
Parent Directory -
![[DIR]](/icons/folder.gif)
CVS/ 2024-02-15 03:47 -
![[TXT]](/icons/text.gif)
NEWS 2016-01-13 04:50 0
![[ ]](/icons/unknown.gif)
AUTHORS 2016-01-13 04:50 33
COPYING 2016-01-13 04:50 65
README.woe32 2016-01-13 04:50 174
asprintf.c 2016-01-13 04:50 1.1K
lib-asprintf.h 2016-01-13 04:50 1.1K
asnprintf.c 2016-01-13 04:50 1.1K
lib-asprintf.c 2016-01-13 04:50 1.3K
vasprintf.c 2016-01-13 04:50 1.5K
vasprintf.h 2016-01-13 04:50 2.0K
printf-parse.h 2016-01-13 04:50 2.1K
autosprintf.cc 2016-01-13 04:50 2.2K
autosprintf.h.in 2016-01-13 04:50 2.2K
alloca_.h 2016-01-13 04:50 2.3K
README 2016-01-13 04:50 2.6K
configure.ac 2016-01-13 04:50 2.7K
vasnprintf.h 2016-01-13 04:50 2.8K
printf-args.h 2016-01-13 04:50 2.8K
xsize.h 2016-01-13 04:50 3.5K
autosprintf_all.html 2016-01-13 04:50 3.8K
config.h.in 2016-01-13 04:50 3.8K
printf-args.c 2016-01-13 04:50 4.1K
autosprintf.info 2016-01-13 04:50 4.4K
Makefile.am 2016-01-13 04:50 4.8K
autosprintf.texi 2016-01-13 04:50 5.9K
INSTALL 2016-01-13 04:50 11K
printf-parse.c 2016-01-13 04:50 12K
ChangeLog 2016-01-13 04:50 16K
vasnprintf.c 2016-01-13 04:50 22K
COPYING.LIB 2016-01-13 04:50 25K
aclocal.m4 2016-01-13 04:50 32K
Makefile.in 2016-01-13 07:58 33K
texi2html 2016-01-13 04:50 56K
configure 2016-01-13 04:50 736K
GNU libasprintf - automatic formatted output to strings
This package makes the C formatted output routines (fprintf et al.) usable
in C++ programs.
Sample use
----------
char *pathname = autosprintf ("%s/%s", directory, filename);
cerr << autosprintf ("syntax error in %s:%d: %s", filename, line, errstring);
Benefits
--------
The benefits of autosprintf over the usual "piecewise meal" idiom
cerr << "syntax error in " << filename << ":" << line << ": " << errstring;
are:
- Reuses of the standard POSIX printf facility. Easy migration from C to C++.
- English sentences are kept together.
- Internationalization requires format strings, because
1. Internationalization requires the ability for the translator to change
the order of parts of a sentence. The POSIX printf formatted output
functions (and thus also autosprintf) support this through the %m$ and
*m$ syntax.
2. Translators are used to translate one string per sentence, not
multiple strings per sentence, and not C++ code statements.
- Reduces the risk of programming errors due to forgotten state in the
output stream (e.g. 'cout << hex;' not followed by 'cout << dec;').
The benefits of autosprintf over C sprintf are:
- Autosprintf avoids buffer overruns and truncated results.
The C sprintf() function often leads to buffer overruns. On the other
hand, the C snprintf() function requires extra coding for an a priori
estimate of the result's size and truncates the result if the estimate
was too low.
- Autosprintf avoids memory leaks.
Temporarily allocated memory is cleaned up automatically.
Installation
------------
See INSTALL. Usually "./configure; make; make install" should work.
The installed files are:
- An include file "autosprintf.h" which defines the class 'autosprintf',
in the namespace 'gnu'.
- A library libasprintf containing this class.
Use
---
To use the class autosprintf, use
#include "autosprintf.h"
using gnu::autosprintf;
and link with the linker option
-lasprintf
Misc notes
----------
An instance of class 'autosprintf' contains the formatted output result;
this string is freed when the instance's destructor is run.
The class name 'autosprintf' is meant to remind the C function sprintf(),
the GNU C library function asprintf(), and the C++ autoptr programming idiom.
Distribution
------------
http://www.haible.de/bruno/gnu/libasprintf-1.0.tar.gz
Homepage
--------
http://www.haible.de/bruno/packages-libasprintf.html
Bug reports to:
---------------
<bug-gnu-gettext@gnu.org>
Bruno Haible <brunoe@clisp.org>