aboutsummaryrefslogtreecommitdiffstats
path: root/host/lib/rfnoc/nocscript/function_table.hpp
blob: 918b5c4d30785ea23ce32649b9d9c33f538c6361 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
//
// Copyright 2015 Ettus Research LLC
//
// SPDX-License-Identifier: GPL-3.0
//

#include "expression.hpp"
#include <boost/shared_ptr.hpp>
#include <boost/function.hpp>
#include <vector>

#ifndef INCLUDED_LIBUHD_RFNOC_NOCSCRIPT_FUNCTABLE_HPP
#define INCLUDED_LIBUHD_RFNOC_NOCSCRIPT_FUNCTABLE_HPP

namespace uhd { namespace rfnoc { namespace nocscript {

class function_table
{
  public:
    typedef boost::shared_ptr<function_table> sptr;
    typedef boost::function<expression_literal(expression_container::expr_list_type&)> function_ptr;

    static sptr make();
    virtual ~function_table() {};

    /*! Check if any function with a given name exists
     *
     * \returns True, if any function with name \p name is registered.
     */
    virtual bool function_exists(const std::string &name) const = 0;

    /*! Check if a function with a given name and list of argument types exists
     *
     * \returns True, if such a function is registered.
     */
    virtual bool function_exists(
            const std::string &name,
            const expression_function::argtype_list_type &arg_types
    ) const = 0;

    /*! Get the return type of a function with given name and argument type list
     *
     * \returns The function's return type
     * \throws uhd::syntax_error if no such function is registered
     */
    virtual expression::type_t get_type(
            const std::string &name,
            const expression_function::argtype_list_type &arg_types
    ) const = 0;

    /*! Calls the function \p name with the argument list \p arguments
     *
     * \param arg_types A list of types for each argument
     * \param arguments An expression list of the arguments
     * \returns The return value of the called function
     * \throws uhd::syntax_error if no such function is found
     */
    virtual expression_literal eval(
            const std::string &name,
            const expression_function::argtype_list_type &arg_types,
            expression_container::expr_list_type &arguments
    ) = 0;

    /*! Register a new function
     *
     * \param name Name of the function (e.g. 'ADD')
     * \param ptr Function object
     * \param return_type The function's return value
     * \param sig The function signature (list of argument types)
     */
    virtual void register_function(
            const std::string &name,
            const function_ptr &ptr,
            const expression::type_t return_type,
            const expression_function::argtype_list_type &sig
    ) = 0;
};

}}} /* namespace uhd::rfnoc::nocscript */

#endif /* INCLUDED_LIBUHD_RFNOC_NOCSCRIPT_FUNCTABLE_HPP */
// vim: sw=4 et: