?HAMA

Navigation

Breadcrumbs

/ / opt / alt / php85 / usr / include / php / main

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.54 KB

//opt/alt/php85/usr/include/php/main/snprintf.h

Text Base64

/*
   +----------------------------------------------------------------------+
   | Copyright (c) The PHP Group                                          |
   +----------------------------------------------------------------------+
   | This source file is subject to version 3.01 of the PHP license,      |
   | that is bundled with this package in the file LICENSE, and is        |
   | available through the world-wide-web at the following url:           |
   | https://www.php.net/license/3_01.txt                                 |
   | If you did not receive a copy of the PHP license and are unable to   |
   | obtain it through the world-wide-web, please send a note to          |
   | license@php.net so we can mail you a copy immediately.               |
   +----------------------------------------------------------------------+
   | Author: Stig Sæther Bakken <ssb@php.net>                             |
   |         Marcus Boerger <helly@php.net>                               |
   +----------------------------------------------------------------------+
*/

Comparing: sprintf, snprintf, slprintf, spprintf

sprintf  offers the ability to make a lot of failures since it does not know
         the size of the buffer it uses. Therefore usage of sprintf often
         results in possible entries for buffer overrun attacks. So please
         use this version only if you are sure the call is safe. sprintf
         always terminates the buffer it writes to.

snprintf knows the buffers size and will not write behind it. But you will
         have to use either a static buffer or allocate a dynamic buffer
         before being able to call the function. In other words you must
         be sure that you really know the maximum size of the buffer required.
         A bad thing is having a big maximum while in most cases you would
         only need a small buffer. If the size of the resulting string is
         longer or equal to the buffer size than the buffer is not terminated.
         The function also returns the number of chars not including the
         terminating \0 that were needed to fully comply to the print request.

slprintf same as snprintf with the difference that it actually returns the
         length printed not including the terminating \0.

spprintf is the dynamical version of snprintf. It allocates the buffer in size
         as needed and allows a maximum setting as snprintf (turn this feature
         off by setting max_len to 0). spprintf is a little bit slower than
         snprintf and offers possible memory leaks if you miss freeing the
         buffer allocated by the function. Therefore this function should be
         used where either no maximum is known or the maximum is much bigger
         than normal size required. spprintf always terminates the buffer.

Example:

#ifndef SNPRINTF_H
#define SNPRINTF_H

#include <stdbool.h>

BEGIN_EXTERN_C()
PHPAPI int ap_php_slprintf(char *buf, size_t len, const char *format,...) ZEND_ATTRIBUTE_FORMAT(printf, 3, 4);
PHPAPI int ap_php_vslprintf(char *buf, size_t len, const char *format, va_list ap);
PHPAPI int ap_php_snprintf(char *, size_t, const char *, ...) ZEND_ATTRIBUTE_FORMAT(printf, 3, 4);
PHPAPI int ap_php_vsnprintf(char *, size_t, const char *, va_list ap);
PHPAPI int ap_php_vasprintf(char **buf, const char *format, va_list ap);
PHPAPI int ap_php_asprintf(char **buf, const char *format, ...) ZEND_ATTRIBUTE_FORMAT(printf, 2, 3);
PHPAPI char * php_0cvt(double value, int ndigit, char dec_point, char exponent, char *buf);
PHPAPI char * php_conv_fp(char format, double num,
		 bool add_dp, int precision, char dec_point, bool * is_negative, char *buf, size_t *len);

END_EXTERN_C()

#define php_gcvt zend_gcvt

#ifdef slprintf
#undef slprintf
#endif
#define slprintf ap_php_slprintf

#ifdef vslprintf
#undef vslprintf
#endif
#define vslprintf ap_php_vslprintf

#ifdef snprintf
#undef snprintf
#endif
#define snprintf ap_php_snprintf

#ifdef vsnprintf
#undef vsnprintf
#endif
#define vsnprintf ap_php_vsnprintf

#ifndef HAVE_VASPRINTF
#define vasprintf ap_php_vasprintf
#endif

#ifndef HAVE_ASPRINTF
#define asprintf ap_php_asprintf
#endif

typedef enum {
	LM_STD = 0,
	LM_INTMAX_T,
	LM_PTRDIFF_T,
#if SIZEOF_LONG_LONG
	LM_LONG_LONG,
#endif
	LM_SIZE_T,
	LM_LONG,
	LM_LONG_DOUBLE,
} length_modifier_e;

PHPAPI char * ap_php_conv_10(int64_t num, bool is_unsigned,
	   bool * is_negative, char *buf_end, size_t *len);

PHPAPI char * ap_php_conv_p2(uint64_t num, int nbits,
		 char format, char *buf_end, size_t *len);

#endif /* SNPRINTF_H */

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 1 × Files: 32

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
streams DIR	-	drwxr-xr-x	2026-03-31 07:04:58	Edit Download recursive recursive
build-defs.h	6.51 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
charclass.h	653 B	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
fastcgi.h	4.78 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
fopen_wrappers.h	2.14 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
http_status_codes.h	2.83 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
main_arginfo.h	6.63 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php.h	11.55 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_compat.h	19.61 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_config.h	63.67 KB	lrw-r--r--	2026-03-12 16:58:32	Edit Download recursive recursive
php_content_types.h	1.31 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_getopt.h	1.63 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_glob.h	5.90 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_globals.h	3.93 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_ini.h	3.57 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_ini_builder.h	2.73 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_main.h	3.57 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_memory_streams.h	3.23 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_network.h	10.67 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_odbc_utils.h	1.27 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_open_temporary_file.h	1.91 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_output.h	9.02 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_reentrancy.h	3.16 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_scandir.h	1.67 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_streams.h	31.63 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_syslog.h	1.54 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_ticks.h	1.35 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_variables.h	2.06 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
php_version.h	264 B	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
rfc1867.h	3.65 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
SAPI.h	11.01 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
snprintf.h	5.54 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive
spprintf.h	1.47 KB	lrw-r--r--	2026-03-12 16:58:30	Edit Download recursive recursive