olaf_db.h

Go to the documentation of this file.

// Olaf: Overly Lightweight Acoustic Fingerprinting
// Copyright (C) 2019-2023  Joren Six
 
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
 
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
 
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
#ifndef OLAF_DB_H
#define OLAF_DB_H
    #include <stdbool.h>
    #include <stdint.h>
    
    typedef struct Olaf_DB Olaf_DB;
 
    Olaf_DB * olaf_db_new(const char * db_file_folder,bool readonly);
 
    void olaf_db_destroy(Olaf_DB * db);
 
 
    typedef struct Olaf_Resource_Meta_data Olaf_Resource_Meta_data;
 
    struct Olaf_Resource_Meta_data{
        float duration;
        long fingerprints;
        char path[512];
    };
 
    void olaf_db_store_meta_data(Olaf_DB * db, uint32_t * key, Olaf_Resource_Meta_data * value);
 
    void olaf_db_find_meta_data(Olaf_DB * db , uint32_t * key, Olaf_Resource_Meta_data * value);
 
    void olaf_db_delete_meta_data(Olaf_DB * db , uint32_t * key);
 
    bool olaf_db_has_meta_data(Olaf_DB * db , uint32_t * key);
 
 
    void olaf_db_stats_meta_data(Olaf_DB * db,bool verbose);
 
    
    //####Finger print methods
 
    void olaf_db_store(Olaf_DB * db, uint64_t * keys, uint64_t * values, size_t size);
 
    void olaf_db_delete(Olaf_DB * db, uint64_t * keys, uint64_t * values, size_t size);
 
    size_t olaf_db_find(Olaf_DB * db,uint64_t start_key,uint64_t stop_key,uint64_t * results, size_t results_size);
 
 
    bool olaf_db_find_single(Olaf_DB * db,uint64_t start_key,uint64_t stop_key);
 
    void olaf_db_stats(Olaf_DB * db,bool verbose);
 
    uint32_t olaf_db_string_hash(const char *key, size_t len);
 
#endif // OLAF_DB_H