summaryrefslogtreecommitdiff
path: root/Examples/FunctionWithParameters/functionwithparameters.cpp
blob: dd7bb9f198ef78d362d8ad2fd3896dd3d0e4256c (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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
/**
 *  functionwithparameters.cpp
 *  @author Jasper van Eck<jasper.vaneck@copernica.com>
 * 
 *  An example file to show the working of a function call with parameters.
 */

/**
 *  Default Cpp libraries
 */
 
#include <string>
#include <iostream>

/**
 *  Our own library.
 */
#include <phpcpp.h>

/**
 *  Namespace to use
 */
using namespace std;

/**
 *  my_with_undefined_parameters_function()
 *  @param  Php:Parameters  the given parameters
 */
void my_with_undefined_parameters_function(Php::Parameters &params)
{
    for (unsigned int i = 0; i < params.size(); i++)
    {
        cout << "Parameter " << i << ": " << params[i] << endl;
    }
}

/**
 *  my_with_defined_parameters_function()
 *  @param  Php::Parameters     the given parameters
 *  @return Php::Value          Param[0] and Param[1] added
 */
Php::Value my_with_defined_parameters_function(Php::Parameters &params)
{
    for (unsigned int i = 0; i < params.size(); i++)
    {
        cout << "Parameter " << i << ": " << params[i] << endl;
    }
    
    return params[0] + params[1];
}

/**
 *  This functions receives a reference to a variable. When the variable is altered,
 *  so is the value in the php script.
 *  my_with_defined_parameters_reference_function()
 *  @param  Php::Parameters     the given parameters
 */
void my_with_defined_parameters_reference_function(Php::Parameters &params)
{
    params[0] = "I changed!";
}

/**
 *  my_with_defined_parameters_reference_function()
 *  @param  Php::Parameters     the given parameters
 */
void my_with_defined_array_parameters_function(Php::Parameters &params)
{
    for (int i = 0; i < params[0].size(); i++)
    {
        cout << "The array: " << params[0][i] << endl;
    }
}

/**
 *  my_with_defined_object_parameters_function()
 *  The use of objects is not yet implemented.
 *  @param Php::Parameters      the given parameters
 */
void my_with_defined_object_parameters_function(Php::Parameters &params)
{
    for (unsigned int i = 0; i < params.size(); i++)
    {
        cout << params[i] << endl;
    }
}

// Symbols are exported according to the "C" language
extern "C" 
{
    // export the "get_module" function that will be called by the Zend engine
    PHPCPP_EXPORT void *get_module()
    {
        // create extension
        static Php::Extension extension("my_function_with_parameters","1.0");
        
        // add function, with undefined parameters, to extension
        extension.add("my_with_undefined_parameters_function", my_with_undefined_parameters_function);
        
        // add function, with defined numeric parameters, to extension
        extension.add("my_with_defined_parameters_function", my_with_defined_parameters_function, {
            Php::ByVal("x", Php::numericType),
            Php::ByVal("y", Php::numericType)
            });
        
        // add function, with defined parameter by reference, to extension
        extension.add("my_with_defined_parameters_reference_function", my_with_defined_parameters_reference_function, {
            Php::ByRef("string", Php::stringType)
            });
        
        // add function, with defined array parameter, to extension
        extension.add("my_with_defined_array_parameters_function", my_with_defined_array_parameters_function, {
            Php::ByVal("array", Php::arrayType)
            });
        
        // add function, with defined object parameter, to extension
        extension.add("my_with_defined_object_parameters_function", my_with_defined_object_parameters_function, {
            Php::ByVal("myClassObjVar", "MyPhpClass")
            });
        
        // return the extension module
        return extension.module();
    }
}