summaryrefslogtreecommitdiff
path: root/include/interface.h
blob: a93167f7d38c88a8059a6a03eacd7900844a8594 (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
83
84
85
86
87
88
89
90
/**
 *  Interface.h
 *
 *  @copyright 2014 Copernica BV
 *  @author Emiel Bruijntjes <emiel.bruijntjes@copernica.com>
 */

/**
 *  Set up namespace
 */
namespace Php {

/**
 *  Class definition
 */
class PHPCPP_EXPORT Interface : private ClassBase
{
public:
    /**
     *  Constructor
     *  @param  name
     */
    Interface(const char *name) : ClassBase(name, ClassType::Interface) {}

    /**
     *  Destructor
     */
    virtual ~Interface() {}

    /**
     *  Add a - of course abstract - method to the interface
     *  @param  name        Name of the method
     *  @param  arguments   Optional description of the arguments
     *  @return Interface   Same object to allow chaining
     */
    Interface &method(const char *name, const Arguments &arguments = {})
    {
        // call base
        ClassBase::method(name, Abstract | Public, arguments);

        // return self
        return *this;
    }

    /**
     *  Add a - of course abstract - method to the interface
     *  @param  name        Name of the method
     *  @param  flags       Optional flags
     *  @param  arguments   Optional description of the arguments
     *  @return Interface   Same object to allow chaining
     */
    Interface &method(const char *name, int flags, const Arguments &arguments = {})
    {
        // call base (an interface method is always public, so we add these flags,
        // and although it is always abstract, PHP does not allow this flag, so we
        // remove it in case the extension programmer had set it)
        ClassBase::method(name, (Public | flags) & ~Abstract, arguments);

        // return self
        return *this;
    }
    
    /**
     *  Extends exisiting PHP interface
     *
     *  Note that the interface that you supply must already exist! Therefore
     *  you can only supply interfaces that you created in your own extension.
     *
     *  @param  interface   Interface object
     *  @return Interface   Same object to allow chaining
     */
    Interface &extends(const Interface &interface) { ClassBase::implements(interface); return *this; }

    /**
     *  The namespace needs to have access to the private ClassBase base
     *  class, to actually register the interface.
     */
    friend class Namespace;

    /**
     *  All Php::Class<AnyThing> also need access to the base class to
     *  register an interface.
     */
    template<typename ANYTHING> friend class Class;
};

/**
 *  End namespace
 */
}