From: Marcus Boerger <helly@php.net>
Date: Sun, 23 Jun 2002 22:12:22 +0000 (+0000)
Subject: #some sentences about the functions
X-Git-Tag: php-4.3.0dev_zend2_alpha2~130
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=02ac908307d3e7abba1ee0f59ff3e52657c41f2c;p=php

#some sentences about the functions
---

diff --git a/main/spprintf.h b/main/spprintf.h
index 1ba503d602..64ce28300d 100644
--- a/main/spprintf.h
+++ b/main/spprintf.h
@@ -16,6 +16,19 @@
    +----------------------------------------------------------------------+
  */
 
+/* 
+
+The pbuf parameter of all spprintf version receives a pointer to the allocated
+buffer. This buffer must be freed manually after usage using efree() function.
+The buffer will allways be terminated by a zero character. When pbuf is NULL
+the function can be used to calculate the required size of the buffer but for
+that purpose snprintf is faster. When both pbuf and the return value are 0
+than you are out of memory.
+
+There is also snprintf: See difference explained in snprintf.h
+
+*/
+
 #ifndef SPPRINTF_H
 #define SPPRINTF_H