FFmpeg: String Manipulation

FFmpeg

[フレーム]

Macros | Enumerations | Functions

String Manipulation

libavutil

Macros

#define AV_ESCAPE_FLAG_WHITESPACE (1 << 0)

Consider spaces special and escape them even in the middle of the string. More...

#define AV_ESCAPE_FLAG_STRICT (1 << 1)

Escape only specified special characters. More...

#define AV_ESCAPE_FLAG_XML_SINGLE_QUOTES (1 << 2)

Within AV_ESCAPE_MODE_XML, additionally escape single quotes for single quoted attributes. More...

#define AV_ESCAPE_FLAG_XML_DOUBLE_QUOTES (1 << 3)

Within AV_ESCAPE_MODE_XML, additionally escape double quotes for double quoted attributes. More...

#define AV_UTF8_FLAG_ACCEPT_INVALID_BIG_CODES 1

accept codepoints over 0x10FFFF More...

#define AV_UTF8_FLAG_ACCEPT_NON_CHARACTERS 2

accept non-characters - 0xFFFE and 0xFFFF More...

#define AV_UTF8_FLAG_ACCEPT_SURROGATES 4

accept UTF-16 surrogates codes More...

#define AV_UTF8_FLAG_EXCLUDE_XML_INVALID_CONTROL_CODES 8

exclude control codes not accepted by XML More...

#define AV_UTF8_FLAG_ACCEPT_ALL AV_UTF8_FLAG_ACCEPT_INVALID_BIG_CODES|AV_UTF8_FLAG_ACCEPT_NON_CHARACTERS|AV_UTF8_FLAG_ACCEPT_SURROGATES

Enumerations

enum AVEscapeMode { AV_ESCAPE_MODE_AUTO, AV_ESCAPE_MODE_BACKSLASH, AV_ESCAPE_MODE_QUOTE, AV_ESCAPE_MODE_XML }

Functions

int av_strstart (const char *str, const char *pfx, const char **ptr)

Return non-zero if pfx is a prefix of str. More...

int av_stristart (const char *str, const char *pfx, const char **ptr)

Return non-zero if pfx is a prefix of str independent of case. More...

char * av_stristr (const char *haystack, const char *needle)

Locate the first case-independent occurrence in the string haystack of the string needle. More...

char * av_strnstr (const char *haystack, const char *needle, size_t hay_length)

Locate the first occurrence of the string needle in the string haystack where not more than hay_length characters are searched. More...

size_t av_strlcpy (char *dst, const char *src, size_t size)

Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst. More...

size_t av_strlcat (char *dst, const char *src, size_t size)

Append the string src to the string dst, but to a total length of no more than size - 1 bytes, and null-terminate dst. More...

size_t av_strlcatf (char *dst, size_t size, const char *fmt,...) av_printf_format(3

Append output to a string, according to a format. More...

size_t static size_t av_strnlen (const char *s, size_t len)

Get the count of continuous non zero chars starting from the beginning. More...

char * av_asprintf (const char *fmt,...) av_printf_format(1

Print arguments following specified format into a large enough auto allocated buffer. More...

char attribute_deprecated char * av_d2str (double d)

Convert a number to an av_malloced string. More...

char * av_get_token (const char **buf, const char *term)

Unescape the given string until a non escaped terminating char, and return the token corresponding to the unescaped string. More...

char * av_strtok (char *s, const char *delim, char **saveptr)

Split the string into several tokens which can be accessed by successive calls to av_strtok(). More...

static av_const int av_isdigit (int c)

Locale-independent conversion of ASCII isdigit. More...

static av_const int av_isgraph (int c)

Locale-independent conversion of ASCII isgraph. More...

static av_const int av_isspace (int c)

Locale-independent conversion of ASCII isspace. More...

static av_const int av_toupper (int c)

Locale-independent conversion of ASCII characters to uppercase. More...

static av_const int av_tolower (int c)

Locale-independent conversion of ASCII characters to lowercase. More...

static av_const int av_isxdigit (int c)

Locale-independent conversion of ASCII isxdigit. More...

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

Locale-independent case-insensitive compare. More...

int av_strncasecmp (const char *a, const char *b, size_t n)

Locale-independent case-insensitive compare. More...

char * av_strireplace (const char *str, const char *from, const char *to)

Locale-independent strings replace. More...

const char * av_basename (const char *path)

Thread safe basename. More...

const char * av_dirname (char *path)

Thread safe dirname. More...

int av_match_name (const char *name, const char *names)

Match instances of a name in a comma-separated list of names. More...

char * av_append_path_component (const char *path, const char *component)

Append path component to the existing path. More...

av_warn_unused_result int av_escape (char **dst, const char *src, const char *special_chars, enum AVEscapeMode mode, int flags)

Escape string in src, and put the escaped string in an allocated string in *dst, which must be freed with av_free(). More...

av_warn_unused_result int av_utf8_decode (int32_t *codep, const uint8_t **bufp, const uint8_t *buf_end, unsigned int flags)

Read and decode a single UTF-8 code point (character) from the buffer in *buf, and update *buf to point to the next byte to decode. More...

int av_match_list (const char *name, const char *list, char separator)

Check if a name is in a list. More...

int av_sscanf (const char *string, const char *format,...)

See libc sscanf manual for more information. More...

Detailed Description

Macro Definition Documentation

◆ AV_ESCAPE_FLAG_WHITESPACE

#define AV_ESCAPE_FLAG_WHITESPACE (1 << 0)

Consider spaces special and escape them even in the middle of the string.

This is equivalent to adding the whitespace characters to the special characters lists, except it is guaranteed to use the exact same list of whitespace characters as the rest of libavutil.

Definition at line 338 of file avstring.h.

◆ AV_ESCAPE_FLAG_STRICT

#define AV_ESCAPE_FLAG_STRICT (1 << 1)

Escape only specified special characters.

Without this flag, escape also any characters that may be considered special by av_get_token(), such as the single quote.

Definition at line 345 of file avstring.h.

◆ AV_ESCAPE_FLAG_XML_SINGLE_QUOTES

#define AV_ESCAPE_FLAG_XML_SINGLE_QUOTES (1 << 2)

Within AV_ESCAPE_MODE_XML, additionally escape single quotes for single quoted attributes.

Definition at line 351 of file avstring.h.

◆ AV_ESCAPE_FLAG_XML_DOUBLE_QUOTES

#define AV_ESCAPE_FLAG_XML_DOUBLE_QUOTES (1 << 3)

Within AV_ESCAPE_MODE_XML, additionally escape double quotes for double quoted attributes.

Definition at line 357 of file avstring.h.

◆ AV_UTF8_FLAG_ACCEPT_INVALID_BIG_CODES

#define AV_UTF8_FLAG_ACCEPT_INVALID_BIG_CODES 1

accept codepoints over 0x10FFFF

Definition at line 380 of file avstring.h.

◆ AV_UTF8_FLAG_ACCEPT_NON_CHARACTERS

#define AV_UTF8_FLAG_ACCEPT_NON_CHARACTERS 2

accept non-characters - 0xFFFE and 0xFFFF

Definition at line 381 of file avstring.h.

◆ AV_UTF8_FLAG_ACCEPT_SURROGATES

#define AV_UTF8_FLAG_ACCEPT_SURROGATES 4

accept UTF-16 surrogates codes

Definition at line 382 of file avstring.h.

◆ AV_UTF8_FLAG_EXCLUDE_XML_INVALID_CONTROL_CODES

#define AV_UTF8_FLAG_EXCLUDE_XML_INVALID_CONTROL_CODES 8

exclude control codes not accepted by XML

Definition at line 383 of file avstring.h.

◆ AV_UTF8_FLAG_ACCEPT_ALL

#define AV_UTF8_FLAG_ACCEPT_ALL AV_UTF8_FLAG_ACCEPT_INVALID_BIG_CODES|AV_UTF8_FLAG_ACCEPT_NON_CHARACTERS|AV_UTF8_FLAG_ACCEPT_SURROGATES

Definition at line 385 of file avstring.h.

Enumeration Type Documentation

◆ AVEscapeMode

enum AVEscapeMode

Enumerator
AV_ESCAPE_MODE_AUTO	Use auto-selected escaping mode.
AV_ESCAPE_MODE_BACKSLASH	Use backslash escaping.
AV_ESCAPE_MODE_QUOTE	Use single-quote escaping.
AV_ESCAPE_MODE_XML	Use XML non-markup character data escaping.

Definition at line 323 of file avstring.h.

Function Documentation

◆ av_strstart()

int av_strstart ( const char * str,

const char * pfx,

const char ** ptr

)

Return non-zero if pfx is a prefix of str.

If it is, *ptr is set to the address of the first character in str after the prefix.

Parameters: str input string

pfx prefix to test

ptr updated if the prefix is matched inside str

Returns: non-zero if the prefix matches, zero otherwise

Definition at line 37 of file avstring.c.

Referenced by add_file(), amr_parse_sdp_line(), asfrtp_parse_sdp_line(), async_open(), av_chroma_location_from_name(), av_color_primaries_from_name(), av_color_range_from_name(), av_color_space_from_name(), av_color_transfer_from_name(), av_spherical_from_name(), av_stereo3d_from_name(), bitstream_switching(), bluray_open(), cache_open(), crypto_open2(), dash_read_tmpl_id(), data_open(), dv_parse_sdp_line(), ff_make_absolute_url2(), ff_real_parse_sdp_a_line(), ff_tls_open_underlying(), ff_wms_parse_sdp_a_line(), file_check(), find_component(), find_option(), get_color_type(), hevc_parse_sdp_line(), hls_open(), http_open_cnx_internal(), id3v2_put_priv(), ilbc_parse_sdp_line(), ishttp(), latm_parse_sdp_line(), main(), md5_close(), mov_read_kind(), open_url(), opt_loglevel(), parse_adaptation_sets(), parse_cc_stream_mapstring(), parse_command_line(), parse_h264_sdp_line(), parse_multipart_header(), parse_playlist(), parse_sdp_line(), parse_variant_stream_mapstring(), rdt_parse_sdp_line(), read_data(), resolve_content_path(), rfc4175_parse_sdp_line(), rtsp_probe(), sap_probe(), subfile_open(), subsegment_alignment(), tee_open(), unix_open(), url_alloc_for_protocol(), url_find_protocol(), v4l2_read_probe(), xiph_parse_sdp_line(), yuv4_read_header(), and zmq_proto_open().

◆ av_stristart()

int av_stristart ( const char * str,

const char * pfx,

const char ** ptr

)

Return non-zero if pfx is a prefix of str independent of case.

If it is, *ptr is set to the address of the first character in str after the prefix.

Parameters: str input string

pfx prefix to test

ptr updated if the prefix is matched inside str

Returns: non-zero if the prefix matches, zero otherwise

Definition at line 48 of file avstring.c.

Referenced by av_stristr(), ff_http_auth_handle_header(), has_header(), mpjpeg_get_boundary(), parse_playlist(), pcm_read_header(), rtsp_parse_range_npt(), and translate_ipfs_to_http().

◆ av_stristr()

char* av_stristr ( const char * haystack,

const char * needle

)

Locate the first case-independent occurrence in the string haystack of the string needle.

A zero-length string needle is considered to match at the start of haystack.

This function is a case-insensitive version of the standard strstr().

Parameters: haystack string to search in

needle string to search for

Returns: pointer to the located match within haystack or a null pointer if no match

Definition at line 59 of file avstring.c.

Referenced by av_strireplace(), av_uuid_urn_parse(), dash_probe(), format_name(), ftp_connect_control_connection(), ftp_has_feature(), get_content_type(), has_header(), hls_delete_old_segments(), hls_init(), log_fmt_map(), mov_parse_uuid_spherical(), mov_read_uuid(), opencl_filter_device(), opencl_filter_platform(), parse_cache_control(), parse_features(), parse_models(), parse_playlist(), pool_method_map(), resolve_content_path(), rpl_read_header(), run_implementation(), sami_paragraph_to_ass(), update_master_pl_info(), validate_name(), and write_codec_attr().

◆ av_strnstr()

char* av_strnstr ( const char * haystack,

const char * needle,

size_t hay_length

)

Locate the first occurrence of the string needle in the string haystack where not more than hay_length characters are searched.

A zero-length string needle is considered to match at the start of haystack.

This function is a length-limited version of the standard strstr().

Parameters: haystack string to search in

needle string to search for

hay_length length of string to search in

Returns: pointer to the located match within haystack or a null pointer if no match

Definition at line 72 of file avstring.c.

Referenced by write_manifest().

◆ av_strlcpy()

size_t av_strlcpy ( char * dst,

const char * src,

size_t size

)

Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst.

This function is the same as BSD strlcpy().

Parameters: dst destination buffer

src source string

size size of destination buffer

Returns: the length of src

Warning: since the return value is the length of src, src absolutely must be a properly 0-terminated string, otherwise this will read beyond the end of the buffer and possibly crash.

Definition at line 86 of file avstring.c.

Referenced by aa_read_header(), add_fragment(), add_segment(), amf_parse_object(), append_postfix(), asf_read_language_list(), ass_encode_frame(), av_append_path_component(), av_channel_layout_from_string(), av_channel_layout_index_from_string(), av_parse_color(), av_pix_fmt_swap_endianness(), av_strerror(), av_strlcat(), av_url_split(), choose_qop(), create_filter(), dash_init(), dash_read_tmpl_id(), decode_frame(), dnn_classify_post_proc(), dnn_detect_post_proc_ov(), dnn_detect_post_proc_tf(), do_encrypt(), dprint_options(), dump_metadata(), export(), ff_dash_fill_tmpl_params(), ff_htmlmarkup_to_ass(), ff_img_read_header(), ff_img_read_packet(), ff_rtsp_setup_output_streams(), find_component(), find_compressor(), get_content_url(), get_preset_file(), handle_connect_error(), hls_append_segment(), hls_init(), hls_open(), hls_start(), id3v1_create_tag(), id3v1_set_string(), id3v2_3_metadata_split_date(), librist_open(), libssh_connect(), LLVMFuzzerTestOneInput(), main(), merge_date(), mmsh_open_internal(), omx_component_init(), open_input(), opt_default(), opt_preset(), opt_streamid(), parse_command(), parse_command_line(), parse_playlist(), parse_sws_flags(), pp_get_mode_by_name_and_quality(), resolve_content_path(), rpl_read_header(), rtmp_open(), rtp_open(), sap_read_header(), sap_write_header(), set_codec_str(), set_encoder_id(), set_vp9_codec_str(), show_help_options(), sls_flag_use_localtime_filename(), ttml_encode_frame(), unix_open(), url_find_protocol(), write_header(), write_manifest(), and write_packet().

◆ av_strlcat()

size_t av_strlcat ( char * dst,

const char * src,

size_t size

)

Append the string src to the string dst, but to a total length of no more than size - 1 bytes, and null-terminate dst.

This function is similar to BSD strlcat(), but differs when size <= strlen(dst).

Parameters: dst destination buffer

src source string

size size of destination buffer

Returns: the total length of src and dst

Warning: since the return value use the length of src and dst, these absolutely must be a properly 0-terminated strings, otherwise this will read beyond the end of the buffer and possibly crash.

Definition at line 96 of file avstring.c.

Referenced by append_postfix(), av_dict_set(), av_printf_format(), dnn_classify_post_proc(), do_encrypt(), ff_http_auth_create_response(), ff_rtsp_setup_input_streams(), ff_url_join(), mmsh_open_internal(), mov_open_dref(), mov_rewrite_dvd_sub_extradata(), mov_write_isml_manifest(), resolve_content_path(), rtmp_open(), rtsp_read_packet(), rtsp_send_reply(), set_encoder_id(), show_help_options(), trace_headers(), and write_manifest().

◆ av_strlcatf()

size_t av_strlcatf ( char * dst,

size_t size,

const char * fmt,

...

)

Append output to a string, according to a format.

Never write out of the destination buffer, and always put a terminating 0 within the buffer.

Parameters: dst destination buffer (string to which the output is appended)

size total size of the destination buffer

fmt printf-compatible format string, specifying how the following parameters are used

Returns: the length of the string that would have been generated if enough space had been available

◆ av_strnlen()

size_t static size_t av_strnlen ( const char * s,

size_t len

)

inlinestatic

Get the count of continuous non zero chars starting from the beginning.

Parameters: len maximum number of characters to check in the string, that is the maximum value which is returned by the function

Definition at line 141 of file avstring.h.

Referenced by print_file(), ttml_set_header_values_from_extradata(), and wc3_read_packet().

◆ av_asprintf()

char* av_asprintf ( const char * fmt,

...

)

Print arguments following specified format into a large enough auto allocated buffer.

It is similar to GNU asprintf().

Parameters: fmt printf-compatible format string, specifying how the following parameters are used.

Returns: the allocated string

Note: You have to free the string yourself with av_free().

◆ av_d2str()

char attribute_deprecated char* av_d2str ( double d )

Convert a number to an av_malloced string.

Deprecated:: use av_asprintf() with "%f" or a more specific format

Definition at line 143 of file avstring.c.

◆ av_get_token()

char* av_get_token ( const char ** buf,

const char * term

)

Unescape the given string until a non escaped terminating char, and return the token corresponding to the unescaped string.

The normal \ and ' escaping is supported. Leading and trailing whitespaces are removed, unless they are escaped with '\' or are enclosed between ''.

Parameters: buf the buffer to parse, buf will be updated to point to the terminating char

term a 0-terminated list of terminating chars

Returns: the malloced unescaped string, which must be av_freed by the user, NULL in case of allocation failure

Definition at line 154 of file avstring.c.

Referenced by av_bsf_list_parse_str(), av_opt_get_key_value(), concat_parse_script(), dilate_init(), expand_function(), ip_parse_addr_list(), main(), open_output_file(), opt_map(), opt_show_entries(), parse_command(), parse_filter(), parse_interval(), parse_key_value_pair(), parse_link_name(), qsv_load_plugins(), rtp_open(), separate_output_names(), set_params(), tee_open(), and tee_write_header().

◆ av_strtok()

char* av_strtok ( char * s,

const char * delim,

char ** saveptr

)

Split the string into several tokens which can be accessed by successive calls to av_strtok().

A token is defined as a sequence of characters not belonging to the set specified in delim.

On the first call to av_strtok(), s should point to the string to parse, and the value of saveptr is ignored. In subsequent calls, s should be NULL, and saveptr should be unchanged since the previous call.

This function is similar to strtok_r() defined in POSIX.1.

Parameters: s the string to parse, may be NULL

delim 0-terminated list of token delimiters, must be non-NULL

saveptr user-provided pointer which points to stored information necessary for av_strtok() to continue scanning the same string. saveptr is updated to point to the next character after the first delimiter found, or to NULL if the string was terminated

Returns: the found token, or NULL when no token is found

Definition at line 189 of file avstring.c.

Referenced by bsf_parse_single(), check_extensions(), check_validation_layers(), config_input(), config_output(), convolution_opencl_make_filter_params(), delimited_dict_parse(), draw_curves(), fill_items(), frei0r_init(), ftp_parse_entry_mlsd(), ftp_passive_mode(), get_cookies(), get_Fragment(), imf_read_header(), init(), libssh_connect(), main(), movie_common_init(), new_rendition(), open_slave(), opt_preset(), param_init(), parse_cc_stream_mapstring(), parse_channel_expressions(), parse_delays(), parse_device_name(), parse_gains(), parse_interval(), parse_layer_rates(), parse_map(), parse_models(), parse_points(), parse_set_cookie(), parse_speaker_pos(), parse_times(), parse_variant_stream_mapstring(), parse_weights(), plot_freqs(), pp_get_mode_by_name_and_quality(), read_channels(), read_custom_noise(), read_gains(), read_tf_coefficients(), read_zp_coefficients(), resolve_content_path(), sami_paragraph_to_ass(), scc_read_header(), and vp8_ts_parse_int_array().

◆ av_isdigit()

static av_const int av_isdigit ( int c )

inlinestatic

Locale-independent conversion of ASCII isdigit.

Definition at line 211 of file avstring.h.

Referenced by av_get_frame_filename2(), av_isxdigit(), av_parse_time(), channelmap_init(), cmp_func_names(), dash_read_tmpl_id(), date_get_num(), ff_vfscanf(), func_strftime(), init(), parse_adaptation_sets(), parse_value(), parse_variant_stream_mapstring(), replace_int_data_in_filename(), and scanbraces().

◆ av_isgraph()

static av_const int av_isgraph ( int c )

inlinestatic

Locale-independent conversion of ASCII isgraph.

Definition at line 219 of file avstring.h.

Referenced by init_pattern_from_file(), init_pattern_from_string(), and read_shape_from_file().

◆ av_isspace()

static av_const int av_isspace ( int c )

inlinestatic

Locale-independent conversion of ASCII isspace.

Definition at line 227 of file avstring.h.

Referenced by av_expr_parse(), av_parse_time(), av_small_strptime(), avpriv_strtod(), choose_qop(), ff_dvdsub_parse_palette(), ff_get_chomp_line(), ff_parse_key_value(), ff_smil_get_attr_ptr(), ff_vfscanf(), fffloatscan(), ffintscan(), fget_next_word(), mpjpeg_get_boundary(), process_line(), rt_event_to_ass(), rtmp_http_open(), sami_paragraph_to_ass(), skip_line(), split_tag_value(), and trim_right().

◆ av_toupper()

static av_const int av_toupper ( int c )

inlinestatic

Locale-independent conversion of ASCII characters to uppercase.

Definition at line 236 of file avstring.h.

Referenced by av_dict_get(), av_stristart(), ff_hex_to_data(), ff_toupper4(), get_jss_cmd(), hex_to_data(), jacosub_to_ass(), read_yesno(), and upcase_string().

◆ av_tolower()

static av_const int av_tolower ( int c )

inlinestatic

Locale-independent conversion of ASCII characters to lowercase.

Definition at line 246 of file avstring.h.

Referenced by av_isxdigit(), av_strcasecmp(), av_strncasecmp(), ff_htmlmarkup_to_ass(), ff_urldecode(), h264_metadata_init(), microdvd_init(), subviewer_read_header(), and xdigit_to_int().

◆ av_isxdigit()

static av_const int av_isxdigit ( int c )

inlinestatic

Locale-independent conversion of ASCII isxdigit.

Definition at line 256 of file avstring.h.

Referenced by bprint_escaped_path(), ff_urldecode(), h264_metadata_init(), and id3v2_put_priv().

◆ av_strcasecmp()

int av_strcasecmp ( const char * a,

const char * b

)

Locale-independent case-insensitive compare.

Note: This means only ASCII-range characters are case-insensitive

Definition at line 218 of file avstring.c.

Referenced by av_hash_alloc(), av_parse_color(), av_parse_time(), avi_metadata_creation_time(), color_table_compare(), create_master_playlist(), decode_header(), decode_info_header(), ff_AMediaCodecList_getCodecNameByType(), ff_htmlmarkup_to_ass(), ff_http_auth_handle_header(), ff_id3v2_write_apic(), ff_img_read_header(), ff_is_http_proto(), ff_metadata_conv(), ff_rtp_codec_id(), ff_rtp_handler_find_by_name(), find_child_node_by_name(), find_latency(), find_segment_by_filename(), flac_write_picture(), ftp_parse_entry_mlsd(), get_cookies(), hls_delete_file(), hls_init(), hls_window(), hls_write_header(), id3v1_create_tag(), id3v2_3_metadata_split_date(), is_common_init_section_exist(), mkv_check_tag_name(), nist_read_header(), ogm_chapter(), opt_show_optional_fields(), parse_and_set_vsync(), parse_fmtp(), parse_imf_asset_map_from_xml_dom(), parse_manifest(), parse_manifest_adaptationset(), parse_manifest_representation(), parse_manifest_segmenttimeline(), parse_manifest_segmenturlnode(), parse_multipart_header(), parse_programinformation(), parse_slave_failure_policy_option(), process_line(), resolve_content_path(), str2id(), v4l2_set_parameters(), vorbis_parse_single_comment(), and write_header().

◆ av_strncasecmp()

int av_strncasecmp ( const char * a,

const char * b,

size_t n

)

Locale-independent case-insensitive compare.

Note: This means only ASCII-range characters are case-insensitive

Definition at line 228 of file avstring.c.

Referenced by av_match_name(), avpriv_strtod(), data_open(), date_get_month(), extract_lltask_from_task(), ff_htmlmarkup_to_ass(), ff_mkdir_p(), ff_smil_get_attr_ptr(), get_cookies(), get_relative_url(), jacosub_read_header(), mcc_read_header(), new_init_section(), nist_read_header(), ogm_chapter(), parse_content_encoding(), parse_id3(), parse_playlist(), parse_variant_stream_mapstring(), process_line(), read_apic(), realtext_probe(), realtext_read_header(), resolve_content_path(), rt_event_to_ass(), sami_paragraph_to_ass(), sami_read_header(), and scc_read_header().

◆ av_strireplace()

char* av_strireplace ( const char * str,

const char * from,

const char * to

)

Locale-independent strings replace.

Note: This means only ASCII-range characters are replace

Definition at line 240 of file avstring.c.

Referenced by dash_init(), get_content_url(), and get_current_fragment().

◆ av_basename()

const char* av_basename ( const char * path )

Thread safe basename.

Parameters: path the string to parse, on DOS both \ and / are considered separators.

Returns: pointer to the basename substring. If path does not contain a slash, the function returns a copy of path. If path is a NULL pointer or points to an empty string, a pointer to a string "." is returned.

Definition at line 263 of file avstring.c.

Referenced by add_filename_as_pkt_side_data(), hls_append_segment(), set_segment_filename(), update_master_pl_info(), validate_name(), and write_manifest().

◆ av_dirname()

const char* av_dirname ( char * path )

Thread safe dirname.

Parameters: path the string to parse, on DOS both \ and / are considered separators.

Returns: A pointer to a string that's the parent directory of path. If path is a NULL pointer or points to an empty string, a pointer to a string "." is returned.

Note: the function may modify the contents of the path, so copies should be passed.

Definition at line 286 of file avstring.c.

Referenced by format_name(), hls_delete_old_segments(), hls_start(), imf_read_header(), parse_assetmap(), update_master_pl_info(), and validate_name().

◆ av_match_name()

int av_match_name ( const char * name,

const char * names

)

Match instances of a name in a comma-separated list of names.

List entries are checked from the start to the end of the names list, the first match ends further processing. If an entry prefixed with '-' matches, then 0 is returned. The "ALL" list entry is considered to match all names.

Parameters: name Name to look for.

names List of names.

Returns: 1 on match, 0 otherwise.

Definition at line 356 of file avstring.c.

Referenced by av_find_input_format(), av_guess_codec(), av_guess_format(), av_match_ext(), av_probe_input_format3(), avformat_transfer_internal_stream_timing_info(), ffurl_get_protocols(), get_pix_fmt_internal(), parse_slave_fifo_policy(), and set_string_bool().

◆ av_append_path_component()

char* av_append_path_component ( const char * path,

const char * component

)

Append path component to the existing path.

Path separator '/' is placed between when needed. Resulting string have to be freed with av_free().

Parameters: path base path

component component to be appended

Returns: new path or NULL on error.

Definition at line 307 of file avstring.c.

Referenced by ftp_connect(), imf_read_header(), libsmbc_read_dir(), parse_imf_asset_map_from_xml_dom(), and update_master_pl_info().

◆ av_escape()

av_warn_unused_result int av_escape ( char ** dst,

const char * src,

const char * special_chars,

enum AVEscapeMode mode,

int flags

)

Escape string in src, and put the escaped string in an allocated string in *dst, which must be freed with av_free().

Parameters: dst pointer where an allocated string is put

src string to escape, must be non-NULL

special_chars string containing the special characters which need to be escaped, can be NULL

mode escape 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.

flags flags which control how to escape, see AV_ESCAPE_FLAG_ macros

Returns: the length of the allocated string, or a negative error code in case of error

See also: av_bprint_escape()

Definition at line 338 of file avstring.c.

Referenced by main(), and segment_list_print_entry().

◆ av_utf8_decode()

av_warn_unused_result int av_utf8_decode ( int32_t * codep,

const uint8_t ** bufp,

const uint8_t * buf_end,

unsigned int flags

)

Read and decode a single UTF-8 code point (character) from the buffer in *buf, and update *buf to point to the next byte to decode.

In case of an invalid byte sequence, the pointer will be updated to the next byte after the invalid sequence and the function will return an error code.

Depending on the specified flags, the function will also fail in case the decoded code point does not belong to a valid range.

Note: For speed-relevant code a carefully implemented use of GET_UTF8() may be preferred.

Parameters: codep pointer used to return the parsed code in case of success. The value in *codep is set even in case the range check fails.

bufp pointer to the address the first byte of the sequence to decode, updated by the function to point to the byte next after the decoded sequence

buf_end pointer to the end of the buffer, points to the next byte past the last in the buffer. This is used to avoid buffer overreads (in case of an unfinished UTF-8 sequence towards the end of the buffer).

flags a collection of AV_UTF8_FLAG_* flags

Returns: >= 0 in case a sequence was successfully read, a negative value in case of invalid sequence

Definition at line 379 of file avstring.c.

Referenced by main(), validate_string(), and writer_open().

◆ av_match_list()

int av_match_list ( const char * name,

const char * list,

char separator

)

Check if a name is in a list.

Returns: 0 if not found, or the 1 based index where it has been found in the list.

Definition at line 455 of file avstring.c.

Referenced by avcodec_open2(), avformat_open_input(), ffurl_connect(), and http_should_reconnect().

◆ av_sscanf()

int av_sscanf ( const char * string,

const char * format,

...

)

See libc sscanf manual for more information.

Locale-independent sscanf implementation.

Definition at line 962 of file avsscanf.c.

Referenced by av_channel_layout_from_string(), ff_pnm_decode_header(), fill_items(), filter_frame(), init(), mcc_read_header(), parse_3dl(), parse_channel_name(), parse_cinespace(), parse_cube(), parse_dat(), parse_delays(), parse_gains(), parse_line(), parse_m3d(), parse_speaker_pos(), parse_weights(), process_command(), read_custom_noise(), read_gains(), read_tf_coefficients(), read_zp_coefficients(), scc_read_header(), and vivo_read_header().

Generated on Wed Aug 24 2022 21:42:48 for FFmpeg by doxygen 1.8.17