mirror of
https://github.com/php/php-src.git
synced 2024-12-02 22:34:55 +08:00
03f3b8479b
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2
163 lines
5.5 KiB
C
163 lines
5.5 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| PHP Version 7 |
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) 1997-2018 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: |
|
|
| http://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: Sascha Schumann <sascha@schumann.cx> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef ZEND_SMART_STR_H
|
|
#define ZEND_SMART_STR_H
|
|
|
|
#include <zend.h>
|
|
#include "zend_globals.h"
|
|
#include "zend_smart_str_public.h"
|
|
|
|
#define smart_str_appends_ex(dest, src, what) \
|
|
smart_str_appendl_ex((dest), (src), strlen(src), (what))
|
|
#define smart_str_appends(dest, src) \
|
|
smart_str_appendl((dest), (src), strlen(src))
|
|
#define smart_str_extend(dest, len) \
|
|
smart_str_extend_ex((dest), (len), 0)
|
|
#define smart_str_appendc(dest, c) \
|
|
smart_str_appendc_ex((dest), (c), 0)
|
|
#define smart_str_appendl(dest, src, len) \
|
|
smart_str_appendl_ex((dest), (src), (len), 0)
|
|
#define smart_str_append(dest, src) \
|
|
smart_str_append_ex((dest), (src), 0)
|
|
#define smart_str_append_smart_str(dest, src) \
|
|
smart_str_append_smart_str_ex((dest), (src), 0)
|
|
#define smart_str_sets(dest, src) \
|
|
smart_str_setl((dest), (src), strlen(src));
|
|
#define smart_str_append_long(dest, val) \
|
|
smart_str_append_long_ex((dest), (val), 0)
|
|
#define smart_str_append_unsigned(dest, val) \
|
|
smart_str_append_unsigned_ex((dest), (val), 0)
|
|
#define smart_str_free(dest) \
|
|
smart_str_free_ex((dest), 0)
|
|
|
|
BEGIN_EXTERN_C()
|
|
|
|
ZEND_API void ZEND_FASTCALL smart_str_erealloc(smart_str *str, size_t len);
|
|
ZEND_API void ZEND_FASTCALL smart_str_realloc(smart_str *str, size_t len);
|
|
ZEND_API void ZEND_FASTCALL smart_str_append_escaped(smart_str *str, const char *s, size_t l);
|
|
ZEND_API void smart_str_append_printf(smart_str *dest, const char *format, ...)
|
|
ZEND_ATTRIBUTE_FORMAT(printf, 2, 3);
|
|
|
|
END_EXTERN_C()
|
|
|
|
static zend_always_inline size_t smart_str_alloc(smart_str *str, size_t len, zend_bool persistent) {
|
|
if (UNEXPECTED(!str->s)) {
|
|
goto do_smart_str_realloc;
|
|
} else {
|
|
len += ZSTR_LEN(str->s);
|
|
if (UNEXPECTED(len >= str->a)) {
|
|
do_smart_str_realloc:
|
|
if (persistent) {
|
|
smart_str_realloc(str, len);
|
|
} else {
|
|
smart_str_erealloc(str, len);
|
|
}
|
|
}
|
|
}
|
|
return len;
|
|
}
|
|
|
|
static zend_always_inline char* smart_str_extend_ex(smart_str *dest, size_t len, zend_bool persistent) {
|
|
size_t new_len = smart_str_alloc(dest, len, persistent);
|
|
char *ret = ZSTR_VAL(dest->s) + ZSTR_LEN(dest->s);
|
|
ZSTR_LEN(dest->s) = new_len;
|
|
return ret;
|
|
}
|
|
|
|
static zend_always_inline void smart_str_free_ex(smart_str *str, zend_bool persistent) {
|
|
if (str->s) {
|
|
zend_string_release_ex(str->s, persistent);
|
|
str->s = NULL;
|
|
}
|
|
str->a = 0;
|
|
}
|
|
|
|
static zend_always_inline void smart_str_0(smart_str *str) {
|
|
if (str->s) {
|
|
ZSTR_VAL(str->s)[ZSTR_LEN(str->s)] = '\0';
|
|
}
|
|
}
|
|
|
|
static zend_always_inline size_t smart_str_get_len(smart_str *str) {
|
|
return str->s ? ZSTR_LEN(str->s) : 0;
|
|
}
|
|
|
|
static zend_always_inline zend_string *smart_str_extract(smart_str *str) {
|
|
if (str->s) {
|
|
zend_string *res;
|
|
smart_str_0(str);
|
|
res = str->s;
|
|
str->s = NULL;
|
|
return res;
|
|
} else {
|
|
return ZSTR_EMPTY_ALLOC();
|
|
}
|
|
}
|
|
|
|
static zend_always_inline void smart_str_appendc_ex(smart_str *dest, char ch, zend_bool persistent) {
|
|
size_t new_len = smart_str_alloc(dest, 1, persistent);
|
|
ZSTR_VAL(dest->s)[new_len - 1] = ch;
|
|
ZSTR_LEN(dest->s) = new_len;
|
|
}
|
|
|
|
static zend_always_inline void smart_str_appendl_ex(smart_str *dest, const char *str, size_t len, zend_bool persistent) {
|
|
size_t new_len = smart_str_alloc(dest, len, persistent);
|
|
memcpy(ZSTR_VAL(dest->s) + ZSTR_LEN(dest->s), str, len);
|
|
ZSTR_LEN(dest->s) = new_len;
|
|
}
|
|
|
|
static zend_always_inline void smart_str_append_ex(smart_str *dest, const zend_string *src, zend_bool persistent) {
|
|
smart_str_appendl_ex(dest, ZSTR_VAL(src), ZSTR_LEN(src), persistent);
|
|
}
|
|
|
|
static zend_always_inline void smart_str_append_smart_str_ex(smart_str *dest, const smart_str *src, zend_bool persistent) {
|
|
if (src->s && ZSTR_LEN(src->s)) {
|
|
smart_str_append_ex(dest, src->s, persistent);
|
|
}
|
|
}
|
|
|
|
static zend_always_inline void smart_str_append_long_ex(smart_str *dest, zend_long num, zend_bool persistent) {
|
|
char buf[32];
|
|
char *result = zend_print_long_to_buf(buf + sizeof(buf) - 1, num);
|
|
smart_str_appendl_ex(dest, result, buf + sizeof(buf) - 1 - result, persistent);
|
|
}
|
|
|
|
static zend_always_inline void smart_str_append_unsigned_ex(smart_str *dest, zend_ulong num, zend_bool persistent) {
|
|
char buf[32];
|
|
char *result = zend_print_ulong_to_buf(buf + sizeof(buf) - 1, num);
|
|
smart_str_appendl_ex(dest, result, buf + sizeof(buf) - 1 - result, persistent);
|
|
}
|
|
|
|
static zend_always_inline void smart_str_setl(smart_str *dest, const char *src, size_t len) {
|
|
smart_str_free(dest);
|
|
smart_str_appendl(dest, src, len);
|
|
}
|
|
|
|
#endif
|
|
|
|
/*
|
|
* Local variables:
|
|
* tab-width: 4
|
|
* c-basic-offset: 4
|
|
* indent-tabs-mode: t
|
|
* End:
|
|
* vim600: sw=4 ts=4 fdm=marker
|
|
* vim<600: sw=4 ts=4
|
|
*/
|