در حال ویرایش الگو:For loop/توضیحات (بخش)

== Legacy code ==

This template is currently in its third incarnation. It is now uses the [[ویکی‌پدیا:لوآ|Lua]] code at [[پودمان:ForLoop]]. It was ported to Lua from [[mw:Help:Extension:ParserFunctions|ParserFunctions]], and the old code is available at {{الگو|for loop/old}}. There was also a previous version with a named "sep" parameter to specify the separator value. The template was originally based on [[:m:Template:For]]. The template name was changed because there was already a [[الگو:برای]] on Wikipedia.

The old versions were limited to 150 variable values and four fixed parameters. There are no such limits in the current version. Also, in the first version the "sep" parameter didn't allow whitespace in the separator value. This was fixed with the second version and was retained in the current version.

=== Substitution ===

The current Lua-based template supports [[ویکی‌پدیا:جانشینی|substitution]] of the whole template call. To substitute everything, use {{الگوج|for loop}}.

The previous ParserFunctions-based template supported varying levels of substitution. If you wish to have fine-grained control over substitution, you need to use {{الگو|for loop/old}}. For successive levels of substitution use one or more or the following (the first, the first two, the first three, the first four, or all five).

*"subst:" in front of "for loop/old" -  substitute the call of {{الگو|for loop/old}}
*substf=subst: - substitute the parser functions in {{الگو|for loop/old}}
*substfa=subst: - substitute the call of {{الگو|ForLoop/aux}}, a helper subtemplate
*substa=subst: - substitute the parser functions in {{الگو|ForLoop/aux}} (reduces the number of items from 150 to the actual number)
*substc=subst: - substitute the calls of the user template

If at least the first four are applied, and the separator contains <code><nowiki>{{!}}</nowiki></code>, one can replace it with <code><nowiki>{{subst:!}}</nowiki></code> to substitute that too.

For full substitution [[Special:ExpandTemplates]] can also be used.

=== Converting legacy template invocations ===

If you need to convert a template invocation that was written for the original version of {{الگو|for loop}}, do the following:
*replace <code>pc1=X=Y</code> with <code>pc1n=X | pc1v=Y</code>, etc.
*use an unnamed parameter for the separator; if empty, just enter an extra "|"
No conversion is necessary for invocations written for the second version of the template, unless they use fine-grained substitution as mentioned in the section above. If you need fine-grained substitution you should use {{الگو|for loop/old}} instead of {{الگو|for loop}}. — '''''[[User:Mr. Stradivarius|<span style="color: #194D00; font-family: Palatino, Times, serif">Mr. Stradivarius</span>]]''''' <sup>[[User talk:Mr. Stradivarius|♪ talk ♪]]</sup> 09:44, 19 July 2013 (UTC)