1 |
/* -*- C++ -*- |
|
1 |
/* -*- mode: C++; indent-tabs-mode: nil; -*- |
|
2 | 2 |
* |
3 |
* This file is a part of LEMON, a generic C++ optimization library |
|
3 |
* This file is a part of LEMON, a generic C++ optimization library. |
|
4 | 4 |
* |
5 | 5 |
* Copyright (C) 2003-2008 |
6 | 6 |
* Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport |
7 | 7 |
* (Egervary Research Group on Combinatorial Optimization, EGRES). |
8 | 8 |
* |
9 | 9 |
* Permission to use, modify and distribute this software is granted |
... | ... |
@@ -22,35 +22,35 @@ |
22 | 22 |
|
23 | 23 |
\section named-func-param Named Function Parameters |
24 | 24 |
|
25 | 25 |
Several modern languages provide a convenient way to refer the |
26 | 26 |
function parameters by name also when you call the function. It is |
27 | 27 |
especially comfortable in case of a function having tons of parameters |
28 |
with natural default values. Sadly, C++ lack this amenity. |
|
28 |
with natural default values. Sadly, C++ lack this amenity. |
|
29 | 29 |
|
30 | 30 |
However, with a crafty trick and with some little |
31 | 31 |
inconvenience, it is possible to emulate is. |
32 | 32 |
The example below shows how to do it. |
33 | 33 |
|
34 | 34 |
\code |
35 |
class namedFn |
|
35 |
class namedFn |
|
36 | 36 |
{ |
37 | 37 |
int _id; |
38 | 38 |
double _val; |
39 | 39 |
int _dim; |
40 |
|
|
40 |
|
|
41 | 41 |
public: |
42 | 42 |
namedFn() : _id(0), _val(1), _dim(2) {} |
43 | 43 |
namedFn& id(int p) { _id = p ; return *this; } |
44 | 44 |
namedFn& val(double p) { _val = p ; return *this; } |
45 | 45 |
namedFn& dim(int p) { _dim = p ; return *this; } |
46 | 46 |
|
47 | 47 |
run() { |
48 |
std::cout << "Here comes the function itself\n" << |
|
49 |
<< "With parameters " |
|
50 |
|
|
48 |
std::cout << "Here comes the function itself\n" << |
|
49 |
<< "With parameters " |
|
50 |
<< _id << ", " << _val << ", " << _dim << std::endl; |
|
51 | 51 |
} |
52 | 52 |
}; |
53 | 53 |
\endcode |
54 | 54 |
|
55 | 55 |
Then you can use it like this. |
56 | 56 |
|
... | ... |
@@ -73,13 +73,13 @@ |
73 | 73 |
<b>Therefore, by convention, <tt>.run()</tt> must be used |
74 | 74 |
explicitly to execute a function having named parameters |
75 | 75 |
everywhere in LEMON.</b> |
76 | 76 |
|
77 | 77 |
\section named-templ-func-param Named Function Template Parameters |
78 | 78 |
|
79 |
A named parameter can also be a template |
|
79 |
A named parameter can also be a template function. The usage is |
|
80 | 80 |
exactly the same, but the implementation behind is a kind of black |
81 | 81 |
magic and they are the dirtiest part of the LEMON code. |
82 | 82 |
|
83 | 83 |
You will probably never need to know how it works, but if you really |
84 | 84 |
committed, have a look at \ref lemon/graph_to_eps.h for an example. |
85 | 85 |
|
... | ... |
@@ -100,20 +100,20 @@ |
100 | 100 |
was instantiated by using a traits class as a template parameter, and |
101 | 101 |
the class contains named parameters, we do not have to instantiate again |
102 | 102 |
the class with new traits class, but instead adaptor classes can |
103 | 103 |
be used as shown in the following example. |
104 | 104 |
|
105 | 105 |
\code |
106 |
Dijkstra<>:: |
|
106 |
Dijkstra<>::SetPredMap<NullMap<Node,Arc> >::Create |
|
107 | 107 |
\endcode |
108 | 108 |
|
109 | 109 |
It can also be used in conjunction with other named template |
110 | 110 |
parameters in arbitrary order. |
111 | 111 |
|
112 | 112 |
\code |
113 |
Dijkstra<>::SetDistMap<MyMap>::SetPredMap<NullMap<Node, |
|
113 |
Dijkstra<>::SetDistMap<MyMap>::SetPredMap<NullMap<Node,Arc> >::Create |
|
114 | 114 |
\endcode |
115 | 115 |
|
116 | 116 |
The result will be an instantiated Dijkstra class, in which the |
117 | 117 |
DistMap and the PredMap is modified. |
118 | 118 |
|
119 | 119 |
*/ |
0 comments (0 inline)