ranges.h

Go to the documentation of this file.

//
// Copyright 2015 Ettus Research LLC
// Copyright 2018 Ettus Research, a National Instruments Company
//
// SPDX-License-Identifier: GPL-3.0-or-later
//

#pragma once

#include <uhd/config.h>
#include <uhd/error.h>

#include <stdbool.h>
#include <stdlib.h>

typedef struct
{
    double start;
    double stop;
    double step;
} uhd_range_t;

#ifdef __cplusplus
#    include <uhd/types/ranges.hpp>
#    include <string>

struct uhd_meta_range_t
{
    uhd::meta_range_t meta_range_cpp;
    std::string last_error;
};

extern "C" {
#else
struct uhd_meta_range_t;
#endif


typedef struct uhd_meta_range_t* uhd_meta_range_handle;

UHD_API uhd_error uhd_range_to_pp_string(
    const uhd_range_t* range, char* pp_string_out, size_t strbuffer_len);


UHD_API uhd_error uhd_meta_range_make(uhd_meta_range_handle* h);


UHD_API uhd_error uhd_meta_range_free(uhd_meta_range_handle* h);

UHD_API uhd_error uhd_meta_range_start(uhd_meta_range_handle h, double* start_out);

UHD_API uhd_error uhd_meta_range_stop(uhd_meta_range_handle h, double* stop_out);

UHD_API uhd_error uhd_meta_range_step(uhd_meta_range_handle h, double* step_out);

UHD_API uhd_error uhd_meta_range_clip(
    uhd_meta_range_handle h, double value, bool clip_step, double* result_out);

UHD_API uhd_error uhd_meta_range_size(uhd_meta_range_handle h, size_t* size_out);

UHD_API uhd_error uhd_meta_range_push_back(
    uhd_meta_range_handle h, const uhd_range_t* range);

UHD_API uhd_error uhd_meta_range_at(
    uhd_meta_range_handle h, size_t num, uhd_range_t* range_out);

UHD_API uhd_error uhd_meta_range_to_pp_string(
    uhd_meta_range_handle h, char* pp_string_out, size_t strbuffer_len);

UHD_API uhd_error uhd_meta_range_last_error(
    uhd_meta_range_handle h, char* error_out, size_t strbuffer_len);

#ifdef __cplusplus
}

UHD_API uhd::range_t uhd_range_c_to_cpp(const uhd_range_t* range_c);

UHD_API void uhd_range_cpp_to_c(const uhd::range_t& range_cpp, uhd_range_t* range_c);
#endif