[PHP-NOTES] note 130249 added to generator.current

I do not agree with ctx2002 at gmail dot com, because they misinterpreted the gib-o-master's post. gib-o-master wrote: "current() advances *untouched* generator", "the *first* step/iteration", and this is the key. "the following calls will not" - this is another key.

ctx2002 at gmail dot com "touches" the generator by calling `valid`:

<?php
function y1()
{
    yield 1;
}

$g = y1();

// Here is the first "touch". So generator isn't untouched anymore.
// At this point generator has been already reached the first `yield`,
// so if we call `current` after that, we'll get "1".
if ($g->valid()) { 
    echo "valid\n"; 
}

// Here generator is already *touched*, so next calls
// of `valid`, `current` DO NOT advance the generator.
// `next` will do.
echo "current v:" . $g->current() . "\n"; //at this point, PHP outputs current v:1

// ...
?>

Please, look at the following example:
<?php
function y1()
{
    echo "I've been advanced by current(), but only in the first iteration";
    yield 1;
    yield 2;
}

$g = y1(); // No output.

// "I've been advanced by current(), but only in the first iteration".
// int(1)
var_dump($g->current());

// No advance anymore, so still int(1).
var_dump($g->current());
?>

This is standard behavior and is described in RFC: "If the generator is not yet at a yield statement (i.e. was just created and not yet used as an iterator), then any call to rewind, valid, current, key, next or send will resume the generator until the next yield statement is hit." 

BTW, `send` WILL advance the generator. But it's an another story: about consuming, not iterating.
----
Server IP: 45.112.84.4
Probable Submitter: 80.90.5.137 (proxied: 88.156.209.7)
----
Manual Page -- https://php.net/manual/en/generator.current.php
Edit        -- https://main.php.net/note/edit/130249
Del: integrated  -- https://main.php.net/note/delete/130249/integrated
Del: useless     -- https://main.php.net/note/delete/130249/useless
Del: bad code    -- https://main.php.net/note/delete/130249/bad+code
Del: spam        -- https://main.php.net/note/delete/130249/spam
Del: non-english -- https://main.php.net/note/delete/130249/non-english
Del: in docs     -- https://main.php.net/note/delete/130249/in+docs
Del: other reasons-- https://main.php.net/note/delete/130249
Reject      -- https://main.php.net/note/reject/130249
Search      -- https://main.php.net/manage/user-notes.php