File: array.html

package info (click to toggle)
ftnchek 2.11.2-2
  • links: PTS
  • area: main
  • in suites: potato
  • size: 5,392 kB
  • ctags: 2,790
  • sloc: ansic: 21,570; fortran: 2,921; yacc: 2,794; sh: 1,623; makefile: 693; lisp: 264; awk: 163
file content (59 lines) | stat: -rw-r--r-- 2,938 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
<HTML>
<HEAD>
<TITLE>Option: array</TITLE>
</HEAD>
<BODY>
<A HREF="toc.html">Table of Contents</A><P>
<P>Previous: <A HREF="arguments.html">-arguments</A><HR><P>
<H2>Option: <font color=#FF0080>array</font></H2><P>
<A NAME="array"></A><DT><B><A HREF="array.html">-array</A>=</B><I>list</I>  </DT>
<DD>Controls the degree of strictness in checking agreement 
between actual and dummy subprogram arguments that are arrays. The warnings 
controlled by this setting are for constructions that might legitimately 
be used by a knowledgeable programmer, but that often indicate programming 
errors. By default, all warnings are turned on.  <blockquote></DD>
</DL>
<P>
The <I>list </I> consists of keywords 
separated by commas or colons. Since all these warnings are on by default, 
include a keyword prefixed by <B>no- </B> to turn off a particular warning. There 
are three special keywords: <B>all </B> to turn on all the warnings about array 
arguments, <B>none </B> to turn them all off, and <B>help </B> to print the list of 
all the keywords with a brief explanation of each. If <I>list </I> is omitted, 
<B><A HREF="array.html">-array</A> </B> is equivalent to <B><A HREF="array.html">-array</A>=all </B>, and <B>-noarray </B> is equivalent to <B><A HREF="array.html">-array</A>=none 
</B>. The warning keywords with their meanings are as follows: 
<DL>

<DT><B>dimensions</B>: 
 </DT>
<DD>warn if the arguments differ in their number of dimensions, or if the 
actual argument is an array element while the dummy argument is a whole 
array. </DD>

<DT><B>size</B>:  </DT>
<DD>warn if both arguments are arrays, but they differ in number 
of elements. </DD>
</DL>
<P>
For compatibility with previous versions of <B>ftnchek </B>,  a numeric 
form of this setting is also accepted: the <I>list </I> is replaced by a number 
from 0 to 3.  A value of 0 turns all the warnings off, 1 turns on only 
<B>dimensions </B>, 2 turns on only <B>size </B>, and 3 turns all the warnings on. <P>
Note: 
A warning is always given regardless of this setting if the actual argument 
is an array while the dummy argument is a scalar variable, or if the actual 
argument is a scalar variable or expression while the dummy argument is 
an array.  These cases are seldom intentional. (To turn off even these warnings, 
use <B><A HREF="arguments.html">-arguments</A>=no-arrayness </B>.) No warning is ever given if the actual argument 
is an array element while the dummy argument is a scalar variable. Variable-dimensioned 
arrays and arrays dimensioned with 1 or asterisk match any number of array 
elements. There is no check of whether multi-dimensional arrays agree in 
the size of each dimension separately. <P>
See also: <B><A HREF="arguments.html">-arguments</A> </B>, <B><A HREF="library.html">-library</A> </B>, 
<B><A HREF="usage.html">-usage</A> </B>.  </blockquote>
<P>
 
<DL>

<P><HR><P>Next: <A HREF="calltree.html">-calltree</A>
</BODY></HTML>