Debian Codegraph @

docs/fpm-ford/proc/specified.html

raw
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4 <meta charset="utf-8">
5 <meta http-equiv="X-UA-Compatible" content="IE=edge">
6 <meta name="viewport" content="width=device-width, initial-scale=1">
7 <meta name="description" content="command line parsing">
8 <meta name="author" content="John S. Urban" >
9 <link rel="icon" href="../favicon.png">
10
11 <title>specified &ndash; M_CLI2</title>
12
13 <link href="../css/bootstrap.min.css" rel="stylesheet">
14 <link href="../css/pygments.css" rel="stylesheet">
15 <link href="../css/font-awesome.min.css" rel="stylesheet">
16 <link href="../css/local.css" rel="stylesheet">
17 <link href="../tipuesearch/tipuesearch.css" rel="stylesheet">
18
19 <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
20 <!--[if lt IE 9]>
21 <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
22 <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
23 <![endif]-->
24
25 <script src="../js/jquery-2.1.3.min.js"></script>
26 <script src="../js/svg-pan-zoom.min.js"></script>
27
28 </head>
29
30 <body>
31
32 <!-- Fixed navbar -->
33 <nav class="navbar navbar-inverse navbar-fixed-top">
34 <div class="container">
35 <div class="navbar-header">
36 <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
37 <span class="sr-only">Toggle navigation</span>
38 <span class="icon-bar"></span>
39 <span class="icon-bar"></span>
40 <span class="icon-bar"></span>
41 </button>
42 <a class="navbar-brand" href="../index.html">M_CLI2 </a>
43 </div>
44 <div id="navbar" class="navbar-collapse collapse">
45 <ul class="nav navbar-nav">
46 <li class="dropdown hidden-xs visible-sm visible-md hidden-lg">
47 <a href="#" class="dropdown-toggle"
48 data-toggle="dropdown" role="button"
49 aria-haspopup="true"
50 aria-expanded="false">Contents <span class="caret"></span></a>
51 <ul class="dropdown-menu">
52 <li><a href="../lists/files.html">Source Files</a></li>
53 <li><a href="../lists/modules.html">Modules</a></li>
54 <li><a href="../lists/procedures.html">Procedures</a></li>
55 <li><a href="../lists/types.html">Derived Types</a></li>
56 <li><a href="../lists/programs.html">Programs</a></li>
57
58 </ul>
59
60 </li>
61 <li class="visible-xs hidden-sm visible-lg"><a href="../lists/files.html">Source Files</a></li>
62 <li class="visible-xs hidden-sm visible-lg"><a href="../lists/modules.html">Modules</a></li>
63 <li class="visible-xs hidden-sm visible-lg"><a href="../lists/procedures.html">Procedures</a></li>
64 <li class="visible-xs hidden-sm visible-lg"><a href="../lists/types.html">Derived Types</a></li>
65 <li class="visible-xs hidden-sm visible-lg"><a href="../lists/programs.html">Programs</a></li>
66 </ul>
67 <form action="../search.html" class="navbar-form navbar-right" role="search">
68 <div class="form-group">
69 <input type="text" class="form-control" placeholder="Search" name="q" id="tipue_search_input" autocomplete="off" required>
70 </div>
71 <!--
72 <button type="submit" class="btn btn-default">Submit</button>
73 -->
74 </form>
75 </div><!--/.nav-collapse -->
76 </div>
77 </nav>
78
79 <div class="container">
80 <div class="row">
81 <h1>specified
82 <small>Function</small>
83
84 </h1>
85 <div class="row" id="info-bar">
86 <div class="col-lg-12">
87 <div class="well well-sm">
88 <ul class="list-inline" style="margin-bottom:0px;display:inline">
89
90 <li id="statements"><i class="fa fa-list-ol"></i>
91 <a data-toggle="tooltip"
92 data-placement="bottom" data-html="true"
93 title=" 2.9% of total for procedures.">11 statements</a>
94 </li>
95
96 <li id="source-file">
97 <i class="fa fa-code"></i>
98 <a href="../src/M_CLI2.F90"> Source File</a>
99 </li>
100 </ul>
101 <ol class="breadcrumb in-well text-right">
102 <li><a href='../sourcefile/m_cli2.f90.html'>M_CLI2.F90</a></li>
103 <li><a href='../module/m_cli2.html'>M_CLI2</a></li>
104 <li class="active">specified</li>
105 </ol>
106 </div>
107 </div>
108 </div>
109 <script>
110 $(function () {
111 $('[data-toggle="tooltip"]').tooltip()
112 })
113 </script>
114
115 </div>
116
117 <div class="row">
118 <div class="col-md-3 hidden-xs hidden-sm visible-md visible-lg">
119 <div id="sidebar">
120 <h3>Contents</h3>
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140 <div class="panel panel-primary">
141 <div class="panel-heading text-left"><h3 class="panel-title">Source Code</h3></div>
142 <div class="list-group">
143 <a class="list-group-item" href="../proc/specified.html#src">specified</a>
144 </div>
145 </div>
146
147
148 </div>
149
150 </div>
151
152 <div class="col-md-9" id='text'>
153 <h2>public impure elemental function specified(key)
154 </h2>
155
156
157 <h2 id="name">NAME</h2>
158 <div class="codehilite"><pre><span></span><code><span class="nv">specified</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="o">-</span> [<span class="nv">ARGUMENTS</span>:<span class="nv">M_CLI2</span>] <span class="k">return</span> <span class="nv">true</span> <span class="k">if</span> <span class="nv">keyword</span> <span class="nv">was</span> <span class="nv">present</span>
159 <span class="nv">on</span> <span class="nv">command</span> <span class="nv">line</span>
160 <span class="ss">(</span><span class="nv">LICENSE</span>:<span class="nv">PD</span><span class="ss">)</span>
161 </code></pre></div>
162
163 <h2 id="synopsis">SYNOPSIS</h2>
164 <div class="codehilite"><pre><span></span><code>elemental impure function specified(name)
165
166 character(len=*),intent(in) :: name
167 logical :: specified
168 </code></pre></div>
169
170 <h2 id="description">DESCRIPTION</h2>
171 <div class="codehilite"><pre><span></span><code><span class="nv">specified</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="nv">returns</span> .<span class="nv">true</span>. <span class="k">if</span> <span class="nv">the</span> <span class="nv">specified</span> <span class="nv">keyword</span> <span class="nv">was</span> <span class="nv">present</span> <span class="nv">on</span>
172 <span class="nv">the</span> <span class="nv">command</span> <span class="nv">line</span>.
173
174 <span class="nv">M_CLI2</span> <span class="nv">intentionally</span> <span class="nv">does</span> <span class="nv">not</span> <span class="nv">have</span> <span class="nv">validators</span> <span class="nv">except</span> <span class="k">for</span> <span class="nv">SPECIFIED</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span>
175 <span class="nv">and</span> <span class="nv">of</span> <span class="nv">course</span> <span class="nv">a</span> <span class="nv">check</span> <span class="nv">whether</span> <span class="nv">the</span> <span class="nv">input</span> <span class="nv">conforms</span> <span class="nv">to</span> <span class="nv">the</span> <span class="nv">type</span> <span class="nv">when</span>
176 <span class="nv">requesting</span> <span class="nv">a</span> <span class="nv">value</span> <span class="ss">(</span><span class="nv">with</span> <span class="nv">get_args</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="nv">or</span> <span class="nv">the</span> <span class="nv">convenience</span> <span class="nv">functions</span>
177 <span class="nv">like</span> <span class="nv">inum</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">))</span>.
178
179 <span class="nv">Fortran</span> <span class="nv">already</span> <span class="nv">has</span> <span class="nv">powerful</span> <span class="nv">validation</span> <span class="nv">capabilities</span>. <span class="nv">Logical</span>
180 <span class="nv">expressions</span> <span class="nv">ANY</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="nv">and</span> <span class="nv">ALL</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="nv">are</span> <span class="nv">standard</span> <span class="nv">Fortran</span> <span class="nv">features</span> <span class="nv">which</span>
181 <span class="nv">easily</span> <span class="nv">allow</span> <span class="nv">performing</span> <span class="nv">the</span> <span class="nv">common</span> <span class="nv">validations</span> <span class="k">for</span> <span class="nv">command</span> <span class="nv">line</span>
182 <span class="nv">arguments</span> <span class="nv">without</span> <span class="nv">having</span> <span class="nv">to</span> <span class="nv">learn</span> <span class="nv">any</span> <span class="nv">additional</span> <span class="nv">syntax</span> <span class="nv">or</span> <span class="nv">methods</span>.
183 </code></pre></div>
184
185 <h2 id="options">OPTIONS</h2>
186 <div class="codehilite"><pre><span></span><code>NAME name of commandline argument to query the presence of. Long
187 names should always be used.
188 </code></pre></div>
189
190 <h2 id="returns">RETURNS</h2>
191 <div class="codehilite"><pre><span></span><code><span class="nv">SPECIFIED</span> <span class="nv">returns</span> .<span class="nv">TRUE</span>. <span class="k">if</span> <span class="nv">specified</span> <span class="nv">NAME</span> <span class="nv">was</span> <span class="nv">present</span> <span class="nv">on</span> <span class="nv">the</span> <span class="nv">command</span>
192 <span class="nv">line</span> <span class="nv">when</span> <span class="nv">the</span> <span class="nv">program</span> <span class="nv">was</span> <span class="nv">invoked</span>.
193 </code></pre></div>
194
195 <h2 id="example">EXAMPLE</h2>
196 <p>Sample program:</p>
197 <div class="codehilite"><pre><span></span><code><span class="nv">program</span> <span class="nv">demo_specified</span>
198 <span class="nv">use</span>, <span class="nv">intrinsic</span> :: <span class="nv">iso_fortran_env</span>, <span class="nv">only</span> : <span class="o">&amp;</span>
199 <span class="o">&amp;</span> <span class="nv">stderr</span><span class="o">=&gt;</span><span class="nv">ERROR_UNIT</span>, <span class="nv">stdin</span><span class="o">=&gt;</span><span class="nv">INPUT_UNIT</span>, <span class="nv">stdout</span><span class="o">=&gt;</span><span class="nv">OUTPUT_UNIT</span>
200 <span class="nv">use</span> <span class="nv">M_CLI2</span>, <span class="nv">only</span> : <span class="nv">set_args</span>, <span class="nv">igets</span>, <span class="nv">rgets</span>, <span class="nv">specified</span>, <span class="nv">sget</span>, <span class="nv">lget</span>
201 <span class="nv">implicit</span> <span class="nv">none</span>
202
203 <span class="o">!</span> <span class="nv">Define</span> <span class="nv">args</span>
204 <span class="nv">integer</span>,<span class="nv">allocatable</span> :: <span class="nv">ints</span><span class="ss">(</span>:<span class="ss">)</span>
205 <span class="nv">real</span>,<span class="nv">allocatable</span> :: <span class="nv">floats</span><span class="ss">(</span>:<span class="ss">)</span>
206 <span class="nv">logical</span> :: <span class="nv">flag</span>
207 <span class="nv">character</span><span class="ss">(</span><span class="nv">len</span><span class="o">=</span>:<span class="ss">)</span>,<span class="nv">allocatable</span> :: <span class="nv">color</span>
208 <span class="nv">character</span><span class="ss">(</span><span class="nv">len</span><span class="o">=</span>:<span class="ss">)</span>,<span class="nv">allocatable</span> :: <span class="nv">list</span><span class="ss">(</span>:<span class="ss">)</span>
209 <span class="nv">integer</span> :: <span class="nv">i</span>
210
211 <span class="k">call</span> <span class="nl">set_args</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">&amp;</span>
212 <span class="o">&amp;</span> <span class="o">--</span><span class="nv">color</span>:<span class="nv">c</span> <span class="s2">&quot;</span><span class="s">red</span><span class="s2">&quot;</span> <span class="o">&amp;</span>
213 <span class="o">&amp;</span> <span class="o">--</span><span class="nv">flag</span>:<span class="nv">f</span> <span class="nv">F</span> <span class="o">&amp;</span>
214 <span class="o">&amp;</span> <span class="o">--</span><span class="nv">ints</span>:<span class="nv">i</span> <span class="mi">1</span>,<span class="mi">10</span>,<span class="mi">11</span> <span class="o">&amp;</span>
215 <span class="o">&amp;</span> <span class="o">--</span><span class="nv">floats</span>:<span class="nv">T</span> <span class="mi">12</span>.<span class="mi">3</span>, <span class="mi">4</span>.<span class="mi">56</span> <span class="o">&amp;</span>
216 <span class="o">&amp;</span> <span class="s1">&#39;</span><span class="s">)</span>
217 <span class="nv">ints</span><span class="o">=</span><span class="nv">igets</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">ints</span><span class="s1">&#39;</span><span class="ss">)</span>
218 <span class="nv">floats</span><span class="o">=</span><span class="nv">rgets</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span><span class="ss">)</span>
219 <span class="nv">flag</span><span class="o">=</span><span class="nv">lget</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">flag</span><span class="s1">&#39;</span><span class="ss">)</span>
220 <span class="nv">color</span><span class="o">=</span><span class="nv">sget</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">color</span><span class="s1">&#39;</span><span class="ss">)</span>
221
222 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">color=</span><span class="s1">&#39;</span>,<span class="nv">color</span>
223 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">flag=</span><span class="s1">&#39;</span>,<span class="nv">flag</span>
224 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">ints=</span><span class="s1">&#39;</span>,<span class="nv">ints</span>
225 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">floats=</span><span class="s1">&#39;</span>,<span class="nv">floats</span>
226
227 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">was -flag specified?</span><span class="s1">&#39;</span>,<span class="nv">specified</span><span class="ss">(</span><span class="s1">&#39;</span><span class="s">flag</span><span class="s1">&#39;</span><span class="ss">)</span>
228
229 <span class="o">!</span> <span class="nv">elemental</span>
230 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">specified</span><span class="ss">(</span>[<span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">ints </span><span class="s1">&#39;</span>]<span class="ss">)</span>
231
232 <span class="o">!</span> <span class="k">If</span> <span class="nv">you</span> <span class="nv">want</span> <span class="nv">to</span> <span class="nv">know</span> <span class="k">if</span> <span class="nv">groups</span> <span class="nv">of</span> <span class="nv">parameters</span> <span class="nv">were</span> <span class="nv">specified</span> <span class="nv">use</span>
233 <span class="o">!</span> <span class="nv">ANY</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span> <span class="nv">and</span> <span class="nv">ALL</span><span class="ss">(</span><span class="mi">3</span><span class="nv">f</span><span class="ss">)</span>
234 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">ANY:</span><span class="s1">&#39;</span>,<span class="nv">any</span><span class="ss">(</span><span class="nv">specified</span><span class="ss">(</span>[<span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">ints </span><span class="s1">&#39;</span>]<span class="ss">))</span>
235 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">ALL:</span><span class="s1">&#39;</span>,<span class="nv">all</span><span class="ss">(</span><span class="nv">specified</span><span class="ss">(</span>[<span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">ints </span><span class="s1">&#39;</span>]<span class="ss">))</span>
236
237 <span class="o">!</span> <span class="k">For</span> <span class="nv">mutually</span> <span class="nv">exclusive</span>
238 <span class="k">if</span> <span class="ss">(</span><span class="nv">all</span><span class="ss">(</span><span class="nv">specified</span><span class="ss">(</span>[<span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">ints </span><span class="s1">&#39;</span>]<span class="ss">)))</span><span class="k">then</span>
239 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">You specified both names --ints and --floats</span><span class="s1">&#39;</span>
240 <span class="k">endif</span>
241
242 <span class="o">!</span> <span class="k">For</span> <span class="nv">required</span> <span class="nv">parameter</span>
243 <span class="k">if</span> <span class="ss">(</span>.<span class="nv">not</span>.<span class="nv">any</span><span class="ss">(</span><span class="nv">specified</span><span class="ss">(</span>[<span class="s1">&#39;</span><span class="s">floats</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">ints </span><span class="s1">&#39;</span>]<span class="ss">)))</span><span class="k">then</span>
244 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">You must specify --ints or --floats</span><span class="s1">&#39;</span>
245 <span class="k">endif</span>
246
247 <span class="o">!</span> <span class="nv">check</span> <span class="k">if</span> <span class="nv">all</span> <span class="nv">values</span> <span class="nv">are</span> <span class="nv">in</span> <span class="nv">range</span> <span class="nv">from</span> <span class="mi">10</span> <span class="nv">to</span> <span class="mi">30</span> <span class="nv">and</span> <span class="nv">even</span>
248 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">are all numbers good?</span><span class="s1">&#39;</span>,<span class="nv">all</span><span class="ss">(</span>[<span class="nv">ints</span> <span class="o">&gt;=</span> <span class="mi">10</span>,<span class="nv">ints</span> <span class="o">&lt;=</span> <span class="mi">30</span>,<span class="ss">(</span><span class="nv">ints</span><span class="o">/</span><span class="mi">2</span><span class="ss">)</span><span class="o">*</span><span class="mi">2</span> <span class="o">==</span> <span class="nv">ints</span>]<span class="ss">)</span>
249
250 <span class="o">!</span> <span class="nv">perhaps</span> <span class="nv">you</span> <span class="nv">want</span> <span class="nv">to</span> <span class="nv">check</span> <span class="nv">one</span> <span class="nv">value</span> <span class="nv">at</span> <span class="nv">a</span> <span class="nv">time</span>
251 <span class="k">do</span> <span class="nv">i</span><span class="o">=</span><span class="mi">1</span>,<span class="nv">size</span><span class="ss">(</span><span class="nv">ints</span><span class="ss">)</span>
252 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span>,[<span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span> <span class="o">&gt;=</span> <span class="mi">10</span>,<span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span> <span class="o">&lt;=</span> <span class="mi">30</span>,<span class="ss">(</span><span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span><span class="o">/</span><span class="mi">2</span><span class="ss">)</span><span class="o">*</span><span class="mi">2</span> <span class="o">==</span> <span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span>]
253 <span class="k">if</span><span class="ss">(</span><span class="nv">all</span><span class="ss">(</span>[<span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span> <span class="o">&gt;=</span> <span class="mi">10</span>,<span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span> <span class="o">&lt;=</span> <span class="mi">30</span>,<span class="ss">(</span><span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span><span class="o">/</span><span class="mi">2</span><span class="ss">)</span><span class="o">*</span><span class="mi">2</span> <span class="o">==</span> <span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span>]<span class="ss">)</span> <span class="ss">)</span><span class="k">then</span>
254 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span>,<span class="s1">&#39;</span><span class="s">is an even number from 10 to 30 inclusive</span><span class="s1">&#39;</span>
255 <span class="k">else</span>
256 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">ints</span><span class="ss">(</span><span class="nv">i</span><span class="ss">)</span>,<span class="s1">&#39;</span><span class="s">is not an even number from 10 to 30 inclusive</span><span class="s1">&#39;</span>
257 <span class="k">endif</span>
258 <span class="nv">enddo</span>
259
260 <span class="nv">list</span> <span class="o">=</span> [<span class="nv">character</span><span class="ss">(</span><span class="nv">len</span><span class="o">=</span><span class="mi">10</span><span class="ss">)</span> :: <span class="s1">&#39;</span><span class="s">red</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">white</span><span class="s1">&#39;</span>,<span class="s1">&#39;</span><span class="s">blue</span><span class="s1">&#39;</span>]
261 <span class="k">if</span><span class="ss">(</span> <span class="nv">any</span><span class="ss">(</span><span class="nv">color</span> <span class="o">==</span> <span class="nv">list</span><span class="ss">)</span> <span class="ss">)</span><span class="k">then</span>
262 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">color</span>,<span class="s1">&#39;</span><span class="s">matches a value in the list</span><span class="s1">&#39;</span>
263 <span class="k">else</span>
264 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="nv">color</span>,<span class="s1">&#39;</span><span class="s">not in the list</span><span class="s1">&#39;</span>
265 <span class="k">endif</span>
266
267 <span class="k">if</span><span class="ss">(</span><span class="nv">size</span><span class="ss">(</span><span class="nv">ints</span><span class="ss">)</span>.<span class="nv">eq</span>.<span class="mi">3</span><span class="ss">)</span><span class="k">then</span>
268 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">ints(:) has expected number of values</span><span class="s1">&#39;</span>
269 <span class="k">else</span>
270 <span class="nv">write</span><span class="ss">(</span><span class="o">*</span>,<span class="o">*</span><span class="ss">)</span><span class="s1">&#39;</span><span class="s">ints(:) does not have expected number of values</span><span class="s1">&#39;</span>
271 <span class="k">endif</span>
272
273 <span class="k">end</span> <span class="nv">program</span> <span class="nv">demo_specified</span>
274 </code></pre></div>
275
276 <p>Default output</p>
277 <blockquote>
278 <p>color=red
279 flag= F
280 ints= 1 10 11
281 floats= 12.3000002 4.55999994
282 was -flag specified? F
283 F F
284 ANY: F
285 ALL: F
286 You must specify &ndash;ints or &ndash;floats
287 1 F T F
288 1 is not an even number from 10 to 30 inclusive
289 10 T T T
290 10 is an even number from 10 to 30 inclusive
291 11 T T F
292 11 is not an even number from 10 to 30 inclusive
293 red matches a value in the list
294 ints(:) has expected number of values</p>
295 </blockquote>
296 <h2 id="author">AUTHOR</h2>
297 <div class="codehilite"><pre><span></span><code> John S. Urban, 2019
298 </code></pre></div>
299
300 <h2 id="license">LICENSE</h2>
301 <div class="codehilite"><pre><span></span><code> Public Domain
302 </code></pre></div>
303
304 <h3>Arguments</h3>
305 <table class="table table-striped varlist">
306 <thead>
307 <tr>
308 <th>Type</th>
309 <th>Intent</th><th>Optional</th> <th>Attributes</th>
310 <th></th>
311 <th>Name</th>
312 <th></th>
313 </thead>
314 <tbody>
315 <tr>
316 <td>
317 <span class="anchor" id="variable-key"></span>
318 character(len=*),
319 </td>
320 <td>intent(in)</td>
321 <td></td> <td>
322
323 </td>
324 <td>::</td>
325 <td><strong>key</strong></td>
326 <td>
327
328 </td>
329 </tr>
330 </tbody>
331 </table>
332
333 <h3>Return Value
334 <small>
335 <span class="anchor" id="variable-specified"></span>
336 logical
337 </small>
338 </h3>
339
340 <br>
341
342 <section class="visible-xs visible-sm hidden-md">
343 <h3>Contents</h3>
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363 <div class="panel panel-primary">
364 <div class="panel-heading text-left"><h3 class="panel-title">Source Code</h3></div>
365 <div class="list-group">
366 <a class="list-group-item" href="../proc/specified.html#src">specified</a>
367 </div>
368 </div>
369
370
371 </section>
372 <br class="visible-xs visible-sm hidden-md">
373
374
375
376
377
378
379
380
381
382
383 <section>
384 <h2><span class="anchor" id="src"></span>Source Code</h2>
385 <div class="highlight"><pre><span></span><span class="k">elemental impure function </span><span class="n">specified</span><span class="p">(</span><span class="n">key</span><span class="p">)</span><span class="w"></span>
386 <span class="kt">character</span><span class="p">(</span><span class="nb">len</span><span class="o">=*</span><span class="p">),</span><span class="k">intent</span><span class="p">(</span><span class="n">in</span><span class="p">)</span><span class="w"> </span><span class="kd">::</span><span class="w"> </span><span class="n">key</span><span class="w"></span>
387 <span class="kt">logical</span><span class="w"> </span><span class="kd">::</span><span class="w"> </span><span class="n">specified</span><span class="w"></span>
388 <span class="kt">integer</span><span class="w"> </span><span class="kd">::</span><span class="w"> </span><span class="n">place</span><span class="w"></span>
389 <span class="w"> </span><span class="k">call </span><span class="n">locate_key</span><span class="p">(</span><span class="n">key</span><span class="p">,</span><span class="n">place</span><span class="p">)</span><span class="w"> </span><span class="c">! find where string is or should be</span>
390 <span class="w"> </span><span class="k">if</span><span class="p">(</span><span class="n">place</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="mi">1</span><span class="p">)</span><span class="k">then</span>
391 <span class="k"> </span><span class="n">specified</span><span class="o">=</span><span class="p">.</span><span class="n">false</span><span class="p">.</span><span class="w"></span>
392 <span class="w"> </span><span class="k">else</span>
393 <span class="k"> </span><span class="n">specified</span><span class="o">=</span><span class="n">present_in</span><span class="p">(</span><span class="n">place</span><span class="p">)</span><span class="w"></span>
394 <span class="w"> </span><span class="k">endif</span>
395 <span class="k">end function </span><span class="n">specified</span><span class="w"></span>
396 </pre></div>
397
398 </section>
399 <br>
400
401 </div>
402 </div>
403
404 <hr>
405 </div> <!-- /container -->
406 <footer>
407 <div class="container">
408 <div class="row">
409 <div class="col-xs-6 col-md-6"><p>M_CLI2 was developed by John S. Urban<br>&copy; 2023
410 </p>
411 </div>
412 <div class="col-xs-6 col-md-6">
413 <p class="text-right">
414 Documentation generated by
415 <a href="https://github.com/Fortran-FOSS-Programmers/ford">FORD</a>
416 on 2023-02-10 18:53 </p>
417 </div>
418 </div>
419 <br>
420 </div> <!-- /container -->
421 </footer>
422
423 <!-- Bootstrap core JavaScript
424 ================================================== -->
425 <!-- Placed at the end of the document so the pages load faster -->
426 <!--
427 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
428 -->
429 <script src="../js/bootstrap.min.js"></script>
430 <!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
431 <script src="../js/ie10-viewport-bug-workaround.js"></script>
432
433 <!-- MathJax JavaScript
434 ================================================== -->
435 <!-- Placed at the end of the document so the pages load faster -->
436 <script type="text/x-mathjax-config">
437 MathJax.Hub.Config({
438 TeX: { extensions: ['AMSmath.js','AMSsymbols.js','noErrors.js','noUndefined.js'], equationNumbers: { autoNumber: 'AMS' } },
439 jax: ['input/TeX','input/MathML','output/HTML-CSS'],
440 extensions: ['tex2jax.js','mml2jax.js','MathMenu.js','MathZoom.js']
441 });
442 </script>
443 <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
444
445 <script src="../tipuesearch/tipuesearch_content.js"></script>
446 <script src="../tipuesearch/tipuesearch_set.js"></script>
447 <script src="../tipuesearch/tipuesearch.js"></script>
448
449 </body>
450 </html>