/usr/share/doc/libcnf-dev/html/node108.html is in libcnf-dev 4.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 98.2 beta6 (August 14th, 1998)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>DECLARE_CHARACTER_DYN
- Declare a CHARACTER variable
</TITLE>
<META NAME="description" CONTENT="DECLARE_CHARACTER_DYN
- Declare a CHARACTER variable
">
<META NAME="keywords" CONTENT="sun209">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<LINK REL="STYLESHEET" HREF="sun209.css">
<LINK REL="next" HREF="node109.html">
<LINK REL="previous" HREF="node107.html">
<LINK REL="up" HREF="node77.html">
<LINK REL="next" HREF="node109.html">
</HEAD>
<BODY >
<BR> <HR>
<A NAME="tex2html1397"
HREF="node109.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
<A NAME="tex2html1395"
HREF="node77.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
<A NAME="tex2html1389"
HREF="node107.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> <A HREF="sun209.html#stardoccontents"><IMG
ALIGN="BOTTOM" BORDER="0" SRC="contents_motif.gif"
ALT="252"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1398"
HREF="node109.html">F77_BLANK_COMMON - Refer to blank common</A>
<BR>
<B>Up:</B> <A NAME="tex2html1396"
HREF="node77.html">Full Description of F77 Macros</A>
<BR>
<B> Previous:</B> <A NAME="tex2html1390"
HREF="node107.html">DECLARE_CHARACTER_ARRAY - Declare a CHARACTER array</A>
<BR> <HR> <P>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION0001931000000000000000"></A><A NAME="xref_DECLARE_CHARACTER_DYN"></A><A NAME="DECLARE_CHARACTER_DYN"></A>
<BR>
DECLARE_CHARACTER_DYN
- Declare a CHARACTER variable
</H2>
<DL>
<DT><STRONG>Description:</STRONG>
<DD><DL>
<DD>Declare a CHARACTER variable that will be passed to a FORTRAN routine
using the CHARACTER_ARG macro. Use this macro, in combination with
the F77_CREATE_CHARACTER and F77_FREE_CHARACTER
macros, where the length of the CHARACTER string is not known until
run time.
</DL>
<BR>
<DT><STRONG>Invocation:</STRONG>
<DD><DL>
<DD><TT> DECLARE_CHARACTER_DYN(arg)
</TT>
</DL>
<BR>
<DT><STRONG>Arguments:</STRONG>
<DD>
<BR>
<DL>
<DT><STRONG>
arg
</STRONG>
<DD>
The variable being declared.
</DL>
<BR>
<DT><STRONG>Examples:</STRONG>
<DD>
<BR>
<DL>
<DT><STRONG><TT> DECLARE_CHARACTER_DYN(fstring)
</TT></STRONG>
<DD>will expand as follows:
<P>
<TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT">All Unix:</TD>
<TD ALIGN="LEFT"><TT> char *fstring; int fstring_length</TT></TD>
</TR>
<TR><TD ALIGN="LEFT">VAX/VMS:</TD>
<TD ALIGN="LEFT"><TT> char *fstring; int fstring_length</TT></TD>
</TR>
<TR><TD ALIGN="LEFT"> </TD>
<TD ALIGN="LEFT"><TT> struct dsc$descriptor_s *fstring_arg</TT></TD>
</TR>
</TABLE></DL>
<BR>
<DT><STRONG>Notes:</STRONG>
<DD>On VMS, the expansion of the macro is quite complex.
A pointer to a descriptor structure is declared in addition to a
pointer to char (used to point to the actual string of characters)
and an int variable to store the length of the array. The address
of the descriptor is what is actually passed to the called FORTRAN
routine.
</DL>
<P>
<BR> <HR>
<A NAME="tex2html1397"
HREF="node109.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
<A NAME="tex2html1395"
HREF="node77.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
<A NAME="tex2html1389"
HREF="node107.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A> <A HREF="sun209.html#stardoccontents"><IMG
ALIGN="BOTTOM" BORDER="0" SRC="contents_motif.gif"
ALT="252"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1398"
HREF="node109.html">F77_BLANK_COMMON - Refer to blank common</A>
<BR>
<B>Up:</B> <A NAME="tex2html1396"
HREF="node77.html">Full Description of F77 Macros</A>
<BR>
<B> Previous:</B> <A NAME="tex2html1390"
HREF="node107.html">DECLARE_CHARACTER_ARRAY - Declare a CHARACTER array</A>
<BR> <HR> <P>
<!--End of Navigation Panel-->
<ADDRESS>
<I>CNF and F77 Mixed Language Programming -- FORTRAN and C<BR>Starlink User Note 209<BR>P.M. Allan<BR>A.J. Chipperfield<BR>R.F. Warren-Smith<BR>19 January 2000<BR>E-mail:<A HREF="mailto:ussc@star.rl.ac.uk">ussc@star.rl.ac.uk</A></I>
</ADDRESS>
</BODY>
</HTML>
|