BLI_dynstr.cc File Reference

#include <cstdio>
#include <cstdlib>
#include <cstring>
#include "BLI_dynstr.h"
#include "BLI_memarena.h"
#include "BLI_string.h"
#include "BLI_utildefines.h"
#include "MEM_guardedalloc.h"

Go to the source code of this file.

Classes
struct	DynStrElem
struct	DynStr

Functions
DynStr *	BLI_dynstr_new ()
DynStr *	BLI_dynstr_new_memarena ()
template<typename T>
T *	dynstr_alloc (DynStr *__restrict ds, size_t num=1)
void	BLI_dynstr_append (DynStr *__restrict ds, const char *cstr)
void	BLI_dynstr_nappend (DynStr *__restrict ds, const char *cstr, int len)
void	BLI_dynstr_vappendf (DynStr *__restrict ds, const char *__restrict format, va_list args)
void	BLI_dynstr_appendf (DynStr *__restrict ds, const char *__restrict format,...)
int	BLI_dynstr_get_len (const DynStr *ds)
void	BLI_dynstr_get_cstring_ex (const DynStr *__restrict ds, char *__restrict rets)
char *	BLI_dynstr_get_cstring (const DynStr *ds)
void	BLI_dynstr_clear (DynStr *ds)
void	BLI_dynstr_free (DynStr *ds)

Detailed Description

Dynamically sized string ADT.

Definition in file BLI_dynstr.cc.

Function Documentation

BLI_dynstr_append()

void BLI_dynstr_append	(	DynStr *__restrict	ds,
		const char *	cstr )

Append a c-string to a DynStr.

Parameters

ds	The DynStr to append to.
cstr	The c-string to append.

Definition at line 56 of file BLI_dynstr.cc.

References dynstr_alloc(), DynStrElem::next, and DynStrElem::str.

Referenced by BKE_cryptomatte_entries_to_matte_id(), BKE_mesh_debug_info(), BLI_dynstr_appendf(), BLI_dynstr_vappendf(), BLI_string_replaceN(), BM_mesh_debug_info(), console_select_to_buffer(), blender::gpu::create_key(), Matrix_str(), blender::gpu::Shader::print_log(), report_copy_exec(), RNA_path_append(), rna_path_rename_fix(), RNA_struct_available_or_report(), ui_layout_introspect_items(), Vector_str(), and wm_platform_support_create_link().

BLI_dynstr_appendf()

void BLI_dynstr_appendf	(	DynStr *__restrict	ds,
		const char *__restrict	format,
			... )

Definition at line 106 of file BLI_dynstr.cc.

References BLI_dynstr_append(), BLI_vsprintfN_with_buffer(), LIKELY, MEM_freeN(), and str.

BLI_dynstr_clear()

void BLI_dynstr_clear

(

DynStr *

ds

)

Clear the DynStr

Parameters

ds	The DynStr to clear.

Definition at line 150 of file BLI_dynstr.cc.

References BLI_memarena_clear(), DynStr::curlen, DynStr::elems, free(), DynStr::last, DynStr::memarena, and DynStrElem::next.

Referenced by BLI_dynstr_free(), and BLI_dynstr_vappendf().

BLI_dynstr_free()

void BLI_dynstr_free

(

DynStr *

ds

)

Free the DynStr

Parameters

ds	The DynStr to free.

Definition at line 168 of file BLI_dynstr.cc.

References BLI_dynstr_clear(), BLI_memarena_free(), MEM_freeN(), and DynStr::memarena.

Referenced by BKE_cryptomatte_entries_to_matte_id(), BKE_mesh_debug_info(), BKE_reports_string(), BLI_dynstr_vappendf(), BLI_string_replaceN(), BM_mesh_debug_info(), bmp_slots_as_args(), console_select_to_buffer(), blender::gpu::create_gpu_name(), blender::gpu::create_key(), blender::animrig::get_keyframe_values_create_reports(), IDP_reprN(), main_args_help_as_string(), mathutils_dynstr_to_py(), blender::gpu::Shader::print_log(), pyrna_enum_repr(), pyrna_func_vectorcall(), report_copy_exec(), rna_idp_path_create(), RNA_path_append(), rna_path_rename_fix(), RNA_struct_available_or_report(), studiolight_write_solid_light(), UI_layout_introspect(), and wm_platform_support_create_link().

BLI_dynstr_get_cstring()

char * BLI_dynstr_get_cstring

(

const DynStr *

ds

)

Get a DynStr's contents as a c-string.

Returns

The c-string which must be freed using MEM_freeN.

Parameters

ds	The DynStr of interest.

Returns

The contents of ds as a c-string.

Definition at line 143 of file BLI_dynstr.cc.

References BLI_dynstr_get_cstring_ex(), DynStr::curlen, and MEM_malloc_arrayN().

Referenced by BKE_cryptomatte_entries_to_matte_id(), BKE_mesh_debug_info(), BKE_reports_string(), BLI_dynstr_vappendf(), BLI_string_replaceN(), BM_mesh_debug_info(), bmp_slots_as_args(), console_select_to_buffer(), blender::gpu::create_gpu_name(), blender::gpu::create_key(), blender::animrig::get_keyframe_values_create_reports(), IDP_reprN(), main_args_help_as_string(), blender::gpu::Shader::print_log(), pyrna_enum_repr(), pyrna_func_vectorcall(), report_copy_exec(), rna_idp_path_create(), RNA_path_append(), rna_path_rename_fix(), RNA_struct_available_or_report(), studiolight_write_solid_light(), and UI_layout_introspect().

BLI_dynstr_get_cstring_ex()

void BLI_dynstr_get_cstring_ex	(	const DynStr *__restrict	ds,
		char *__restrict	rets )

Get a DynStr's contents as a c-string. The rets argument must be allocated to be at least the size of BLI_dynstr_get_len(ds) + 1.

Parameters

ds	The DynStr of interest.
rets	The string to fill.

Definition at line 127 of file BLI_dynstr.cc.

References BLI_assert, DynStrElem::next, and DynStrElem::str.

Referenced by BLI_dynstr_get_cstring(), BLI_dynstr_vappendf(), mathutils_dynstr_to_py(), and wm_platform_support_create_link().

BLI_dynstr_get_len()

int BLI_dynstr_get_len

(

const DynStr *

ds

)

Find the length of a DynStr.

Parameters

ds	The DynStr of interest.

Returns

The length of ds.

Definition at line 122 of file BLI_dynstr.cc.

References DynStr::curlen.

Referenced by BKE_reports_string(), BLI_dynstr_vappendf(), console_select_to_buffer(), IDP_reprN(), mathutils_dynstr_to_py(), studiolight_write_solid_light(), and wm_platform_support_create_link().

BLI_dynstr_nappend()

void BLI_dynstr_nappend	(	DynStr *__restrict	ds,
		const char *	cstr,
		int	len )

Append a length clamped c-string to a DynStr.

Parameters

ds	The DynStr to append to.
cstr	The c-string to append.
len	The maximum length of the c-string to copy.

Definition at line 75 of file BLI_dynstr.cc.

References BLI_strnlen(), dynstr_alloc(), len, DynStrElem::next, and DynStrElem::str.

Referenced by BKE_cryptomatte_entries_to_matte_id(), BLI_string_replaceN(), console_select_to_buffer(), blender::gpu::Shader::print_log(), repr_str(), and rna_path_rename_fix().

BLI_dynstr_new()

DynStr * BLI_dynstr_new

(

void

)

Create a new DynStr.

Returns

Pointer to a new DynStr.

Definition at line 37 of file BLI_dynstr.cc.

References MEM_callocN().

Referenced by BKE_cryptomatte_entries_to_matte_id(), BKE_mesh_debug_info(), BKE_reports_string(), BLI_string_replaceN(), BM_mesh_debug_info(), bmp_slots_as_args(), Color_str(), console_select_to_buffer(), blender::gpu::create_gpu_name(), blender::gpu::create_key(), Euler_str(), blender::animrig::get_keyframe_values_create_reports(), IDP_reprN(), main_args_help_as_string(), Matrix_str(), blender::gpu::Shader::print_log(), pyrna_enum_repr(), pyrna_func_vectorcall(), Quaternion_str(), report_copy_exec(), rna_idp_path_create(), RNA_path_append(), rna_path_rename_fix(), RNA_struct_available_or_report(), studiolight_write_solid_light(), UI_layout_introspect(), Vector_str(), and wm_platform_support_create_link().

BLI_dynstr_new_memarena()

DynStr * BLI_dynstr_new_memarena

(

void

)

Create a new DynStr.

Returns

Pointer to a new DynStr.

Definition at line 42 of file BLI_dynstr.cc.

References BLI_memarena_new(), BLI_MEMARENA_STD_BUFSIZE, MEM_callocN(), and DynStr::memarena.

BLI_dynstr_vappendf()

void BLI_dynstr_vappendf	(	DynStr *__restrict	ds,
		const char *__restrict	format,
		va_list	args )

Definition at line 95 of file BLI_dynstr.cc.

References BLI_dynstr_append(), BLI_vsprintfN_with_buffer(), MEM_freeN(), and str.

dynstr_alloc()

template<typename T>

T * dynstr_alloc ( DynStr *__restrict ds, size_t num = 1 )

inline

Definition at line 50 of file BLI_dynstr.cc.

References BLI_memarena_alloc(), num, and T.

Referenced by BLI_dynstr_append(), and BLI_dynstr_nappend().