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: 97.04%. remained the same
when pulling 8d5d1aa on moghwan:feat/add-limit-to-setvalues
into 89a202e 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