Feature: add limit option to setvalues

[moghwan]

Description

This PR adds a limit parameter to the setValues function, which itself is uses within with setValue. This will help to avoid to minimize written if the limit is needed for a bulk search&replace operation.

example:

$templateProcessor = new TemplateProcessor('sample.docx');

$firstname = 'John';
$middlename = 'Mc';
$lastname = 'Doe';

// current
$templateProcessor->setValues([
    "firstname" => $firstname,
    "middlename" => $middlename,
    "lastname" => $lastname,
]);

// assuming we want to change the only the "first" name variables:
// workaround
$templateProcessor->setValue("firstname", $firstname, 1);
$templateProcessor->setValue("middlename", $middlename, 1);
$templateProcessor->setValue("lastname", $lastname, 1);

// improvement
$templateProcessor->setValues([
    "firstname" => $firstname,
    "middlename" => $middlename,
    "lastname" => $lastname,
], 1);

Checklist:

• My CI is 🟢
• I have covered by unit tests my new code (check build/coverage for coverage report)
• I have updated the documentation to describe the changes
• I have updated the changelog

[coveralls]

coverage: 96.757%. remained the same
when pulling b7d4a11 on moghwan:feat/add-limit-to-setvalues
into 2a524e2 on PHPOffice:master.

[Progi1984]

@moghwan Hi, could you add Unit Tests, please ?

https://github.com/PHPOffice/PHPWord/blob/master/tests/PhpWordTests/TemplateProcessorTest.php#L597

[moghwan]

sure thing!

[moghwan]

done

[Progi1984]

@moghwan Could you rebase the PR and update the changelog 1.4.0 ?

After that, it will be a merge.

[moghwan]

branch & doc change updated

[Progi1984]

@moghwan Thank you for your contribution 🥳

[moghwan]

with pleasure 😁