@@ -68,6 +68,8 @@ public function __construct($query) {
68
68
}
69
69
70
70
/**
71
+ * Set Query.
72
+ *
71
73
* @param string $query
72
74
*/
73
75
private function setQuery ($ query ) {
@@ -79,7 +81,7 @@ private function setQuery($query) {
79
81
}
80
82
81
83
/**
82
- * Returns keys
84
+ * Returns keys.
83
85
*
84
86
* @return array
85
87
*/
@@ -88,6 +90,8 @@ public function getKeys() {
88
90
}
89
91
90
92
/**
93
+ * Bind value to key.
94
+ *
91
95
* @param string $key
92
96
* @param string $value
93
97
*
@@ -101,6 +105,8 @@ public function bind($key, $value) {
101
105
}
102
106
103
107
/**
108
+ * Generate query.
109
+ *
104
110
* @param \DOMNode $ctx
105
111
* @param array $values
106
112
*
@@ -111,6 +117,8 @@ public function generate(\DOMNode $ctx, array $values = NULL) {
111
117
}
112
118
113
119
/**
120
+ * Evaluate Query.
121
+ *
114
122
* @param \DOMNode $ctx
115
123
* @param array $values
116
124
* @param bool $registerNodeNS
@@ -125,6 +133,8 @@ public function evaluate(\DOMNode $ctx, array $values = NULL, $registerNodeNS =
125
133
}
126
134
127
135
/**
136
+ * Execute Query.
137
+ *
128
138
* @param \DOMNode $ctx
129
139
* @param array $values
130
140
* @param bool $registerNodeNS
@@ -139,18 +149,22 @@ public function query(\DOMNode $ctx, array $values = NULL, $registerNodeNS = TRU
139
149
}
140
150
141
151
/**
152
+ * Execute Query and return first result.
153
+ *
142
154
* @param \DOMNode $ctx
143
155
* @param array $values
144
156
* @param bool $registerNodeNS
145
157
*
146
- * @return \DOMNode|mixed
158
+ * @return \DOMNode
147
159
*/
148
160
public function queryOne (\DOMNode $ ctx , array $ values = NULL , $ registerNodeNS = TRUE ) {
149
161
$ xp = $ this ->getXPathObjectFor ($ ctx );
150
162
return $ xp ->queryOne ($ this ->buildQuery ($ xp , $ values ), $ ctx , $ registerNodeNS );
151
163
}
152
164
153
165
/**
166
+ * Return xPath for node
167
+ *
154
168
* @param \DOMNode $ctx
155
169
*
156
170
* @throws fDOMException
@@ -166,6 +180,8 @@ private function getXPathObjectFor(\DOMNode $ctx) {
166
180
}
167
181
168
182
/**
183
+ * Build query using values.
184
+ *
169
185
* @param fDOMXPath $xp
170
186
* @param array $values
171
187
*
0 commit comments