FFmpeg
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Data Structures | Macros | Functions
bprint.h File Reference
#include "attributes.h"
#include "avstring.h"

Go to the source code of this file.

Data Structures

struct  AVBPrint
 Buffer to print data progressively. More...
 

Macros

#define FF_PAD_STRUCTURE(size,...)
 Define a structure with extra padding to a fixed size This helps ensuring binary compatibility with future versions.
 
#define AV_BPRINT_SIZE_UNLIMITED   ((unsigned)-1)
 Convenience macros for special values for av_bprint_init() size_max parameter.
 
#define AV_BPRINT_SIZE_AUTOMATIC   1
 
#define AV_BPRINT_SIZE_COUNT_ONLY   0
 

Functions

void av_bprint_init (AVBPrint *buf, unsigned size_init, unsigned size_max)
 Init a print buffer.
 
void av_bprint_init_for_buffer (AVBPrint *buf, char *buffer, unsigned size)
 Init a print buffer using a pre-existing buffer.
 
void av_bprintf (AVBPrint *buf, const char *fmt,...) av_printf_format(2
 Append a formatted string to a print buffer.
 
void void av_bprint_chars (AVBPrint *buf, char c, unsigned n)
 Append char c n times to a print buffer.
 
void av_bprint_strftime (AVBPrint *buf, const char *fmt, const struct tm *tm)
 Append a formatted date and time to a print buffer.
 
void av_bprint_get_buffer (AVBPrint *buf, unsigned size, unsigned char **mem, unsigned *actual_size)
 Allocate bytes in the buffer for external use.
 
void av_bprint_clear (AVBPrint *buf)
 Reset the string to "" but keep internal allocated data.
 
static int av_bprint_is_complete (AVBPrint *buf)
 Test if the print buffer is complete (not truncated).
 
int av_bprint_finalize (AVBPrint *buf, char **ret_str)
 Finalize a print buffer.
 
void av_bprint_escape (AVBPrint *dstbuf, const char *src, const char *special_chars, enum AVEscapeMode mode, int flags)
 Escape the content in src and append it to dstbuf.
 

Macro Definition Documentation

#define FF_PAD_STRUCTURE (   size,
  ... 
)
Value:
__VA_ARGS__ \
char reserved_padding[size - sizeof(struct { __VA_ARGS__ })];

Define a structure with extra padding to a fixed size This helps ensuring binary compatibility with future versions.

Definition at line 31 of file bprint.h.

#define AV_BPRINT_SIZE_UNLIMITED   ((unsigned)-1)
#define AV_BPRINT_SIZE_AUTOMATIC   1
#define AV_BPRINT_SIZE_COUNT_ONLY   0

Definition at line 91 of file bprint.h.

Function Documentation

void av_bprint_init ( AVBPrint buf,
unsigned  size_init,
unsigned  size_max 
)

Init a print buffer.

Parameters
bufbuffer to init
size_initinitial size (including the final 0)
size_maxmaximum size; 0 means do not write anything, just count the length; 1 is replaced by the maximum value for automatic storage; any large value means that the internal buffer will be reallocated as needed up to that limit; -1 is converted to UINT_MAX, the largest limit possible. Check also AV_BPRINT_SIZE_* macros.

Definition at line 68 of file bprint.c.

Referenced by ass_read_header(), av_escape(), avfilter_graph_dump(), compact_print_str(), config_output(), configure_input_audio_filter(), configure_input_video_filter(), configure_output_audio_filter(), decode_zbuf(), dvdsub_init(), ffprobe_show_program_version(), flat_print_str(), ini_print_str(), init(), init_report(), jacosub_decode_frame(), jacosub_read_header(), json_print_int(), json_print_item_str(), json_print_section_header(), lavfi_read_packet(), main(), make_command_flags_str(), microdvd_decode_frame(), microdvd_init(), mpsub_read_header(), parse_string(), print_report(), realtext_decode_frame(), realtext_read_header(), sami_init(), sami_read_header(), show_frame(), show_packet(), show_stream(), srt_read_header(), subviewer_decode_frame(), subviewer_read_header(), webvtt_decode_frame(), webvtt_read_header(), writer_open(), writer_print_data(), writer_print_rational(), and xml_print_str().

void av_bprint_init_for_buffer ( AVBPrint buf,
char *  buffer,
unsigned  size 
)

Init a print buffer using a pre-existing buffer.

The buffer will not be reallocated.

Parameters
bufbuffer structure to init
bufferbyte buffer to use for the string data
sizesize of buffer

Definition at line 84 of file bprint.c.

Referenced by av_get_channel_layout_string().

void av_bprintf ( AVBPrint buf,
const char *  fmt,
  ... 
)

Append a formatted string to a print buffer.

void void av_bprint_chars ( AVBPrint buf,
char  c,
unsigned  n 
)
void av_bprint_strftime ( AVBPrint buf,
const char *  fmt,
const struct tm *  tm 
)

Append a formatted date and time to a print buffer.

param buf bprint buffer to use param fmt date and time format string, see strftime() param tm broken-down time structure to translate

Note
due to poor design of the standard strftime function, it may produce poor results if the format string expands to a very long text and the bprint buffer is near the limit stated by the size_max option.

Definition at line 134 of file bprint.c.

Referenced by draw_text(), and func_strftime().

void av_bprint_get_buffer ( AVBPrint buf,
unsigned  size,
unsigned char **  mem,
unsigned *  actual_size 
)

Allocate bytes in the buffer for external use.

Parameters
[in]bufbuffer structure
[in]sizerequired size
[out]mempointer to the memory area
[out]actual_sizesize of the memory area after allocation; can be larger or smaller than size

Definition at line 176 of file bprint.c.

Referenced by decode_zbuf().

void av_bprint_clear ( AVBPrint buf)
static int av_bprint_is_complete ( AVBPrint buf)
inlinestatic

Test if the print buffer is complete (not truncated).

It may have been truncated due to a memory allocation failure or the size_max limit (compare size and size_max if necessary).

Definition at line 166 of file bprint.h.

Referenced by av_bprint_alloc(), av_escape(), draw_text(), expand_text(), init_report(), lavfi_read_packet(), main(), and parse_string().

int av_bprint_finalize ( AVBPrint buf,
char **  ret_str 
)
void av_bprint_escape ( AVBPrint dstbuf,
const char *  src,
const char *  special_chars,
enum AVEscapeMode  mode,
int  flags 
)

Escape the content in src and append it to dstbuf.

Parameters
dstbufalready inited destination bprint buffer
srcstring containing the text to escape
special_charsstring containing the special characters which need to be escaped, can be NULL
modeescape mode to employ, see AV_ESCAPE_MODE_* macros. Any unknown value for mode will be considered equivalent to AV_ESCAPE_MODE_BACKSLASH, but this behaviour can change without notice.
flagsflags which control how to escape, see AV_ESCAPE_FLAG_* macros

Definition at line 223 of file bprint.c.

Referenced by av_escape().