initial commit

1 files changed, 37 insertions, 0 deletions

diff --git a/public/fd_printf.md b/public/fd_printf.md
new file mode 100644
index 0000000..5e1098e
--- /dev/null
+++ b/public/fd_printf.md
@@ -0,0 +1,37 @@
+`fd_printf`: print formatted text directly to a file descriptor
+===============================================================
+:copyright 2013 Luke Shumaker
+:license WTFPL-2
+
+I wrote this while debugging some code, and thought it might be useful
+to others:
+
+	#define _GNU_SOURCE     /* vasprintf() */
+	#include <stdarg.h>     /* va_start()/va_end() */
+	#include <stdio.h>      /* vasprintf() */
+	#include <stdlib.h>     /* free() */
+	#include <unistd.h>     /* write() */
+	
+	int
+	fd_printf(int fd, const char *format, ...)
+	{
+		va_list arg;
+		int len;
+		char *str;
+	
+		va_start(arg, format);
+		len = vasprintf(&str, format, arg);
+		va_end(arg);
+	
+		write(fd, str, len);
+	
+		free(str);
+		return len;
+	}
+
+
+It is a version of `printf` that prints to a file descriptor—where
+`fprintf` prints to a `FILE*` data structure.
+
+The appeal of this is that `FILE*` I/O is buffered—which means mixing
+it with raw file descriptor I/O is going to produce weird results.