block_id.hpp

Go to the documentation of this file.

// Copyright 2014 Ettus Research LLC
// Copyright 2018 Ettus Research, a National Instruments Company
// Copyright 2019 Ettus Research, a National Instruments Company
//
// SPDX-License-Identifier: GPL-3.0-or-later
//
 
#pragma once
 
#include <uhd/config.hpp>
#include <stdint.h>
#include <iostream>
#include <memory>
#include <string>
 
namespace uhd {
struct fs_path;
 
namespace rfnoc {

class UHD_API block_id_t
{
public:
    block_id_t();
    block_id_t(const std::string& block_str);
    block_id_t(const size_t device_no,
        const std::string& block_name,
        const size_t block_ctr = 0);

    std::string to_string() const;

    static bool is_valid_blockname(const std::string& block_name);

    static bool is_valid_block_id(const std::string& block_id);

    bool match(const std::string& block_str);
 
    // Getters

    std::string get() const
    {
        return to_string();
    };

    std::string get_local() const;

    uhd::fs_path get_tree_root() const;

    size_t get_device_no() const
    {
        return _device_no;
    };

    size_t get_block_count() const
    {
        return _block_ctr;
    };

    std::string get_block_name() const
    {
        return _block_name;
    };
 
    // Setters

    bool set(const std::string& new_name);

    bool set(const size_t device_no,
        const std::string& block_name,
        const size_t block_ctr = 0);

    void set_device_no(size_t device_no)
    {
        _device_no = device_no;
    };

    bool set_block_name(const std::string& block_name);

    void set_block_count(size_t count)
    {
        _block_ctr = count;
    };
 
    // Overloaded operators

    block_id_t operator=(const std::string& new_name)
    {
        set(new_name);
        return *this;
    }
 
    bool operator==(const block_id_t& block_id) const
    {
        return (_device_no == block_id.get_device_no())
               and (_block_name == block_id.get_block_name())
               and (_block_ctr == block_id.get_block_count());
    }
 
    bool operator!=(const block_id_t& block_id) const
    {
        return not(*this == block_id);
    }
 
    bool operator<(const block_id_t& block_id) const
    {
        return (_device_no < block_id.get_device_no()
                or (_device_no == block_id.get_device_no()
                    and _block_name < block_id.get_block_name())
                or (_device_no == block_id.get_device_no()
                    and _block_name == block_id.get_block_name()
                    and _block_ctr < block_id.get_block_count()));
    }
 
    bool operator>(const block_id_t& block_id) const
    {
        return (_device_no > block_id.get_device_no()
                or (_device_no == block_id.get_device_no()
                    and _block_name > block_id.get_block_name())
                or (_device_no == block_id.get_device_no()
                    and _block_name == block_id.get_block_name()
                    and _block_ctr > block_id.get_block_count()));
    }

    bool operator==(const std::string& block_id_str) const
    {
        return get() == block_id_str;
    }

    bool operator==(const char* block_id_str) const
    {
        std::string comp = std::string(block_id_str);
        return *this == comp;
    }

    operator std::string() const
    {
        return to_string();
    }

    block_id_t operator++()
    {
        _block_ctr++;
        return *this;
    }

    block_id_t operator++(int)
    {
        _block_ctr++;
        return *this;
    }
 
private:
    size_t _device_no;
    std::string _block_name;
    size_t _block_ctr;
};

inline std::ostream& operator<<(std::ostream& out, block_id_t block_id)
{
    out << block_id.to_string();
    return out;
}
 
} // namespace rfnoc
} // namespace uhd