Template:Out: Difference between revisions

From Rosetta Code
Content added Content deleted
(Working towards a standard way of describing output of examples)
 
m (typo)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<includeonly><div>
<includeonly><div>;{{#if {{{1|}}} | {{{1}}} | Output}}<nowiki>:</nowiki></div></includeonly><noinclude><nowiki>;Output:</nowiki>
;{{#if: {{{1|}}} | {{{1}}} | Output}}{{#if: {{{note|}}} | <i style="font-weight:normal> ({{{note}}})</i> |}}{{#if: {{{case|}}}{{{input|}}} | <span style="font-weight:normal> &nbsp;&mdash;&nbsp; {{{case|for input <code>{{{input|}}}</code>}}}</span> |}}{{#if: {{{text|}}} | <nowiki/> <span style="font-weight:normal>{{{text}}}</span> | <nowiki>:</nowiki>}}</div></includeonly><noinclude>


This template is used to standardize the way in which example output is described. {{template}}</noinclude>
This template is used to introduce the output of a programming example.

===Usage===

Write <code><nowiki>{{out}}</nowiki></code> just above the <code><nowiki><pre>...</pre></nowiki></code> block that lists a code example's output.

It also accepts these optional parameters:

{| class="wikitable"
|-
! Parameter
! Purpose
! Example
! Renders as
|-
|
|
| <code><nowiki>{{out}}</nowiki></code>
| {{out}}
|-
| <code>1</code>
| Text to show instead of the word "Output".
| <code><nowiki>{{out|Return value}}</nowiki></code>
| <div style="white-space:nowrap">{{out|Return value}}</div>
|-
| <code>case</code>
| The test-case/condition which produces this output.
| <code><nowiki>{{out|case=test case 3}}</nowiki></code>
| <div style="white-space:nowrap">{{out|case=test case 3}}</div>
|-
| <code>input</code>
| The (single-line) input which produces this output.
| <code><nowiki>{{out|input=Hello world}}</nowiki></code>
| <div style="white-space:nowrap">{{out|input=Hello world}}</div>
|-
| <code>note</code>
| A remark to show in parentheses.
| <code><nowiki>{{out|note=elided}}</nowiki></code>
| <div style="white-space:nowrap">{{out|note=elided}}</div>
|-
| <code>text</code>
| Free-form text to follow instead of a colon.
| <code><nowiki>{{out|text=...}}</nowiki></code>
| <div style="white-space:nowrap">{{out|text=...}}</div>
|}

You can combine multiple parameters, except that <tt>case</tt> and <tt>input</tt> are mutually exclusive.

{{template}}</noinclude>

Latest revision as of 10:34, 27 August 2016


This template is used to introduce the output of a programming example.

Usage

Write {{out}} just above the <pre>...</pre> block that lists a code example's output.

It also accepts these optional parameters:

Parameter Purpose Example Renders as
{{out}}
Output:
1 Text to show instead of the word "Output". {{out|Return value}}
Return value:
case The test-case/condition which produces this output. {{out|case=test case 3}}
Output  —  test case 3:
input The (single-line) input which produces this output. {{out|input=Hello world}}
Output  —  for input Hello world:
note A remark to show in parentheses. {{out|note=elided}}
Output (elided):
text Free-form text to follow instead of a colon. {{out|text=...}}
Output ...

You can combine multiple parameters, except that case and input are mutually exclusive.



This is a template. There are many others. See Category:RCTemplates for a complete list of templates.