Return
बस फोन करने वाले को एक अनूठा मूल्य देता है।
Yield
वर्तमान फ़ंक्शन / विधि को वापस करने के लिए रूपांतरण करें Generator
, जो एक अनूठे मूल्य से अधिक का उत्पादन करेगा: हर बार yield
ट्रिगर होने पर, यह कॉलर को मूल्य देता है, एक समय में, पारंपरिक रूप से एक foreach
लूप का उपयोग करके ।
Yield
+ Return
जनरेटर, मान उत्पन्न करने के अलावा, एक विशिष्ट लौटाया गया मान भी प्रदान कर सकते हैं। यह मान जनरेटर के आसपास लूपिंग का हिस्सा नहीं होगा, इसे Generator::getReturn()
विधि का उपयोग करके एक्सेस किया जाना चाहिए ।
Return
+ Yield
इसे बग के रूप में देखा जा सकता है, हालांकि, ऐसा नहीं है।
वे दो चरण हैं:
- कोड से बाइटकोड तक : इस चरण के दौरान,
generate()
फ़ंक्शन को yield
कीवर्ड शामिल करने के लिए देखा जाता है , इसलिए इसे उत्पादन के रूप में चिह्नित किया जाता है Generator
।
- निष्पादन : क्योंकि
return
ऐसा होने से पहले yield
, जनरेटर के पास किसी भी मूल्य का उत्पादन करने का मौका नहीं होता है। हालाँकि, [1, 2, 3]
सरणी को पुनः प्राप्त किया जा सकता है Generator::getReturn()
।
एक पूर्ण एनोटेट उदाहरण:
// Generate integers 1 and 2
function generateIntegers1And2(): Generator {
yield 1; // <--+ <--+ <--+
yield 2; // <-+ <-+ <-+
} // | | |
// | | |
foreach (generateIntegers1And2() as $value) { // | | |
var_dump($value); // Shows 1, then 2 ->* | |
} // | |
// | |
function generateOuterYield(): Generator { // | |
// Yields the generator *itself* returned by | |
// generateIntegers1And2() not the actual values | |
// generated by it. | |
// This means we are producing here a generator | |
// of generator of integers. | |
yield generateIntegers1And2(); // <-+ | |
} // | | |
// | | |
foreach (generateOuterYield() as $value) { // | | |
var_dump($value); // ->* | |
// The two levels of imbrication means we have | |
// to loop once more to actually consume | |
// generateIntegers1And2 | |
foreach ($value as $val) { // | |
var_dump($val); // Shows 1, then 2 ->* |
} // |
} // |
// |
// A generator can just be returned as-is: |
function generateOuterReturn(): Generator { // |
return generateIntegers1And2(); // |
} // |
// |
// it doesn't change the way it is consumed |
foreach (generateOuterReturn() as $value) { // |
var_dump($value); // Shows 1, then 2 |
} // |
// |
function generateOuterYieldFrom(): Generator { // |
// First yield values generated by generateIntegers1And2() |
yield from generateIntegers1And2(); // *<---+
// then yield integers 3 |
yield 3; // <--+
// and 4 |
yield 4; // <-+
} // |
// |
foreach (generateOuterYieldFrom() as $value) { // |
var_dump($value); // Shows 1, 2, 3 and 4 ->*
}
function generateIntegers56AndReturn(): Generator {
yield 5; // <---+
yield 6; // <--+
// |
return ["five", "six"]; // <--+ |
} // | |
// | |
$gen = generateIntegers56AndReturn(); // | |
// | |
// Consume the values **yielded** by | |
// generateIntegers56AndReturn() | |
foreach ($gen as $value) { // | |
var_dump($value); // Shows 5, then 6 | ->*
} // |
// |
// Access the value **returned** by the generator |
var_dump($gen->getReturn()); // ->*
function wtf(): Generator {
return ["W", "T", "F", "!"];
// Without the following line, PHP would complain with a TypeError:
// Return value of wtf() must be an instance of Generator, array returned.
// The presence of a yield keyword anywhere inside the function makes it a Generator.
// However, since we return *before* reaching any *yield*, 42 is never yielded.
// This is empty generator!
yield 42;
}
$gen = wtf();
// This foreach loop is not entered!
foreach ($gen as $value) {
var_dump($value);
}
// However, we can loop on the array *returned* by wtf():
foreach ($gen->getReturn() as $value) {
echo $value; // Will print: WTF!
}
var_dump(generate()->GetReturn());