autodoc.git / traditional_manual / chapter_21.html

version» Context lines:

autodoc.git/traditional_manual/chapter_21.html:4002:   <dd class='body--doc'><p>Support for specifying modifiers via a mapping was added in Pike 7.8.    This support can be tested for with the constant    <code>String.__HAVE_SPRINTF_STAR_MAPPING__</code>.</p>   </dd>   <dt class='head--doc'>Note</dt>   <dd class='body--doc'><p>Support for specifying little endian byte order to <code class='expr'>'F'</code>    was added in Pike 7.8. This support can be tested for with the    constant <code>String.__HAVE_SPRINTF_NEGATIVE_F__</code>.</p>   </dd>   <dt class='head--doc'>Example</dt> - <dd class='example'><pre><pre><code><span class='ns'>Pike</span> v7<span class='delim'>.</span>8 release 263 running Hilfe v3<span class='delim'>.</span>5 <span class='delim'>(</span>Incremental <span class='ns'>Pike</span> Frontend<span class='delim'>)</span> + <dd class='example'><pre><pre><code><span class='ns'>Pike</span> v7.8 release 263 running Hilfe v3.5 <span class='delim'>(</span>Incremental <span class='ns'>Pike</span> Frontend<span class='delim'>)</span>   <span class='delim'>&gt;</span> sprintf<span class='delim'>(</span><span class='string'>"The unicode character %c has character code %04X."</span><span class='delim'>,</span> <span class='string'>'A'</span><span class='delim'>,</span> <span class='string'>'A'</span><span class='delim'>)</span><span class='delim'>;</span>   <span class='delim'>(</span>1<span class='delim'>)</span> Result<span class='delim'>:</span> <span class='string'>"The unicode character A has character code 0041."</span>   <span class='delim'>&gt;</span> sprintf<span class='delim'>(</span><span class='string'>"#%@02X is the HTML code for purple."</span><span class='delim'>,</span> <span class='ns'>Image</span><span class='delim'>.</span>Color<span class='delim'>.</span>purple-&gt;rgb<span class='delim'>(</span><span class='delim'>)</span><span class='delim'>)</span><span class='delim'>;</span>   <span class='delim'>(</span>2<span class='delim'>)</span> Result<span class='delim'>:</span> <span class='string'>"#A020F0 is the HTML code for purple."</span>   <span class='delim'>&gt;</span> <span class='type'>int</span> n<span class='delim'>=</span>4711<span class='delim'>;</span>   <span class='delim'>&gt;</span> sprintf<span class='delim'>(</span><span class='string'>"%d = hexadecimal %x = octal %o = %b binary"</span><span class='delim'>,</span> n<span class='delim'>,</span> n<span class='delim'>,</span> n<span class='delim'>,</span> n<span class='delim'>)</span><span class='delim'>;</span>   <span class='delim'>(</span>3<span class='delim'>)</span> Result<span class='delim'>:</span> <span class='string'>"4711 = hexadecimal 1267 = octal 11147 = 1001001100111 binary"</span>   <span class='delim'>&gt;</span> write<span class='delim'>(</span><span class='string'>#"Formatting examples:   Left adjusted [%-10d]   Centered [%|10d]
autodoc.git/traditional_manual/chapter_21.html:9161:    <span class='lang'>if</span><span class='delim'>(</span> arguments-&gt;help <span class='delim'>)</span> print_help<span class='delim'>(</span><span class='delim'>)</span><span class='delim'>;</span>    ...   <span class='delim'>}</span>   </code></pre><p>The <code>Arg.parse</code> method will return a mapping from argument name    to the argument value, if any.</p>   <p> Non-option arguments will be placed in the index Arg.REST</p>   <p> The second way to use this module is to inherit the Options class    and add supported arguments.</p>   <pre><code><span class='type'>class</span> MyArguments <span class='delim'>{</span>    <span class='lang'>inherit</span> <span class='ns'>Arg</span><span class='delim'>.</span>Options<span class='delim'>;</span> +  <span class='type'>string</span> help_pre <span class='delim'>=</span> <span class='string'>"Usage: somecommand"</span><span class='delim'>;</span>    Opt verbose <span class='delim'>=</span> NoOpt<span class='delim'>(</span><span class='string'>"-v"</span><span class='delim'>)</span><span class='delim'>|</span>NoOpt<span class='delim'>(</span><span class='string'>"--verbose"</span><span class='delim'>)</span><span class='delim'>;</span> -  +  <span class='type'>string</span> verbose_help <span class='delim'>=</span> <span class='string'>"Turn on verbose output"</span><span class='delim'>;</span>    Opt help <span class='delim'>=</span> MaybeOpt<span class='delim'>(</span><span class='string'>"--help"</span><span class='delim'>)</span><span class='delim'>;</span>    Opt output <span class='delim'>=</span> HasOpt<span class='delim'>(</span><span class='string'>"--output"</span><span class='delim'>)</span><span class='delim'>|</span>HasOpt<span class='delim'>(</span><span class='string'>"-o"</span><span class='delim'>)</span><span class='delim'>;</span> -  +  <span class='type'>string</span> output_help <span class='delim'>=</span> <span class='string'>"Determine where output goes to"</span><span class='delim'>;</span> +  <span class='type'>string</span> help_post <span class='delim'>=</span> <span class='string'>"Command aborted"</span><span class='delim'>;</span>   <span class='delim'>}</span><span class='delim'>;</span>   </code></pre><p>Then, in main:</p>   <pre><code>MyArguments args = MyArguments(argv);</code></pre><p>See the documentation for <code>OptLibrary</code> for details about the various    Opt classes.</p>   </dd></dl>      <hr />   <dl class='group--doc'>   <dt class='head--type'><span class='homogen--type'>Constant</span>   <span class='homogen--name'><b>APP</b></span>