MultipleIterator::__construct

Constructs a new MultipleIterator

&reftitle.description; public `MultipleIterator::__construct` `int` `flags` MultipleIterator::MIT_NEED_ALL | MultipleIterator::MIT_KEYS_NUMERIC

Construct a new MultipleIterator.

&reftitle.parameters;

`flags`

- The flags to set, according to the Flag Constants.

  - `MultipleIterator::MIT_NEED_ALL` or `MultipleIterator::MIT_NEED_ANY`
  - `MultipleIterator::MIT_KEYS_NUMERIC` or `MultipleIterator::MIT_KEYS_ASSOC`

  Defaults to `MultipleIterator::MIT_NEED_ALL`|`MultipleIterator::MIT_KEYS_NUMERIC`.

&reftitle.examples;

### Iterating a MultipleIterator

    <?php
    $people = new ArrayIterator(array('John', 'Jane', 'Jack', 'Judy'));
    $roles  = new ArrayIterator(array('Developer', 'Scrum Master', 'Project Owner'));

    $team = new MultipleIterator($flags);
    $team->attachIterator($people, 'person');
    $team->attachIterator($roles, 'role');

    foreach ($team as $member) {
        print_r($member);
    }
    ?>

Output with `$flags = MIT_NEED_ALL|MIT_KEYS_NUMERIC`

    Array
    (
        [0] => John
        [1] => Developer
    )
    Array
    (
        [0] => Jane
        [1] => Scrum Master
    )
    Array
    (
        [0] => Jack
        [1] => Project Owner
    )

Output with `$flags = MIT_NEED_ANY|MIT_KEYS_NUMERIC`

    Array
    (
        [0] => John
        [1] => Developer
    )
    Array
    (
        [0] => Jane
        [1] => Scrum Master
    )
    Array
    (
        [0] => Jack
        [1] => Project Owner
    )
    Array
    (
        [0] => Judy
        [1] =>
    )

Output with `$flags = MIT_NEED_ALL|MIT_KEYS_ASSOC`

    Array
    (
        [person] => John
        [role] => Developer
    )
    Array
    (
        [person] => Jane
        [role] => Scrum Master
    )
    Array
    (
        [person] => Jack
        [role] => Project Owner
    )

Output with `$flags = MIT_NEED_ANY|MIT_KEYS_ASSOC`

    Array
    (
        [person] => John
        [role] => Developer
    )
    Array
    (
        [person] => Jane
        [role] => Scrum Master
    )
    Array
    (
        [person] => Jack
        [role] => Project Owner
    )
    Array
    (
        [person] => Judy
        [role] =>
    )

&reftitle.seealso;

- Flag Constants
- `MultipleIterator::valid`