print_8h_source.html

#pragma once

/*

 *   This library is free software; you can redistribute it and/or

 *   modify it under the terms of the GNU Lesser General Public

 *   License as published by the Free Software Foundation; either

 *   version 2.1 of the License, or (at your option) any later version.

 *

 *   This library is distributed in the hope that it will be useful,

 *   but WITHOUT ANY WARRANTY; without even the implied warranty of

 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU

 *   Lesser General Public License for more details.

 *

 *   You should have received a copy of the GNU Lesser General Public

 *   License along with this library; if not, write to the Free Software

 *   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA

 */


/** Functions to produce and parse the FreeRADIUS presentation format

 *

 * @file src/lib/util/print.h

 *

 * @copyright 2000,2006 The FreeRADIUS server project

 */

RCSIDH(print_h, "$Id: 37f51ebc623b2a2b04f434c897d23e19eae1d401 $")


#ifdef __cplusplus

extern "C" {

#endif


#include <freeradius-devel/build.h>

#include <freeradius-devel/missing.h>

#include <freeradius-devel/util/talloc.h>


#include <stddef.h>

#include <stdint.h>


size_t          fr_utf8_char(uint8_t const *str, ssize_t inlen);

ssize_t         fr_utf8_str(uint8_t const *str, ssize_t inlen);

char const      *fr_utf8_strchr(int *chr_len, char const *str, ssize_t inlen, char const *chr);

size_t          fr_snprint(char *out, size_t outlen, char const *in, ssize_t inlen, char quote);

size_t          fr_snprint_len(char const *in, ssize_t inlen, char quote);

char            *fr_asprint(TALLOC_CTX *ctx, char const *in, ssize_t inlen, char quote);

char            *fr_vasprintf(TALLOC_CTX *ctx, char const *fmt, va_list ap);

char            *fr_vasprintf_secure(TALLOC_CTX *ctx, char const *fmt, va_list ap);

char            *fr_asprintf(TALLOC_CTX *ctx, char const *fmt, ...) CC_HINT(format (printf, 2, 3));

ssize_t         fr_fprintf(FILE *stream, char const *fmt, ...) CC_HINT(format (printf, 2, 3));


#define         is_truncated(_ret, _max) ((_ret) >= (size_t)(_max))

#define         truncate_len(_ret, _max) (((_ret) >= (size_t)(_max)) ? (((size_t)(_max)) - 1) : _ret)

fmt
static int const char * fmt
Definition acutest.h:573

RCSIDH
#define RCSIDH(h, id)
Definition build.h:484

in
static fr_slen_t in
Definition dict.h:824

ssize_t
long int ssize_t
Definition merged_model.c:24

uint8_t
unsigned char uint8_t
Definition merged_model.c:30

fr_snprint
size_t fr_snprint(char *out, size_t outlen, char const *in, ssize_t inlen, char quote)
Escape any non printable or non-UTF8 characters in the input string.
Definition print.c:227

fr_vasprintf_secure
char * fr_vasprintf_secure(TALLOC_CTX *ctx, char const *fmt, va_list ap)
Definition print.c:856

fr_fprintf
ssize_t fr_fprintf(FILE *stream, char const *fmt,...))
Special version of fprintf which implements custom format specifiers.
Definition print.c:897

fr_asprintf
char * fr_asprintf(TALLOC_CTX *ctx, char const *fmt,...))
Special version of asprintf which implements custom format specifiers.
Definition print.c:874

fr_utf8_str
ssize_t fr_utf8_str(uint8_t const *str, ssize_t inlen)
Validate a complete UTF8 string.
Definition print.c:143

fr_utf8_char
size_t fr_utf8_char(uint8_t const *str, ssize_t inlen)
Checks for utf-8, taken from http://www.w3.org/International/questions/qa-forms-utf-8.
Definition print.c:39

fr_snprint_len
size_t fr_snprint_len(char const *in, ssize_t inlen, char quote)
Find the length of the buffer required to fully escape a string with fr_prints.
Definition print.c:409

fr_utf8_strchr
char const * fr_utf8_strchr(int *chr_len, char const *str, ssize_t inlen, char const *chr)
Return a pointer to the first UTF8 char in a string.
Definition print.c:174

fr_asprint
char * fr_asprint(TALLOC_CTX *ctx, char const *in, ssize_t inlen, char quote)
Escape string that may contain binary data, and write it to a new buffer.
Definition print.c:428

fr_vasprintf
char * fr_vasprintf(TALLOC_CTX *ctx, char const *fmt, va_list ap)
Definition print.c:851

inlen
static size_t char fr_sbuff_t size_t inlen
Definition value.h:997

out
static size_t char ** out
Definition value.h:997