FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Macros | Functions
hash.h File Reference
#include <stdint.h>

Go to the source code of this file.

Macros

#define AV_HASH_MAX_SIZE   64
 Maximum value that av_hash_get_size will currently return. More...
 

Functions

int av_hash_alloc (struct AVHashContext **ctx, const char *name)
 Allocate a hash context for the algorithm specified by name. More...
 
const char * av_hash_names (int i)
 Get the names of available hash algorithms. More...
 
const char * av_hash_get_name (const struct AVHashContext *ctx)
 Get the name of the algorithm corresponding to the given hash context. More...
 
int av_hash_get_size (const struct AVHashContext *ctx)
 Get the size of the resulting hash value in bytes. More...
 
void av_hash_init (struct AVHashContext *ctx)
 Initialize or reset a hash context. More...
 
void av_hash_update (struct AVHashContext *ctx, const uint8_t *src, int len)
 Update a hash context with additional data. More...
 
void av_hash_final (struct AVHashContext *ctx, uint8_t *dst)
 Finalize a hash context and compute the actual hash value. More...
 
void av_hash_final_bin (struct AVHashContext *ctx, uint8_t *dst, int size)
 Finalize a hash context and compute the actual hash value. More...
 
void av_hash_final_hex (struct AVHashContext *ctx, uint8_t *dst, int size)
 Finalize a hash context and compute the actual hash value as a hex string. More...
 
void av_hash_final_b64 (struct AVHashContext *ctx, uint8_t *dst, int size)
 Finalize a hash context and compute the actual hash value as a base64 string. More...
 
void av_hash_freep (struct AVHashContext **ctx)
 Free hash context. More...
 

Macro Definition Documentation

#define AV_HASH_MAX_SIZE   64

Maximum value that av_hash_get_size will currently return.

You can use this if you absolutely want or need to use static allocation and are fine with not supporting hashes newly added to libavutil without recompilation. Note that you still need to check against av_hash_get_size, adding new hashes with larger sizes will not be considered an ABI change and should not cause your code to overflow a buffer.

Definition at line 61 of file hash.h.

Referenced by av_hash_final_b64(), av_hash_final_bin(), av_hash_final_hex(), finish(), and writer_print_data_hash().

Function Documentation

int av_hash_alloc ( struct AVHashContext **  ctx,
const char *  name 
)

Allocate a hash context for the algorithm specified by name.

Returns
>= 0 for success, a negative error code for failure
Note
The context is not initialized, you must call av_hash_init().

Definition at line 100 of file hash.c.

Referenced by main().

const char* av_hash_names ( int  i)

Get the names of available hash algorithms.

This function can be used to enumerate the algorithms.

Parameters
iindex of the hash algorithm, starting from 0
Returns
a pointer to a static string or NULL if i is out of range

Definition at line 84 of file hash.c.

Referenced by main(), and usage().

const char* av_hash_get_name ( const struct AVHashContext ctx)

Get the name of the algorithm corresponding to the given hash context.

int av_hash_get_size ( const struct AVHashContext ctx)

Get the size of the resulting hash value in bytes.

The pointer passed to av_hash_final have space for at least this many bytes.

void av_hash_init ( struct AVHashContext ctx)

Initialize or reset a hash context.

Definition at line 137 of file hash.c.

Referenced by check(), main(), and writer_print_data_hash().

void av_hash_update ( struct AVHashContext ctx,
const uint8_t src,
int  len 
)

Update a hash context with additional data.

Definition at line 158 of file hash.c.

Referenced by check(), main(), and writer_print_data_hash().

void av_hash_final ( struct AVHashContext ctx,
uint8_t dst 
)

Finalize a hash context and compute the actual hash value.

Definition at line 179 of file hash.c.

Referenced by av_hash_final_b64(), av_hash_final_bin(), and av_hash_final_hex().

void av_hash_final_bin ( struct AVHashContext ctx,
uint8_t dst,
int  size 
)

Finalize a hash context and compute the actual hash value.

If size is smaller than the hash size, the hash is truncated; if size is larger, the buffer is padded with 0.

Definition at line 200 of file hash.c.

Referenced by main().

void av_hash_final_hex ( struct AVHashContext ctx,
uint8_t dst,
int  size 
)

Finalize a hash context and compute the actual hash value as a hex string.

The string is always 0-terminated. If size is smaller than 2 * hash_size + 1, the hex string is truncated.

Definition at line 211 of file hash.c.

Referenced by finish(), main(), and writer_print_data_hash().

void av_hash_final_b64 ( struct AVHashContext ctx,
uint8_t dst,
int  size 
)

Finalize a hash context and compute the actual hash value as a base64 string.

The string is always 0-terminated. If size is smaller than AV_BASE64_SIZE(hash_size), the base64 string is truncated.

Definition at line 221 of file hash.c.

Referenced by finish(), and main().

void av_hash_freep ( struct AVHashContext **  ctx)

Free hash context.

Definition at line 234 of file hash.c.

Referenced by main().