Functions
char *	BLI_strdup (const char *str)
char *	BLI_strdupn (const char *str, const size_t len)
char *	BLI_strdupcat (const char str1, const char str2)
char *	BLI_strncpy (char dst, const char src, const size_t maxncpy)
char *	BLI_getQuotedStr (const char str, const char prefix)
char *	BLI_replacestr (char str, const char oldText, const char *newText)
size_t	BLI_snprintf (char buffer, size_t len, const char format,...)
char *	BLI_sprintfN (const char *format,...)
int	BLI_strcaseeq (const char a, const char b)
char *	BLI_strcasestr (const char s, const char find)
int	BLI_strcasecmp (const char s1, const char s2)
int	BLI_strncasecmp (const char s1, const char s2, size_t len)
int	BLI_natstrcmp (const char s1, const char s2)
size_t	BLI_strnlen (const char *str, size_t maxlen)
void	BLI_timestr (double _time, char *str)
int	BLI_utf8_invalid_byte (const char *str, int length)
int	BLI_utf8_invalid_strip (char *str, int length)
void	BLI_ascii_strtolower (char *str, int len)
void	BLI_ascii_strtoupper (char *str, int len)

Detailed Description

Definition in file BLI_string.h.

Function Documentation

void BLI_ascii_strtolower	(	char *	str,
		int	len
	)

Definition at line 467 of file string.c.

References i.

Referenced by WM_operator_py_idname().

void BLI_ascii_strtoupper	(	char *	str,
		int	len
	)

Definition at line 476 of file string.c.

References i.

Referenced by WM_operator_bl_idname().

char* BLI_getQuotedStr	(	const char *	str,
		const char *	prefix
	)

Definition at line 129 of file string.c.

References BLI_strdupn().

Referenced by animchan_sync_fcurve(), autokeyframe_pose_cb_func(), getname_anim_fcurve(), list_find_data_fcurves(), and skip_fcurve_selected_data().

int BLI_natstrcmp	(	const char *	s1,
		const char *	s2
	)

Definition at line 281 of file string.c.

References NULL.

Referenced by BLI_compare(), compare_date(), compare_name(), compare_size(), and vgroup_sort().

char* BLI_replacestr	(	char *	str,
		const char *	oldText,
		const char *	newText
	)

Returns a copy of the cstring str into a newly mallocN'd string with all instances of oldText replaced with newText, and returns it.

Parameters:

str	The string to replace occurances of oldText in
oldText	The text in the string to find and replace
newText	The text in the string to find and replace

Return values:

Returns the duplicated string

Definition at line 149 of file string.c.

References BLI_dynstr_append(), BLI_dynstr_free(), BLI_dynstr_get_cstring(), BLI_dynstr_new(), BLI_strdup(), and NULL.

size_t BLI_snprintf	(	char *	buffer,
		size_t	len,
		const char *	format,
			...
	)

Definition at line 84 of file string.c.

Referenced by acf_shapekey_name(), add_hook_object(), ANIM_add_driver(), BKE_write_undo(), BL_ArmatureConstraint::BL_ArmatureConstraint(), BLI_copy_fileops(), BLI_delete(), BLI_link(), BLI_move(), BLI_uniquename_cb(), BLO_write_file(), bone_autoside_name(), bpy_text_filename_get(), but_shortcut_name_func(), check_for_dupid(), AnimationExporter::dae_animation(), AnimationExporter::dae_bone_animation(), do_history(), draw_viewport_fps(), draw_viewport_name(), ed_marker_add(), ed_marker_move_modal(), ED_screen_full_toggle(), AnimationExporter::enable_fcurves(), AnimationImporter::evaluate_animation(), flip_side_name(), fluid_init_filepaths(), fluidsim_delete_until_lastframe(), fluidsim_read_cache(), fluidsimBake(), fsmenu_read_system(), get_path_system(), get_path_user(), ArmatureImporter::get_rna_path_for_joint(), getname_anim_fcurve(), GPU_print_framebuffer_error(), GPU_texture_create_nD(), handle_subversion_warning(), IDnames_to_dyn_pupstring(), IMB_thumb_create(), initglobals(), ipo_to_animdata(), mtex_adrcodes_to_paths(), multiple_scattering_diffusion(), multires_external_save_invoke(), new_folder_path(), node_composit_buts_image(), particles_fluid_step(), print_part_stats(), RNA_path_append(), AnimationExporter::sample_and_write_bone_animation(), scene_unique_exr_name(), seq_remap_paths(), set_addons(), sk_autoname(), stampdata(), ExtraHandler::textData(), thumbname_from_uri(), thumbpath_from_uri(), AnimationImporter::translate_animation(), ui_check_but(), ui_get_but_string(), ui_menu_block_set_keymaps(), ui_tooltip_create(), v3d_editvertex_buts(), verify_adt_action(), vgroup_duplicate(), view3d_main_area_draw(), vol_precache_objectinstance_threads(), wm_autosave_location(), wm_block_create_splash(), wm_window_title(), and AnimationImporter::write_animation_list().

char* BLI_sprintfN	(	const char *	format,
			...
	)

Definition at line 102 of file string.c.

References BLI_dynstr_free(), BLI_dynstr_get_cstring(), BLI_dynstr_new(), and BLI_dynstr_vappendf().

Referenced by BKE_animdata_fix_paths_rename(), fcurve_path_rename(), get_driver_path_hack(), getname_anim_fcurve(), pose_slide_apply_quat(), pose_slide_apply_vec3(), RNA_path_from_ID_to_property(), set_brush_rc_path(), and set_brush_rc_props().

int BLI_strcasecmp	(	const char *	s1,
		const char *	s2
	)

Definition at line 242 of file string.c.

References i.

Referenced by BLI_strcaseeq(), BLI_testextensie(), compare_extension(), compare_property(), exr_rgba_channelname(), find_and_replace(), keycmp(), outliner_filter_has_name(), set_property(), sort_alpha_id(), and sort_search_items_list().

int BLI_strcaseeq	(	const char *	a,
		const char *	b
	)

Compare two strings without regard to case.

Return values:

True	if the strings are equal, false otherwise.

Definition at line 215 of file string.c.

References BLI_strcasecmp().

Referenced by ExtraHandler::parseElement().

char* BLI_strcasestr	(	const char *	s,
		const char *	find
	)

Definition at line 221 of file string.c.

References BLI_strncasecmp(), and NULL.

Referenced by file_is_blend_backup(), flip_side_name(), id_search_cb(), operator_enum_search_cb(), operator_search_cb(), outliner_filter_has_name(), poselib_preview_get_next(), rna_search_cb(), skip_fcurve_with_name(), and txt_find_string().

char* BLI_strdup ( const char * str )

Duplicates the cstring str into a newly mallocN'd string and returns it.

Parameters:

str	The string to be duplicated

Return values:

Returns the duplicated string

Definition at line 57 of file string.c.

References BLI_strdupn().

Referenced by BLF_dir_add(), BLF_dir_get(), blf_dir_metrics_search(), blf_dir_search(), blf_font_new(), blf_font_new_from_mem(), BLI_builddir(), BLI_replacestr(), but_shortcut_name_func(), console_lb_add__internal(), console_lb_add_str__internal(), decompose_menu_string(), filelist_from_library(), filelist_from_main(), fsmenu_insert_entry(), ibJpegImageFromCinfo(), icu_to_fcurves(), IMB_metadata_add_field(), IMB_metadata_change_field(), modifier_setError(), nodeMakeDynamicType(), pyrna_struct_anim_args_parse(), RNA_path_back(), RNA_path_from_ID_to_property(), RNA_path_from_ID_to_struct(), rna_search_cb(), save_as_exec(), text_setpath(), ui_menu_block_set_keymaps(), ui_textedit_begin(), WM_read_history(), and write_history().

char* BLI_strdupcat	(	const char *	str1,
		const char *	str2
	)

Appends the two strings, and returns new mallocN'ed string

Parameters:

str1	first string for copy
str2	second string for append

Return values:

Returns dst

Definition at line 61 of file string.c.

References MEM_mallocN().

Referenced by BLI_builddir().

char* BLI_strdupn	(	const char *	str,
		const size_t	len
	)

Duplicates the first len bytes of cstring str into a newly mallocN'd string and returns it. str is assumed to be at least len bytes long.

Parameters:

str	The string to be duplicated
len	The number of bytes to duplicate

Return values:

Returns the duplicated string

Definition at line 50 of file string.c.

References MEM_mallocN().

Referenced by BKE_keyingset_add_path(), BKE_nlastrip_validate_fcurves(), BLI_getQuotedStr(), BLI_read_file_as_lines(), BLI_strdup(), verify_driver_fcurve(), and verify_fcurve().

int BLI_strncasecmp	(	const char *	s1,
		const char *	s2,
		size_t	len
	)

Definition at line 261 of file string.c.

References i.

Referenced by BLI_strcasestr(), and txt_unindent().

char* BLI_strncpy	(	char *	dst,
		const char *	src,
		const size_t	maxncpy
	)

Like strncpy but ensures dst is always '\0' terminated.

Parameters:

dst	Destination for copy
src	Source string to copy
maxncpy	Maximum number of characters to copy (generally the size of dst)

Return values:

Returns dst

Definition at line 74 of file string.c.

Referenced by acf_filldrivers_name(), acf_fillmatd_name(), acf_fillpartd_name(), acf_filltexd_name(), acf_generic_idblock_name(), acf_gpl_name(), acf_group_name(), acf_object_name(), acf_shapekey_name(), acf_summary_name(), actuator_add_exec(), AnimationImporter::add_bone_fcurve(), add_curve(), add_hook_object(), add_ibuf_size(), add_new_constraint_internal(), add_object(), add_scene(), add_text(), ANIM_add_driver(), ANIM_channel_debug_print_info(), armature_autoside_names_exec(), armature_extrude_exec(), MeshImporter::assign_textures_to_uvlayer(), autocomplete_directory(), autocomplete_do_name(), autocomplete_end(), BKE_add_image_file(), BKE_add_image_imbuf(), BKE_add_image_size(), BKE_keyingset_add(), BKE_keyingset_add_path(), BKE_makepicstring(), BKE_ptcache_disk_cache_rename(), BKE_ptcache_id_clear(), BKE_ptcache_id_time(), BKE_ptcache_load_external(), BKE_rebase_path(), BKE_write_undo(), BLI_adddirstrings(), BLI_exist(), BLI_getlastdir(), BLI_getwdN(), BLI_join_dirfile(), BLI_make_existing_file(), BLI_make_file_string(), BLI_parent_dir(), BLI_path_abs(), BLI_path_cwd(), BLI_path_rel(), BLI_split_dirfile(), BLI_splitdirstring(), BLI_testextensie_glob(), BLI_uniquename_cb(), BLI_where_am_i(), BLI_where_is_temp(), blo_find_main(), BLO_is_a_library(), blo_openblenderfile(), blo_read_blendafterruntime(), boid_new_rule(), bone_autoside_name(), bookmark_select_exec(), BPy_IDGroup_SetName(), bpy_lib_enter(), bpy_lib_load(), cache_voxeldata(), cdf_layer_add(), constraint_bone_name_fix(), controller_add_exec(), copy_attr(), copy_image(), copy_object(), copyData(), CTX_store_add(), customData_add_layer__internal(), CustomData_external_add(), customdata_external_filename(), direct_link_library(), do_write_image_or_movie(), drivers_path_rename_fix(), duplicateEditBoneObjects(), ED_area_headerprint(), ED_armature_bone_rename(), ED_armature_edit_bone_add(), ED_armature_from_edit(), ED_fileselect_set_params(), ed_marker_duplicate_apply(), ED_object_modifier_add(), ED_object_parent(), ED_vgroup_add_name(), file_browse_exec(), file_change_dir(), file_directory_exec(), file_directory_new_exec(), file_draw_string(), file_expand_directory(), file_panel_category(), file_panel_operator_header(), file_refresh(), file_rename_exec(), file_select_do(), file_shorten_string(), filelist_from_library(), filelist_read_library(), filelist_setdir(), filelist_setfilter_types(), find_set_selected_exec(), findFileRecursive(), flip_side_name(), fluid_init_filepaths(), fluidsim_delete_until_lastframe(), fluidsim_init(), fluidsim_read_cache(), fluidsimBake(), folderlist_popdir(), folderlist_pushdir(), get_brush_icon(), get_filename(), get_path_local(), get_path_system(), get_path_user(), get_suggest_prefix(), get_thumb_dir(), gpu_node_input_link(), gpu_nodes_get_vertex_attributes(), groupname_to_code(), IDP_AssignString(), idp_generic_copy(), IDP_NewIDPArray(), IDP_NewString(), idriver_to_cdriver(), image_load_image_file(), image_load_movie_file(), image_load_sequence_file(), imb_cache_filename(), IMB_exr_add_channel(), imb_exr_get_layer(), imb_exr_get_pass(), IMB_exr_set_channel(), imb_exr_split_channel_name(), IMB_loadiffname(), IMB_metadata_get_field(), IMB_testiffname(), init_iconfile_list(), join_armature_exec(), joined_armature_fix_links(), library_append_end(), load_file(), load_vfont(), main(), make_boneList(), make_pass_name(), makeFilesRelative(), ml_addlayer_cb(), ml_addpass_cb(), namebutton_cb(), new_folder_path(), new_render_result(), node_add_socket_type(), node_browse_text_cb(), node_composit_init_output_file(), node_draw_basis(), node_draw_hidden(), nodeAddNodeType(), ntreeAddTree(), object_add_particle_system(), ImagesExporter::operator()(), operator_call_cb(), operator_search_cb(), pose_add_group(), pose_autoside_names_exec(), pose_paste_exec(), poselib_add_exec(), poselib_rename_exec(), poselib_sanitise_exec(), read_global(), read_undosave(), rename_id(), renamebutton_cb(), renderresult_add_names(), reopen_text(), replace_exec(), replace_set_selected_exec(), return_editmesh_vgroup(), run_python(), save_as_invoke(), save_exec(), save_image_doit(), save_sequence_exec(), scene_unique_exr_name(), sculpt_undo_push_node(), sculpt_update_cache_invariants(), sensor_add_exec(), seq_getpath(), seq_load_apply(), seq_load_operator_info(), seq_remap_paths(), seq_setpath(), sequencer_add_effect_strip_exec(), sequencer_add_image_strip(), sequencer_add_image_strip_exec(), sequencer_add_movie_strip(), sequencer_generic_invoke_path__internal(), sequencer_separate_images_exec(), set_engine(), set_output(), set_property_valstr(), setup_app_data(), sound_new_file(), space_image_file_exists_poll(), split_groups_action_temp(), StartKetsjiShell(), test_env_path(), test_path(), text_file_modified(), text_ignore_modified(), thumbnails_start(), txt_copy_selected(), txt_new_linen(), txt_sel_to_buf(), txt_to_buf(), txt_write_file(), ui_apply_autokey_undo(), ui_but_anim_expression_get(), ui_but_anim_expression_set(), ui_but_copy_paste(), ui_but_drop(), ui_get_but_string(), ui_item_name_add_colon(), ui_searchbox_apply(), ui_set_but_string(), ui_style_new(), ui_text_leftclip(), ui_textedit_set_cursor_pos(), ui_tooltip_create(), uiBeginBlock(), uiBeginPanel(), uiItemMenuEnumO(), uiItemMenuEnumR(), uiSearchItemAdd(), unique_property(), unpack_menu(), uri_from_filename(), verify_pose_channel(), vgroup_init_remap(), view3d_panel_operator_redo_header(), what_does_obaction(), what_does_parent(), widget_draw_text(), wm_add_default(), wm_drop_operator_options(), WM_dropboxmap_find(), WM_event_start_drag(), WM_init(), WM_jobs_get(), WM_keyconfig_new(), WM_keyconfig_remove(), WM_keyconfig_set_active(), WM_keymap_add_item(), WM_keymap_item_to_string(), wm_keymap_new(), WM_keymap_restore_item_to_default(), WM_keymap_verify_item(), wm_link_append_exec(), WM_operator_bl_idname(), wm_operator_create(), WM_operator_py_idname(), WM_operatortype_macro_define(), wm_save_as_mainfile_exec(), wm_save_as_mainfile_invoke(), wm_save_mainfile_invoke(), wm_window_copy(), wm_window_match_do(), wm_window_match_init(), WM_write_file(), AnimationImporter::write_animation_list(), write_crash_blend(), write_global(), write_objects(), and write_renderinfo().

size_t BLI_strnlen	(	const char *	str,
		size_t	maxlen
	)

Definition at line 351 of file string.c.

Referenced by actuator_add_exec(), BLI_clean(), BLI_dynstr_nappend(), BLI_make_file_string(), BLI_path_rel(), BPy_IDGroup_SetName(), controller_add_exec(), do_versions(), edit_object_property_get(), flip_side_name(), and sensor_add_exec().

void BLI_timestr	(	double	_time,
		char *	str
	)

Definition at line 333 of file string.c.

References min.

Referenced by do_write_image_or_movie(), make_renderinfo_string(), and stampdata().

int BLI_utf8_invalid_byte	(	const char *	str,
		int	length
	)

Definition at line 377 of file string.c.

References p, str, and trailingBytesForUTF8.

Referenced by BLI_utf8_invalid_strip().

int BLI_utf8_invalid_strip	(	char *	str,
		int	length
	)

Definition at line 443 of file string.c.

References BLI_utf8_invalid_byte().

Referenced by new_id(), and ui_textedit_end().

Functions

Detailed Description

Function Documentation