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
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* This file is example code for XPLC (http://xplc.sourceforge.net/),
* and is put into the public domain.
*/
#ifndef __EXAMPLE_EXAMPLE_H__
#define __EXAMPLE_EXAMPLE_H__
#include <xplc/IObject.h>
/* Interfaces can only derive from exactly one interface. They must
* ultimately be derived from IObject. Since we do not derive from
* anything else useful here, we derive from IObject directly.
*/
class IExample: public IObject {
/* This is to indicate that this interface has not been released in
* a final version, and is subject to disappear or be changed. When
* you use an interface marked in this manner, you have to indicate
* your acceptance of this unstable condition by defining the
* UNSTABLE pre-processor symbol (see the Makefile).
*
* Once this marker is removed, an interface cannot be changed ever
* again, neither in syntax (adding/removing methods) or in
* semantics (changing the meaning of methods).
*
* You are allowed to change the name of the interface, if you want,
* because the real identifier of the interface is the IID (defined
* at the bottom). For example, you might create a new version of
* the interface someday and rename this one to IExampleOld.
*
* This is how you can have progress in XPLC: instead of changing
* existing interfaces, you create new ones. A new version of
* IExample could derive from IExampleOld, if you only wanted to add
* some methods, thus making it easy to stay compatible (any code
* that wanted an IExampleOld will work with the new IExample).
*/
UNSTABLE_INTERFACE
public:
/* Here are some of the most important rules for an XPLC interface:
*
* - It can only have public members.
* - Non-method members are not allowed (you cannot have variables).
* - All methods must be pure virtual.
*/
virtual void sayHello() = 0;
};
/* These numbers are obtained using "uuidgen" or "guidgen.exe". The
* "uuid2cdef.pl" script can be used to fix the formatting of the
* "uuidgen" program.
*
* This is the ultimate identifier for this interface. Changing either
* the syntax or the semantics of an interface without changing this
* identifier would be Bad.
*
* "IID" stands for "Interface ID". This is a normal UUID, there is
* nothing different except the name, but it helps to have some
* context when discussing or documenting things.
*/
DEFINE_IID(IExample, {0x86c3a2d0, 0xe19b, 0x49d0,
{0xb2, 0x84, 0x67, 0xc1, 0x11, 0x4a, 0x9d, 0x79}});
#endif /* __EXAMPLE_EXAMPLE_H__ */
|
