|
@@ -13,7 +13,7 @@ discard block |
|
|
block discarded – undo |
|
13
|
13
|
* @param array|\Iterator|\IteratorAggregate|Enumerable $source Source sequence. |
|
14
|
14
|
* @throws \InvalidArgumentException If source is not array or Traversible or Enumerable. |
|
15
|
15
|
* @throws \UnexpectedValueException If source contains no elements (checked during enumeration). |
|
16
|
|
- * @return Enumerable Endless list of items repeating the source sequence. |
|
|
16
|
+ * @return EnumerableGeneration Endless list of items repeating the source sequence. |
|
17
|
17
|
* @package YaLinqo\Generation |
|
18
|
18
|
*/ |
|
19
|
19
|
public static function cycle ($source) |
|
@@ -36,7 +36,7 @@ discard block |
|
|
block discarded – undo |
|
36
|
36
|
/** |
|
37
|
37
|
* Returns an empty sequence. |
|
38
|
38
|
* <p><b>Syntax</b>: emptyEnum () |
|
39
|
|
- * @return Enumerable |
|
|
39
|
+ * @return EnumerableGeneration |
|
40
|
40
|
* @package YaLinqo\Generation |
|
41
|
41
|
*/ |
|
42
|
42
|
public static function emptyEnum () |
|
@@ -79,6 +79,9 @@ discard block |
|
|
block discarded – undo |
|
79
|
79
|
throw new \InvalidArgumentException('source must be array or Traversable.'); |
|
80
|
80
|
} |
|
81
|
81
|
|
|
|
82
|
+ /** |
|
|
83
|
+ * @param \Traversable $source |
|
|
84
|
+ */ |
|
82
|
85
|
private static function fromTraversable ($source) |
|
83
|
86
|
{ |
|
84
|
87
|
foreach ($source as $k => $v) |
|
@@ -93,7 +96,7 @@ discard block |
|
|
block discarded – undo |
|
93
|
96
|
* @param mixed $seedValue Initial state of the generator loop for values. Default: null. |
|
94
|
97
|
* @param callable|null $funcKey {(v, k) ==> key} State update function to run on key after every iteration of the generator loop. Default: increment. |
|
95
|
98
|
* @param mixed $seedKey Initial state of the generator loop ofr keys. Default: 0. |
|
96
|
|
- * @return Enumerable |
|
|
99
|
+ * @return EnumerableGeneration |
|
97
|
100
|
* @package YaLinqo\Generation |
|
98
|
101
|
*/ |
|
99
|
102
|
public static function generate ($funcValue, $seedValue = null, $funcKey = null, $seedKey = null) |
|
@@ -120,7 +123,7 @@ discard block |
|
|
block discarded – undo |
|
120
|
123
|
* <p><b>Syntax</b>: toInfinity ([start [, step]]) |
|
121
|
124
|
* @param int $start The first integer in the sequence. Default: 0. |
|
122
|
125
|
* @param int $step The difference between adjacent integers. Default: 1. |
|
123
|
|
- * @return Enumerable |
|
|
126
|
+ * @return EnumerableGeneration |
|
124
|
127
|
* @package YaLinqo\Generation |
|
125
|
128
|
*/ |
|
126
|
129
|
public static function toInfinity ($start = 0, $step = 1) |
|
@@ -138,7 +141,7 @@ discard block |
|
|
block discarded – undo |
|
138
|
141
|
* @param string $subject The input string. |
|
139
|
142
|
* @param string $pattern The pattern to search for, as a string. |
|
140
|
143
|
* @param int $flags Can be a combination of the following flags: PREG_PATTERN_ORDER, PREG_SET_ORDER, PREG_OFFSET_CAPTURE. Default: PREG_SET_ORDER. |
|
141
|
|
- * @return Enumerable |
|
|
144
|
+ * @return EnumerableGeneration |
|
142
|
145
|
* @see preg_match_all |
|
143
|
146
|
* @package YaLinqo\Generation |
|
144
|
147
|
*/ |
|
@@ -155,7 +158,7 @@ discard block |
|
|
block discarded – undo |
|
155
|
158
|
* <p><b>Syntax</b>: toNegativeInfinity ([start [, step]]) |
|
156
|
159
|
* @param int $start The first integer in the sequence. Default: 0. |
|
157
|
160
|
* @param int $step The difference between adjacent integers. Default: 1. |
|
158
|
|
- * @return Enumerable |
|
|
161
|
+ * @return EnumerableGeneration |
|
159
|
162
|
* @package YaLinqo\Generation |
|
160
|
163
|
*/ |
|
161
|
164
|
public static function toNegativeInfinity ($start = 0, $step = 1) |
|
@@ -167,7 +170,7 @@ discard block |
|
|
block discarded – undo |
|
167
|
170
|
* Returns a sequence that contains a single element with a specified value. |
|
168
|
171
|
* <p><b>Syntax</b>: returnEnum (element) |
|
169
|
172
|
* @param mixed $element The single element in the resulting sequence. |
|
170
|
|
- * @return Enumerable Observable sequence containing the single specified element. |
|
|
173
|
+ * @return EnumerableGeneration Observable sequence containing the single specified element. |
|
171
|
174
|
* @package YaLinqo\Generation |
|
172
|
175
|
*/ |
|
173
|
176
|
public static function returnEnum ($element) |
|
@@ -183,7 +186,7 @@ discard block |
|
|
block discarded – undo |
|
183
|
186
|
* @param int $start The value of the first integer in the sequence. |
|
184
|
187
|
* @param int $count The number of integers to generate. |
|
185
|
188
|
* @param int $step The difference between adjacent integers. Default: 1. |
|
186
|
|
- * @return Enumerable A sequence that contains a range of integral numbers. |
|
|
189
|
+ * @return EnumerableGeneration A sequence that contains a range of integral numbers. |
|
187
|
190
|
* @package YaLinqo\Generation |
|
188
|
191
|
*/ |
|
189
|
192
|
public static function range ($start, $count, $step = 1) |
|
@@ -205,7 +208,7 @@ discard block |
|
|
block discarded – undo |
|
205
|
208
|
* @param int $start The value of the first integer in the sequence. |
|
206
|
209
|
* @param int $count The number of integers to generate. |
|
207
|
210
|
* @param int $step The difference between adjacent integers. Default: 1. |
|
208
|
|
- * @return Enumerable A sequence that contains a range of integral numbers. |
|
|
211
|
+ * @return EnumerableGeneration A sequence that contains a range of integral numbers. |
|
209
|
212
|
* @package YaLinqo\Generation |
|
210
|
213
|
*/ |
|
211
|
214
|
public static function rangeDown ($start, $count, $step = 1) |
|
@@ -222,7 +225,7 @@ discard block |
|
|
block discarded – undo |
|
222
|
225
|
* @param int $end The value of the last integer in the sequence (not included). |
|
223
|
226
|
* @param int $step The difference between adjacent integers. Default: 1. |
|
224
|
227
|
* @throws \InvalidArgumentException If step is not a positive number. |
|
225
|
|
- * @return Enumerable A sequence that contains a range of integral numbers. |
|
|
228
|
+ * @return EnumerableGeneration A sequence that contains a range of integral numbers. |
|
226
|
229
|
* @package YaLinqo\Generation |
|
227
|
230
|
*/ |
|
228
|
231
|
public static function rangeTo ($start, $end, $step = 1) |
|
@@ -251,7 +254,7 @@ discard block |
|
|
block discarded – undo |
|
251
|
254
|
* @param int $element The value to be repeated. |
|
252
|
255
|
* @param int $count The number of times to repeat the value in the generated sequence. Default: null. |
|
253
|
256
|
* @throws \InvalidArgumentException If count is less than 0. |
|
254
|
|
- * @return Enumerable A sequence that contains a repeated value. |
|
|
257
|
+ * @return EnumerableGeneration A sequence that contains a repeated value. |
|
255
|
258
|
* @package YaLinqo\Generation |
|
256
|
259
|
*/ |
|
257
|
260
|
public static function repeat ($element, $count = null) |
|
@@ -270,7 +273,7 @@ discard block |
|
|
block discarded – undo |
|
270
|
273
|
* @param string $subject The input string. |
|
271
|
274
|
* @param string $pattern The pattern to search for, as a string. |
|
272
|
275
|
* @param int $flags flags can be any combination of the following flags: PREG_SPLIT_NO_EMPTY, PREG_SPLIT_DELIM_CAPTURE, PREG_SPLIT_OFFSET_CAPTURE. Default: 0. |
|
273
|
|
- * @return Enumerable |
|
|
276
|
+ * @return EnumerableGeneration |
|
274
|
277
|
* @see preg_split |
|
275
|
278
|
* @package YaLinqo\Generation |
|
276
|
279
|
*/ |