Functions responsible for allocating, freeing, and copying memory. More...

Functions
void *	av_malloc (size_t size) av_malloc_attrib 1(1)
	Allocate a memory block with alignment suitable for all memory accesses (including vectors if available on the CPU). More...

void *	av_mallocz (size_t size) av_malloc_attrib 1(1)
	Allocate a memory block with alignment suitable for all memory accesses (including vectors if available on the CPU) and zero all the bytes of the block. More...

void *	av_malloc_array (size_t nmemb, size_t size)

void *	av_calloc (size_t nmemb, size_t size) av_malloc_attrib 1(1
	Allocate a memory block for an array with av_mallocz(). More...

void attribute_deprecated void *	av_mallocz_array (size_t nmemb, size_t size) av_malloc_attrib 1(1

void attribute_deprecated void void *	av_realloc (void *ptr, size_t size) 1(2)
	Allocate, reallocate, or free a block of memory. More...

av_warn_unused_result int	av_reallocp (void *ptr, size_t size)
	Allocate, reallocate, or free a block of memory through a pointer to a pointer. More...

void *	av_realloc_f (void *ptr, size_t nelem, size_t elsize)
	Allocate, reallocate, or free a block of memory. More...

void *	av_realloc_array (void *ptr, size_t nmemb, size_t size)

int	av_reallocp_array (void *ptr, size_t nmemb, size_t size)
	Allocate, reallocate an array through a pointer to a pointer. More...

void *	av_fast_realloc (void ptr, unsigned int size, size_t min_size)
	Reallocate the given buffer if it is not large enough, otherwise do nothing. More...

void	av_fast_malloc (void ptr, unsigned int size, size_t min_size)
	Allocate a buffer, reusing the given one if large enough. More...

void	av_fast_mallocz (void ptr, unsigned int size, size_t min_size)
	Allocate and clear a buffer, reusing the given one if large enough. More...

void	av_free (void *ptr)
	Free a memory block which has been allocated with a function of av_malloc() or av_realloc() family. More...

void	av_freep (void *ptr)
	Free a memory block which has been allocated with a function of av_malloc() or av_realloc() family, and set the pointer pointing to it to `NULL`. More...

char *	av_strdup (const char *s) av_malloc_attrib
	Duplicate a string. More...

char *	av_strndup (const char *s, size_t len) av_malloc_attrib
	Duplicate a substring of a string. More...

void *	av_memdup (const void *p, size_t size)
	Duplicate a buffer with av_malloc(). More...

void	av_memcpy_backptr (uint8_t *dst, int back, int cnt)
	Overlapping memcpy() implementation. More...

Detailed Description

Functions responsible for allocating, freeing, and copying memory.

All memory allocation functions have a built-in upper limit of INT_MAX bytes. This may be changed with av_max_alloc(), although exercise extreme caution when doing so.

Function Documentation

◆ av_malloc()

void* av_malloc ( size_t size )

Allocate a memory block with alignment suitable for all memory accesses (including vectors if available on the CPU).

Parameters

size	Size in bytes for the memory block to be allocated

Returns: Pointer to the allocated block, or NULL if the block cannot be allocated

See also: av_mallocz()

Definition at line 96 of file mem.c.

Referenced by av_malloc(), av_malloc_array(), av_mallocz(), av_memdup(), and fast_malloc().

◆ av_mallocz()

void* av_mallocz ( size_t size )

Allocate a memory block with alignment suitable for all memory accesses (including vectors if available on the CPU) and zero all the bytes of the block.

Parameters

size	Size in bytes for the memory block to be allocated

Returns: Pointer to the allocated block, or NULL if it cannot be allocated

See also: av_malloc()

Definition at line 264 of file mem.c.

Referenced by a64multi_encode_init(), aac_encode_init(), add_fragment(), add_pes_stream(), add_segment(), add_to_queue(), adpcm_encode_init(), alac_encode_init(), alloc_buffer(), alloc_rbsp_buffer(), allocate_array_elem(), allocate_buffers(), allocate_sample_buffers(), allocate_tables(), amf_encode_init_h264(), amf_encode_init_hevc(), apng_write_header(), asf_read_stream_properties(), ass_decode_frame(), atrac3_decode_init(), av_aes_alloc(), av_aes_ctr_alloc(), av_audio_fifo_alloc(), av_blowfish_alloc(), av_bsf_alloc(), av_bsf_list_alloc(), av_buffer_create(), av_buffer_pool_init(), av_buffer_pool_init2(), av_buffer_ref(), av_buffersrc_parameters_alloc(), av_calloc(), av_camellia_alloc(), av_cast5_alloc(), av_content_light_metadata_alloc(), av_cpb_properties_alloc(), av_des_alloc(), av_detection_bbox_alloc(), av_dict_set(), av_dovi_alloc(), av_dovi_metadata_alloc(), av_dump_format(), av_dynamic_hdr_plus_alloc(), av_dynamic_hdr_vivid_alloc(), av_encryption_info_alloc(), av_encryption_init_info_alloc(), av_expr_parse(), av_fft_init(), av_fifo_alloc2(), av_fifo_alloc_array(), av_film_grain_params_alloc(), av_frame_new_side_data_from_buf(), av_hash_alloc(), av_hmac_alloc(), av_hwdevice_ctx_alloc(), av_hwdevice_get_hwframe_constraints(), av_hwdevice_hwconfig_alloc(), av_hwframe_ctx_alloc(), av_mallocz_array(), av_mastering_display_metadata_alloc(), av_md5_alloc(), av_murmur3_alloc(), av_new_program(), av_opt_query_ranges_default(), av_packet_new_side_data(), av_parser_init(), av_rc4_alloc(), av_ripemd_alloc(), av_sha512_alloc(), av_sha_alloc(), av_spherical_alloc(), av_stereo3d_alloc(), av_tea_alloc(), av_thread_message_queue_alloc(), av_tree_node_alloc(), av_twofish_alloc(), av_vdpau_alloc_context(), av_video_enc_params_alloc(), av_vk_frame_alloc(), av_vorbis_parse_init(), av_xtea_alloc(), avcodec_dct_alloc(), avcodec_open2(), avcodec_parameters_alloc(), avcodec_parameters_copy(), avcodec_parameters_from_context(), avcodec_parameters_to_context(), avdevice_list_devices(), avfilter_graph_alloc(), avfilter_graph_queue_command(), avfilter_inout_alloc(), avfilter_link(), avformat_alloc_context(), avformat_alloc_output_context2(), avformat_new_stream(), avformat_open_input(), avi_read_header(), avi_write_header(), avio_open_dir(), avpriv_adts_header_parse(), avpriv_dv_init_demux(), avpriv_elbg_do(), avpriv_float_dsp_alloc(), avpriv_mpegts_parse_open(), avpriv_new_chapter(), avui_encode_init(), bfi_decode_init(), buffer_create(), callback(), che_configure(), check_add_bytes(), check_add_gradient_pred(), check_add_int16(), check_add_left_pred(), check_add_median_pred(), check_field_queue(), codec_create(), command(), config_output(), cook_decode_init(), copy_chapters(), copy_init_section(), create_buf(), create_exec_ctx(), create_vorbis_context(), cuda_device_init(), cuvid_decode_init(), D(), dash_init(), decklink_autodetect(), decode_dvd_subtitles(), decode_extradata_ps_mp4(), decode_frame(), decode_init(), decode_pic(), decoder_init(), dfa_decode_init(), dhav_read_packet(), display_end_segment(), dnxhd_init_vlc(), do_encrypt(), doTest(), dshow_get_format_info(), dss_read_metadata_string(), dvbsub_parse_display_definition_segment(), dvbsub_parse_page_segment(), dvbsub_parse_region_segment(), dxva2_device_create(), dxva2_map_frame(), eb_enc_init(), encode_frame(), encode_init(), encode_picture_ls(), encode_sample_description(), enqueue_packet(), epic_add_pixel_to_cache(), fast_malloc(), ff_all_channel_counts(), ff_all_channel_layouts(), ff_all_samplerates(), ff_alloc_a53_sei(), ff_alloc_dir_entry(), ff_alloc_input_device_context(), ff_alloc_timecode_sei(), ff_alsa_get_device_list(), ff_AMediaFormat_new(), ff_AMediaFormat_newFromObject(), ff_ass_add_rect2(), ff_ass_split(), ff_ass_split_dialog(), ff_attach_decode_data(), ff_avc_write_annexb_extradata(), ff_cavs_init_top_lines(), ff_cbs_alloc_unit_content(), ff_cbs_alloc_unit_content2(), ff_cbs_init(), ff_cbs_sei_alloc_message_payload(), ff_celt_init(), ff_decklink_list_devices(), ff_decklink_list_devices_legacy(), ff_decklink_read_header(), ff_decklink_write_header(), ff_dnn_load_model_native(), ff_dnn_load_model_ov(), ff_dnn_load_model_tf(), ff_ebur128_init(), ff_fbdev_get_device_list(), ff_ffv1_init_slice_contexts(), ff_filter_alloc(), ff_formats_pixdesc_filter(), ff_frame_pool_audio_init(), ff_frame_pool_video_init(), ff_frame_thread_encoder_init(), ff_frame_thread_init(), ff_get_dnn_module(), ff_graph_thread_init(), ff_h264_decode_picture_parameter_set(), ff_hevc_decode_nal_pps(), ff_hwframe_map_create(), ff_iir_filter_init_coeffs(), ff_iir_filter_init_state(), ff_init_vscale(), ff_intrax8_common_init(), ff_jpegls_decode_picture(), ff_lpc_init(), ff_lzw_decode_open(), ff_make_channel_layout_list(), ff_mdct15_init(), ff_mjpeg_decode_sof(), ff_mlz_init_dict(), ff_mpeg_er_init(), ff_mpv_encode_init(), ff_mpv_init_context_frame(), ff_nut_add_sp(), ff_nvdec_decode_init(), ff_nvdec_start_frame(), ff_opus_psy_init(), ff_parse_mpeg2_descriptor(), ff_pca_init(), ff_psy_preprocess_init(), ff_qsvvpp_create(), ff_rate_control_init(), ff_rdt_parse_open(), ff_read_riff_info(), ff_rfps_add_frame(), ff_rm_alloc_rmstream(), ff_rtp_parse_open(), ff_rtsp_setup_output_streams(), ff_silk_init(), ff_slice_thread_init(), ff_timefilter_new(), ff_tx_gen_ptwo_inplace_revtab_idx(), ff_tx_gen_split_radix_parity_revtab(), ff_tx_init_subtx(), ff_tx_rdft_init(), ff_v4l2_context_init(), ff_v4l2_m2m_create_context(), ff_vaapi_encode_init(), ff_vc1_decode_init_alloc_tables(), ff_videotoolbox_alloc_frame(), ff_vk_add_descriptor_set(), ff_vk_create_exec_ctx(), ff_vk_create_imageview(), ff_vk_glslang_init(), ff_vk_shaderc_init(), ff_vs_init(), ff_wms_parse_sdp_a_line(), ffat_decode(), ffat_init_decoder(), ffat_init_encoder(), ffmal_update_format(), ffmmal_add_packet(), ffmmal_set_ref(), filter_frame(), find_component(), find_headers_search_validate(), flac_read_header(), flashsv2_encode_init(), flashsv_decode_frame(), flashsv_encode_frame(), flashsv_encode_init(), flush_packet(), flv_init(), flv_queue_extradata(), frame_alloc(), frame_pool_alloc(), g2m_init_buffers(), gen_sub_bitmap(), generate_fake_vps(), generate_joint_tables(), get_content_url(), get_current_encryption_info(), get_current_fragment(), get_Fragment(), get_free_frame(), get_http_header_data(), get_private_data(), get_siz(), get_surface(), gif_encode_init(), gxf_write_header(), handle_eac3(), handle_file(), handler(), hevc_init_context(), hls_slice_data_wpp(), hnm_decode_init(), hw_device_add(), hwaccel_init(), iec61883_callback(), init(), init_context_defaults(), init_fps(), init_model_ov(), init_muxer(), init_output_stream(), init_pts(), init_simple_filtergraph(), init_thread(), kmsgrab_read_packet(), lavfi_read_header(), libaribb24_decode(), libcodec2_init_encoder(), libkvazaar_init(), link_filter_inouts(), LLVMFuzzerTestOneInput(), load_glyph(), load_tf_model(), magy_encode_init(), main(), make_eval_expr(), make_field_queue(), make_point(), mediacodec_decode_init(), mediacodec_wrap_hw_buffer(), mf_enca_output_type_get(), mf_encv_output_type_get(), mmsh_open_internal(), mmsh_read_seek(), mov_read_chapters(), mov_read_covr(), mov_read_dref(), mov_read_iloc(), mov_read_keys(), mov_read_pssh(), mov_read_stsd(), mov_read_tenc(), mov_read_trak(), mov_read_udta_string(), mov_read_uuid(), mov_read_wave(), mov_write_dvc1_structs(), mov_write_single_packet(), mpeg_mux_init(), mpeg_mux_write_packet(), mpegts_add_service(), mpegts_init(), mpegts_open_filter(), mpegts_open_section_filter(), mpegts_write_packet_internal(), mss2_decode_init(), mxf_handle_missing_index_segment(), mxf_init(), mxf_read_local_tags(), mxpeg_decode_mxm(), new_init_section(), new_matrix(), new_playlist(), new_rendition(), new_stream(), new_variant(), new_video_stream(), nsv_parse_NSVf_header(), nsv_parse_NSVs_header(), nvdec_decoder_create(), nvdec_retrieve_data(), nvenc_setup_extradata(), ogg_buffer_page(), ogg_build_flac_headers(), ogg_build_opus_headers(), ogg_build_speex_headers(), ogg_build_vp8_headers(), ogg_init(), ogg_save(), ogg_write_vorbiscomment(), omx_component_init(), omx_init(), opaque_list_push(), open_input(), open_virtual_track(), opencl_map_frame(), opencl_pool_alloc(), opus_header(), overlay_qsv_init(), paf_video_init(), parse_cc_stream_mapstring(), parse_fmtp_config(), parse_inputs(), parse_keyframes_index(), parse_manifest_representation(), parse_manifest_segmenttimeline(), parse_primary(), parse_sws_flags(), parse_variant_stream_mapstring(), parse_vtrk(), pic_arrays_init(), pool_alloc_buffer(), pp_get_context(), prepare_buf(), process_output_surface(), psy_3gpp_init(), pulse_add_detected_device(), put_audio_specific_config(), put_main_header(), qsv_decode(), qsv_device_create(), qt_rtp_parse_packet(), qtrle_encode_init(), rdt_parse_b64buf(), read_apic(), read_chapter(), read_gab2_sub(), read_geobtag(), read_header(), read_header_vs(), read_huffman_code_normal(), read_packet_vs(), read_priv(), reallocAlign(), resample_init(), resolve_content_path(), rkmpp_init_decoder(), rkmpp_retrieve_frame(), rl2_decode_init(), rv34_decoder_alloc(), sap_write_header(), save_subtitle_set(), segment_end(), set_encoder_id(), set_extradata(), set_roi_encode_ctrl(), speex_header(), stream_open(), strftime_expand(), svc_encode_init(), svq1_encode_init(), svq1_encode_plane(), svq3_decode_init(), swr_alloc(), swri_rematrix_init(), sws_alloc_context(), tgv_decode_frame(), theora_header(), tm2_build_huff_table(), ttml_write_header_content(), update_block_buffers(), update_dimensions(), update_variant_stream_info(), url_alloc_for_protocol(), url_open_dyn_buf_internal(), utvideo_encode_init(), v4l2_get_device_list(), vaapi_device_create(), vaapi_device_derive(), vaapi_encode_alloc(), vaapi_encode_issue(), var_size_bme(), vc1_decode_frame(), vc1_decode_init(), vc2_encode_init(), videostream_cb(), vorbis_header(), vorbis_parse_setup_hdr_codebooks(), vorbis_parse_setup_hdr_floors(), vorbis_parse_setup_hdr_mappings(), vorbis_parse_setup_hdr_modes(), vorbis_parse_setup_hdr_residues(), vorbis_update_metadata(), vp9_raw_reorder_filter(), vqa_decode_init(), vtenc_send_frame(), vulkan_frames_init(), vulkan_map_frame_to_mem(), wmv2_encode_init(), wrap_texture_buf(), wrapped_avframe_encode(), write_packet(), write_uncoded_frame_internal(), writer_open(), wtvfile_open_sector(), wv_alloc_frame_context(), X264_frame(), and X264_init().

◆ av_malloc_array()

void* av_malloc_array	(	size_t	nmemb,
		size_t	size
	)

Definition at line 207 of file mem.c.

◆ av_calloc()

void* av_calloc	(	size_t	nmemb,
		size_t	size
	)

Allocate a memory block for an array with av_mallocz().

The allocated memory will have size size * nmemb bytes.

Parameters

nmemb	Number of elements
size	Size of the single element

Returns: Pointer to the allocated block, or NULL if the block cannot be allocated

See also: av_mallocz(); av_malloc_array()

◆ av_mallocz_array()

void attribute_deprecated void* av_mallocz_array	(	size_t	nmemb,
		size_t	size
	)

Deprecated:: use av_calloc()

◆ av_realloc()

void attribute_deprecated void void* av_realloc	(	void *	ptr,
		size_t	size
	)

Allocate, reallocate, or free a block of memory.

If ptr is NULL and size > 0, allocate a new block. Otherwise, expand or shrink that block of memory according to size.

Parameters

ptr	Pointer to a memory block already allocated with av_realloc() or `NULL`
size	Size in bytes of the memory block to be allocated or reallocated

Returns: Pointer to a newly-reallocated block or NULL if the block cannot be reallocated

Warning: Unlike av_malloc(), the returned pointer is not guaranteed to be correctly aligned. The returned pointer must be freed after even if size is zero.

See also: av_fast_realloc(); av_reallocp()

Definition at line 153 of file mem.c.

◆ av_reallocp()

av_warn_unused_result int av_reallocp	(	void *	ptr,
		size_t	size
	)

Allocate, reallocate, or free a block of memory through a pointer to a pointer.

If *ptr is NULL and size > 0, allocate a new block. If size is zero, free the memory block pointed to by *ptr. Otherwise, expand or shrink that block of memory according to size.

Parameters

[in,out]	ptr	Pointer to a pointer to a memory block already allocated with av_realloc(), or a pointer to `NULL`. The pointer is updated on success, or freed on failure.
[in]	size	Size in bytes for the memory block to be allocated or reallocated

Returns: Zero on success, an AVERROR error code on failure

Warning: Unlike av_malloc(), the allocated memory is not guaranteed to be correctly aligned.

Definition at line 186 of file mem.c.

Referenced by aom_init(), append_flv_data(), asfrtp_parse_packet(), auxiliary_info_alloc_size(), av_probe_input_buffer2(), av_vdpau_bind_context(), avi_read_header(), bmv_read_packet(), cbs_h2645_assemble_fragment(), cbs_write_unit_data(), concatenate_packet(), decode_frame(), dxv_decode(), dyn_buf_write(), ff_els_decode_unsigned(), ff_lzf_uncompress(), ff_opencl_filter_load_program_from_file(), fixup_vorbis_headers(), flashsv_decode_frame(), g2m_load_cursor(), get_tcp_server_response(), h264_extradata_to_annexb(), handle_metadata(), hap_decode(), hevc_extradata_to_annexb(), http_open(), jpg_decode_data(), mov_cenc_end_packet(), mov_realloc_extradata(), omx_encode_frame(), omx_encode_init(), parse_icy(), qt_rtp_parse_packet(), queue_frames(), rdt_parse_sdp_line(), realloc_buffer(), rtmp_http_write(), rtmp_open(), rtmp_write(), set_segment_filename(), tdsc_decode_frame(), tdsc_decode_tiles(), tdsc_init(), tdsc_load_cursor(), tgv_decode_inter(), theora_header(), tls_client_handshake_loop(), tls_read(), and vpx_init().

◆ av_realloc_f()

void* av_realloc_f	(	void *	ptr,
		size_t	nelem,
		size_t	elsize
	)

Allocate, reallocate, or free a block of memory.

This function does the same thing as av_realloc(), except:

It takes two size arguments and allocates nelem * elsize bytes, after checking the result of the multiplication for integer overflow.
It frees the input block in case of failure, thus avoiding the memory leak with the classic
buf = realloc(buf);

if (!buf)

return -1;

pattern.

Definition at line 171 of file mem.c.

Referenced by av_reallocp_array().

◆ av_realloc_array()

void* av_realloc_array	(	void *	ptr,
		size_t	nmemb,
		size_t	size
	)

Definition at line 225 of file mem.c.

Referenced by add_serial_pair(), append_pad(), av_dict_set(), av_fifo_alloc2(), av_fifo_alloc_array(), av_fifo_grow2(), av_program_add_stream_index(), av_stream_add_side_data(), avfilter_graph_alloc_filter(), avformat_new_stream(), decode_nal_sei_user_data_unregistered(), decode_styl(), decode_unregistered_user_data(), decode_video(), ff_add_cpb_side_data(), ff_alsa_extend_reorder_buf(), ff_ass_add_rect2(), ff_cbs_sei_list_add(), ff_framequeue_add(), ff_mov_write_packet(), ff_rtmp_check_alloc_array(), ff_thread_release_buffer(), ff_vaapi_decode_make_slice_buffer(), ff_vk_add_descriptor_set(), ff_vk_add_push_constant(), fill_marker_resource(), filter_frame(), get_preset_file(), grow_array(), handle_file(), handler(), jpeg2000_decode_packet(), log_callback(), mkv_add_cuepoint(), mxf_add_metadata_set(), mxf_read_partition_pack(), new_video_stream(), ogg_new_stream(), open_virtual_track(), parse_imf_asset_map_from_xml_dom(), push_main_audio_sequence(), push_marker_sequence(), realloc_section_array(), sample_queue_push(), tee_open(), update_block_dimensions(), update_frag_index(), vaapi_encode_make_packed_header(), vaapi_encode_make_param_buffer(), vc1_decode_frame(), and xan_decode_frame().

◆ av_reallocp_array()

int av_reallocp_array	(	void *	ptr,
		size_t	nmemb,
		size_t	size
	)

Allocate, reallocate an array through a pointer to a pointer.

If *ptr is NULL and nmemb > 0, allocate a new block.

Parameters

[in,out]	ptr	Pointer to a pointer to a memory block already allocated with av_realloc(), or a pointer to `NULL`. The pointer is updated on success, or freed on failure.
[in]	nmemb	Number of elements
[in]	size	Size of the single element

Returns: Zero on success, an AVERROR error code on failure

Warning: Unlike av_malloc(), the allocated memory is not guaranteed to be correctly aligned. *ptr must be freed after even if nmemb is zero.

Definition at line 233 of file mem.c.

Referenced by add_fragment(), add_program(), add_segment(), add_tracked_method(), allocate_buffers(), ass_split_section(), ff_h2645_extract_rbsp(), ff_h264_update_thread_context(), ff_hap_set_chunk_count(), gem_decode_frame(), gxf_write_map_packet(), gxf_write_packet(), hvcc_array_add_nal_unit(), hw_device_add(), init_tile_data(), mov_add_tfra_entries(), mov_build_index(), mov_read_trex(), mxf_write_packet(), mxf_write_partition(), new_audio_stream(), nut_write_packet(), ogg_restore(), opencl_frames_get_constraints(), parse_adaptation_sets(), parse_strk(), tgv_decode_inter(), tm2_read_stream(), update_context_from_user(), update_index(), and vp56_size_changed().

◆ av_fast_realloc()

void* av_fast_realloc	(	void *	ptr,
		unsigned int *	size,
		size_t	min_size
	)

Reallocate the given buffer if it is not large enough, otherwise do nothing.

If the given buffer is NULL, then a new uninitialized buffer is allocated.

If the given buffer is not large enough, and reallocation fails, NULL is returned and *size is set to 0, but the original buffer is not changed or freed.

A typical use pattern follows:

uint8_t *buf = ...;
uint8_t *new_buf = av_fast_realloc(buf, &current_size, size_needed);
if (!new_buf) {
    // Allocation failed; clean up original buffer
    av_freep(&buf);
    return AVERROR(ENOMEM);
}

Parameters

[in,out]	ptr	Already allocated buffer, or `NULL`
[in,out]	size	Pointer to the size of buffer `ptr`. `*size` is updated to the new allocated size, in particular 0 in case of failure.
[in]	min_size	Desired minimal size of buffer `ptr`

Returns: ptr if the buffer is large enough, a pointer to newly reallocated buffer if the buffer was not large enough, or NULL in case of error

See also: av_realloc(); av_fast_malloc()

Definition at line 505 of file mem.c.

Referenced by add_buf_dep_exec_ctx(), add_ctts_entry(), add_index_entry(), avc_parse_nal_units(), caf_write_packet(), config_output(), decode_frame(), dirac_combine_frame(), draw_items(), dxva2_av1_decode_slice(), ff_add_index_entry(), ff_af_queue_add(), ff_av1_packet_split(), ff_combine_frame(), ff_h2645_packet_split(), ff_mms_asf_header_parser(), ff_nvdec_simple_decode_slice(), ff_range_add(), ff_subtitles_queue_insert(), ff_tx_init_subtx(), ff_vdpau_add_buffer(), ff_videotoolbox_buffer_copy(), ff_vk_add_dep_exec_ctx(), ff_vk_add_exec_dep(), ff_vk_map_buffers(), ff_vk_unmap_buffers(), filter_frame(), flac_fifo_read_wrap(), get_stats(), init(), intercept_id3(), libx265_encode_frame(), mov_build_index(), mov_parse_auxiliary_info(), mov_read_ctts(), mov_read_pssh(), mov_read_saio(), mov_read_senc(), mov_read_stts(), mov_read_trun(), mov_text_style_start(), mov_try_read_block(), mxg_update_cache(), nvdec_av1_decode_slice(), nvdec_h264_decode_slice(), nvdec_hevc_decode_slice(), open_track_file_resource(), parse_string(), prepare_sei_data_array(), push_main_audio_sequence(), push_main_image_2d_sequence(), read_frame(), shorten_decode_frame(), spdif_header_eac3(), update_frag_index(), and X264_frame().

◆ av_fast_malloc()

void av_fast_malloc	(	void *	ptr,
		unsigned int *	size,
		size_t	min_size
	)

Allocate a buffer, reusing the given one if large enough.

Contrary to av_fast_realloc(), the current buffer contents might not be preserved and on error the old buffer is freed, thus no special handling to avoid memleaks is necessary.

*ptr is allowed to be NULL, in which case allocation always happens if size_needed is greater than 0.

uint8_t *buf = ...;
av_fast_malloc(&buf, &current_size, size_needed);
if (!buf) {
    // Allocation failed; buf already freed
    return AVERROR(ENOMEM);
}

Parameters

[in,out]	ptr	Pointer to pointer to an already allocated buffer. `*ptr` will be overwritten with pointer to new buffer on success or `NULL` on failure
[in,out]	size	Pointer to the size of buffer `ptr`. `size` is updated to the new allocated size, in particular 0 in case of failure.
[in]	min_size	Desired minimal size of buffer `*ptr`

See also: av_realloc(); av_fast_mallocz()

Definition at line 565 of file mem.c.

Referenced by alloc_scratch_buffers(), allocate_buffers(), ape_decode_frame(), audio_decode_frame(), av_fast_padded_mallocz(), chs_alloc_lsb_band_data(), chs_alloc_msb_band_data(), chs_assemble_freq_bands(), codec_reinit(), crypto_write(), decode_8(), decode_frame(), detect_clips(), do_interpolation(), ff_dca_core_filter_fixed(), ff_mpeg_update_thread_context(), fic_decode_frame(), filter_frame_float(), find_motion(), gif_decode_frame(), gif_read_image(), handle_p_frame_apng(), id3v2_parse(), interpolation(), ljpeg_decode_rgb_scan(), magy_decode_frame(), opus_decode_subpacket(), parse_navi_table(), pmp_packet(), rscc_decode_frame(), scale_internal(), spdif_header_dts4(), spdif_write_packet(), tak_decode_frame(), truemotion1_decode_header(), truemotion1_decode_init(), update_block_dimensions(), update_init_section(), update_md5_sum(), and verify_md5().

◆ av_fast_mallocz()

void av_fast_mallocz	(	void *	ptr,
		unsigned int *	size,
		size_t	min_size
	)

Allocate and clear a buffer, reusing the given one if large enough.

Like av_fast_malloc(), but all newly allocated space is initially cleared. Reused buffer is not cleared.

*ptr is allowed to be NULL, in which case allocation always happens if size_needed is greater than 0.

Parameters

[in,out]	ptr	Pointer to pointer to an already allocated buffer. `*ptr` will be overwritten with pointer to new buffer on success or `NULL` on failure
[in,out]	size	Pointer to the size of buffer `ptr`. `size` is updated to the new allocated size, in particular 0 in case of failure.
[in]	min_size	Desired minimal size of buffer `*ptr`

See also: av_fast_malloc()

Definition at line 570 of file mem.c.

Referenced by alloc_sample_buffer(), alloc_scratch_buffers(), alloc_x96_sample_buffer(), and av_fast_padded_malloc().

◆ av_free()

void av_free ( void * ptr )

Free a memory block which has been allocated with a function of av_malloc() or av_realloc() family.

Parameters

ptr	Pointer to the memory block which should be freed.

Note: ptr = NULL is explicitly allowed.; It is recommended that you use av_freep() instead, to prevent leaving behind dangling pointers.

See also: av_freep()

Definition at line 246 of file mem.c.

Referenced by av_freep(), and av_realloc_f().

◆ av_freep()

void av_freep ( void * ptr )

Free a memory block which has been allocated with a function of av_malloc() or av_realloc() family, and set the pointer pointing to it to NULL.

uint8_t *buf = av_malloc(16);
av_free(buf);
// buf now contains a dangling pointer to freed memory, and accidental
// dereference of buf will result in a use-after-free, which may be a
// security risk.
 
uint8_t *buf = av_malloc(16);
av_freep(&buf);
// buf is now NULL, and accidental dereference will only result in a
// NULL-pointer dereference.

Parameters

ptr	Pointer to the pointer to the memory block which should be freed

Note: *ptr = NULL is safe and leads to no action.

See also: av_free()

Definition at line 255 of file mem.c.

Referenced by av_dynarray2_add(), av_dynarray_add(), av_reallocp(), and fast_malloc().

◆ av_strdup()

char* av_strdup ( const char * s )

Duplicate a string.

Parameters

s	String to be duplicated

Returns: Pointer to a newly-allocated string containing a copy of s or NULL if the string cannot be allocated

See also: av_strndup()

Definition at line 280 of file mem.c.

Referenced by add_input_streams(), add_tracked_method(), ass_decode_frame(), av_append_path_component(), av_channel_layout_from_string(), av_dict_get_string(), av_dict_set(), av_opt_copy(), av_opt_get(), avfilter_graph_parse(), avfilter_graph_queue_command(), avformat_alloc_output_context2(), avformat_open_input(), avpriv_tempfile(), caca_write_header(), check_extensions(), check_validation_layers(), cine_read_header(), config_input(), config_output(), config_params(), configure_filtergraph(), curves_init(), dash_init(), delimited_dict_parse(), describe_filter_link(), draw_curves(), ff_alsa_get_device_list(), ff_boxblur_eval_filter_params(), ff_copy_whiteblacklists(), ff_decklink_list_devices(), ff_fbdev_get_device_list(), ff_filter_alloc(), ff_http_do_new_request2(), ff_http_match_no_proxy(), ff_img_read_header(), ff_jni_jstring_to_utf_chars(), ff_mkdir_p(), ff_tls_open_underlying(), ffio_fdopen(), ffurl_connect(), format_name(), ftp_connect(), ftp_current_dir(), ftp_parse_entry_mlsd(), ftp_parse_entry_nlst(), geq_init(), get_cookies(), get_current_fragment(), get_geokey_val(), get_opt_flags_string(), get_ost_filters(), getenv_dup(), grab_read_header(), hls_delete_old_segments(), hls_init(), hls_mux_init(), hls_read_header(), hls_rename_temp_file(), hls_start(), hls_write_packet(), hls_write_trailer(), http_open(), http_open_cnx(), http_seek_internal(), icecast_open(), imf_read_header(), init(), init_filter(), init_filters(), init_muxer(), initialize(), lavfi_read_header(), libsmbc_read_dir(), libsrt_open(), libssh_read_dir(), log_callback(), main(), match_stream_specifier(), mkv_write_simpletag(), mmsh_open_internal(), mpjpeg_read_packet(), mtv_read_header(), new_audio_stream(), new_init_section(), new_output_stream(), new_video_stream(), noise_init(), nppscale_parse_expr(), open_camera(), open_input_file(), open_output_file(), open_slave(), opengl_write_header(), opt_filter_complex(), opt_filter_threads(), opt_map(), opt_map_channel(), opt_sdp_file(), opt_vstats_file(), param_init(), parse_assetmap(), parse_cc_stream_mapstring(), parse_channel_expressions(), parse_device_name(), parse_fmtp(), parse_imf_asset_map_from_xml_dom(), parse_location(), parse_manifest(), parse_manifest_representation(), parse_options(), parse_playlist(), parse_psfile(), parse_read_interval(), parse_read_intervals(), parse_set_cookie(), parse_speaker_pos(), parse_times(), parse_variant_stream_mapstring(), parse_video_var(), plot_freqs(), process_command(), process_line(), pulse_add_detected_device(), pulse_server_info_cb(), qsv_decode_init(), qsv_enc_init(), read_channels(), read_classify_label_file(), read_custom_noise(), read_detect_label_file(), read_gains(), read_header(), read_tf_coefficients(), read_ttag(), read_zp_coefficients(), realtext_read_header(), rfc4175_parse_fmtp(), rtmp_http_open(), rtp_open(), sami_paragraph_to_ass(), sap_read_header(), sap_write_header(), scale_parse_expr(), sdl2_write_header(), segment_end(), set_enable_expr(), set_expr(), set_options(), set_segment_filename(), set_string(), show_help(), sls_flags_filename_process(), stream_open(), udp_open(), update_master_pl_info(), v4l2_get_device_list(), validate_name(), write_option(), xcbgrab_read_header(), and xv_write_header().

◆ av_strndup()

char* av_strndup	(	const char *	s,
		size_t	len
	)

Duplicate a substring of a string.

Parameters

s	String to be duplicated
len	Maximum length of the resulting string (not counting the terminating byte)

Returns: Pointer to a newly-allocated string containing a substring of s or NULL if the string cannot be allocated

Definition at line 292 of file mem.c.

Referenced by hw_device_init_from_string(), libsrt_open(), match_stream_specifier(), mpjpeg_get_boundary(), parse_adaptation_sets(), parse_cookie(), and process_line().

◆ av_memdup()

void* av_memdup	(	const void *	p,
		size_t	size
	)

Duplicate a buffer with av_malloc().

Parameters

p	Buffer to be duplicated
size	Size in bytes of the buffer copied

Returns: Pointer to a newly allocated buffer containing a copy of p or NULL if the buffer cannot be allocated

Definition at line 312 of file mem.c.

Referenced by av_bprint_finalize(), av_opt_copy(), cbs_clone_unit_content(), compute_chapters_end(), dnxhd_encode_init(), dvbsub_parse_clut_segment(), ff_dnn_load_layer_math_binary(), ff_filter_alloc(), ff_get_format(), ff_mpv_init_duplicate_contexts(), ff_stream_side_data_copy(), g723_1_encode_frame(), ifilter_parameters_from_frame(), init_thread(), libdav1d_receive_frame(), LLVMFuzzerTestOneInput(), mpegts_set_stream_info(), parse_header(), prepare_sei_data_array(), save_subtitle_set(), set_aes_arg(), vorbis_header(), and X264_frame().

◆ av_memcpy_backptr()

void av_memcpy_backptr	(	uint8_t *	dst,
		int	back,
		int	cnt
	)

Overlapping memcpy() implementation.

Parameters

dst	Destination buffer
back	Number of bytes back to start copying (i.e. the initial size of the overlapping window); must be > 0
cnt	Number of bytes to copy; must be >= 0

Note: cnt > back is valid, this will copy the bytes we just copied, thus creating a repeating pattern with a period length of back.

Definition at line 455 of file mem.c.

Referenced by copy_backptr(), decode_dsw1(), decode_frame(), decode_tsw1(), ff_color_frame(), ff_lzf_uncompress(), fill_frame(), generate_missing_ref(), memset_bytes(), mszh_decomp(), picmemset(), qsv_fill_border(), residual_interp(), synth_block_fcb_acb(), unpack(), and xan_unpack().