summaryrefslogtreecommitdiff
path: root/include/super.h
blob: 97ba6b8eb8638aa8319dc233c1b2f8f1fbb80fe2 (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
/**
 *  Super.h
 *
 *  The Super class is used to implement one of the super variables $_POST,
 *  $_GET, $_SERVER, et cetera
 *
 *  @copyright 2014 Copernica BV
 *  @author Emiel Bruijntjes <emiel.bruijntjes@copernica.com>
 */

/**
 *  Set up namespace
 */
namespace Php {
    
/**
 *  Class definition
 */
class Super
{
public:
    /**
     *  Constructor
     * 
     *  Extension writers do not have to access the super-globals themselves.
     *  They are always accessible via Php::POST, Php::GET, et cetera.
     * 
     *  @param  index   index number
     *  @param  name    name of the variable in PHP
     */
    Super(int index, const char *name) : _index(index), _name(name) {}
    
    /**
     *  Destructor
     */
    virtual ~Super() {}
    
    /**
     *  Array access operator
     *  This can be used for accessing associative arrays
     *  @param  key
     *  @return Value
     */
    Value operator[](const std::string &key);

    /**
     *  Array access operator
     *  This can be used for accessing associative arrays
     *  @param  key
     *  @return Value
     */
    Value operator[](const char *key);

private:
    /**
     *  Index number
     *  @var    int
     */
    int _index;
    
    /**
     *  Name of the variable in PHP
     *  @var    name
     */
    const char *_name;
};

/**
 *  A number of super-globals are always accessible
 */
extern Super POST;
extern Super GET;
extern Super COOKIE;
extern Super SERVER;
extern Super ENV;
extern Super FILES;
extern Super REQUEST;

/**
 *  End namespace
 */
}