X-Git-Url: https://git.m6w6.name/?p=m6w6%2Fext-http;a=blobdiff_plain;f=phpstr%2Fphpstr.h;h=04a74ed05718a7cd1076df8fa0fb03a5b1a90357;hp=51c2b42b8250ae71de5e5e4d5567a9b7856f4695;hb=6be753a288ed7a42e0cd19551d85eb8eb14c4566;hpb=81e4342a90700e1762f04e5f5f542d368fcb79c2;ds=sidebyside diff --git a/phpstr/phpstr.h b/phpstr/phpstr.h index 51c2b42..04a74ed 100644 --- a/phpstr/phpstr.h +++ b/phpstr/phpstr.h @@ -6,8 +6,26 @@ #include "php.h" -#ifdef PHP_WIN32 -# define PHPSTR_API __declspec(dllexport) +#ifndef PHPSTR_DEFAULT_SIZE +# define PHPSTR_DEFAULT_SIZE 256 +#endif + +#ifndef STR_SET +# define STR_SET(STR, SET) \ + { \ + STR_FREE(STR); \ + STR = SET; \ + } +#endif + +#if defined(PHP_WIN32) +# if defined(PHPSTR_EXPORTS) +# define PHPSTR_API __declspec(dllexport) +# elif defined(COMPILE_DL_PHPSTR) +# define PHPSTR_API __declspec(dllimport) +# else +# define PHPSTR_API +# endif #else # define PHPSTR_API #endif @@ -18,19 +36,26 @@ #define FREE_PHPSTR_PTR(STR) efree(STR) #define FREE_PHPSTR_VAL(STR) phpstr_dtor(STR) -#define FREE_PHPSTR_ALL(STR) phpstr_free(STR) +#define FREE_PHPSTR_ALL(STR) phpstr_free(&(STR)) #define FREE_PHPSTR(free, STR) \ switch (free) \ { \ + case PHPSTR_FREE_NOT: break; \ case PHPSTR_FREE_PTR: efree(STR); break; \ case PHPSTR_FREE_VAL: phpstr_dtor(STR); break; \ - case PHPSTR_FREE_ALL: phpstr_free(STR); break; \ - case PHPSTR_FREE_NOT: break; \ + case PHPSTR_FREE_ALL: \ + { \ + phpstr *PTR = (STR); \ + phpstr_free(&PTR); \ + } \ + break; \ default: break; \ } #define RETURN_PHPSTR_PTR(STR) RETURN_PHPSTR((STR), PHPSTR_FREE_PTR, 0) -#define RETURN_PHPSTR_VAL(STR) RETURN_PHPSTR(&(STR), PHPSTR_FREE_NOT, 0) +#define RETURN_PHPSTR_VAL(STR) RETURN_PHPSTR((STR), PHPSTR_FREE_NOT, 0) +#define RETVAL_PHPSTR_PTR(STR) RETVAL_PHPSTR((STR), PHPSTR_FREE_PTR, 0) +#define RETVAL_PHPSTR_VAL(STR) RETVAL_PHPSTR((STR), PHPSTR_FREE_NOT, 0) /* RETURN_PHPSTR(buf, PHPSTR_FREE_PTR, 0) */ #define RETURN_PHPSTR(STR, free, dup) \ RETVAL_PHPSTR((STR), (free), (dup)); \ @@ -64,7 +89,7 @@ typedef enum { #define phpstr_new() phpstr_init(NULL) #define phpstr_init(b) phpstr_init_ex(b, 0, 0) #define phpstr_clone(phpstr_pointer) phpstr_init_ex(NULL, (phpstr_pointer)->size, 0) -PHPSTR_API phpstr *phpstr_init_ex(phpstr *buf, size_t chunk_size, zend_bool pre_alloc); +PHPSTR_API phpstr *phpstr_init_ex(phpstr *buf, size_t chunk_size, int pre_alloc); /* create a phpstr from a zval or c-string */ #define phpstr_from_zval(z) phpstr_from_string(Z_STRVAL(z), Z_STRLEN(z)) @@ -79,20 +104,20 @@ PHPSTR_API void phpstr_resize_ex(phpstr *buf, size_t len, size_t override_size); /* append data to the phpstr */ #define phpstr_appends(b, a) phpstr_append((b), (a), sizeof(a)-1) #define phpstr_appendl(b, a) phpstr_append((b), (a), strlen(a)) -PHPSTR_API void phpstr_append(phpstr *buf, const char *append, size_t append_len); -PHPSTR_API size_t phpstr_appendf(phpstr *buf, const char *format, ...); +PHPSTR_API size_t phpstr_append(phpstr *buf, const char *append, size_t append_len); +PHPSTR_API size_t phpstr_appendf(phpstr *buf, const char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 2, 3); /* insert data at a specific position of the phpstr */ #define phpstr_inserts(b, i, o) phpstr_insert((b), (i), sizeof(i)-1, (o)) #define phpstr_insertl(b, i, o) phpstr_insert((b), (i), strlen(i), (o)) -PHPSTR_API void phpstr_insert(phpstr *buf, const char *insert, size_t insert_len, size_t offset); -PHPSTR_API size_t phpstr_insertf(phpstr *buf, size_t offset, const char *format, ...); +PHPSTR_API size_t phpstr_insert(phpstr *buf, const char *insert, size_t insert_len, size_t offset); +PHPSTR_API size_t phpstr_insertf(phpstr *buf, size_t offset, const char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 3, 4); /* prepend data */ #define phpstr_prepends(b, p) phpstr_prepend((b), (p), sizeof(p)-1) #define phpstr_prependl(b, p) phpstr_prepend((b), (p), strlen(p)) -PHPSTR_API void phpstr_prepend(phpstr *buf, const char *prepend, size_t prepend_len); -PHPSTR_API size_t phpstr_prependf(phpstr *buf, const char *format, ...); +PHPSTR_API size_t phpstr_prepend(phpstr *buf, const char *prepend, size_t prepend_len); +PHPSTR_API size_t phpstr_prependf(phpstr *buf, const char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 2, 3); /* get a zero-terminated string */ PHPSTR_API char *phpstr_data(const phpstr *buf, char **into, size_t *len); @@ -128,7 +153,13 @@ PHPSTR_API void phpstr_fix(phpstr *buf); PHPSTR_API void phpstr_dtor(phpstr *buf); /* free a phpstr object completely */ -PHPSTR_API void phpstr_free(phpstr *buf); +PHPSTR_API void phpstr_free(phpstr **buf); + +/* stores data in a phpstr until it reaches chunk_size */ +PHPSTR_API size_t phpstr_chunk_buffer(phpstr **s, const char *data, size_t data_len, char **chunk, size_t chunk_size); + +/* wrapper around phpstr_chunk_buffer, which passes available chunks to passthru() */ +PHPSTR_API void phpstr_chunked_output(phpstr **s, const char *data, size_t data_len, size_t chunk_size, void (*passthru)(const char *, size_t TSRMLS_DC) TSRMLS_DC); #endif @@ -141,4 +172,3 @@ PHPSTR_API void phpstr_free(phpstr *buf); * vim600: sw=4 ts=4 fdm=marker * vim<600: sw=4 ts=4 */ -