<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
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>Call</TITLE>
<META NAME="description" CONTENT="Call">
<META NAME="keywords" CONTENT="gnuplot">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="gnuplot.css">
<LINK REL="next" HREF="node91.html">
<LINK REL="previous" HREF="node89.html">
<LINK REL="up" HREF="node88.html">
<LINK REL="next" HREF="node91.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html2260"
HREF="node91.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html2254"
HREF="node88.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html2248"
HREF="node89.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html2256"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html2258"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2261"
HREF="node91.html">Clear</A>
<B> Up:</B> <A NAME="tex2html2255"
HREF="node88.html">Commands</A>
<B> Previous:</B> <A NAME="tex2html2249"
HREF="node89.html">Cd</A>
<B> <A NAME="tex2html2257"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html2259"
HREF="node467.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION04020000000000000000"></A>
<A NAME="commands_call"></A><A NAME="call"></A><A NAME="2120"></A>
<BR>
Call
</H1>
The <B>call</B> command is identical to the load command with one exception: you
can have up to ten additional parameters to the command (delimited according
to the standard parser rules) which can be substituted into the lines read
from the file. As each line is read from the <B>call</B>ed input file, it is
scanned for the sequence <B>$</B> (dollar-sign) followed by a digit (0-9). If
found, the sequence is replaced by the corresponding parameter from the
<B>call</B> command line. If the parameter was specified as a string in the
<B>call</B> line, it is substituted without its enclosing quotes. Sequence <B>$#</B>
is replaced by the number of passed parameters. <B>$</B> followed by any character
will be that character; e.g. use <B>$$</B> to get a single <B>$</B>. Providing more
than ten parameters on the <B>call</B> command line will cause an error. A
parameter that was not provided substitutes as nothing. Files being <B>call</B>ed
may themselves contain <B>call</B> or <B>load</B> commands.
<P>
Syntax:
<BR>
<PRE>
call "<input-file>" <parameter-0> <parm-1> ... <parm-9>
</PRE>
<BR>
<P>
The name of the input file must be enclosed in quotes, and it is recommended
that parameters are similarly enclosed in quotes (future versions of gnuplot
may treat quoted and unquoted arguments differently).
<P>
Example:
<P>
If the file 'calltest.gp' contains the line:
<BR>
<PRE>
print "argc=$# p0=$0 p1=$1 p2=$2 p3=$3 p4=$4 p5=$5 p6=$6 p7=x$7x"
</PRE>
<BR>
<P>
entering the command:
<BR>
<PRE>
call 'calltest.gp' "abcd" 1.2 + "'quoted'" -- "$2"
</PRE>
<BR>
<P>
will display:
<BR>
<PRE>
argc=7 p0=abcd p1=1.2 p2=+ p3='quoted' p4=- p5=- p6=$2 p7=xx
</PRE>
<BR>
<P>
NOTE: there is a clash in syntax with the datafile <B>using</B> callback
operator. Use <B>$$n</B> or <B>column(n)</B> to access column n from a datafile inside
a <B>call</B>ed datafile plot.
<HR>
<!--Navigation Panel-->
<A NAME="tex2html2260"
HREF="node91.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html2254"
HREF="node88.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html2248"
HREF="node89.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html2256"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html2258"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2261"
HREF="node91.html">Clear</A>
<B> Up:</B> <A NAME="tex2html2255"
HREF="node88.html">Commands</A>
<B> Previous:</B> <A NAME="tex2html2249"
HREF="node89.html">Cd</A>
<B> <A NAME="tex2html2257"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html2259"
HREF="node467.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
2010-08-17
</ADDRESS>
</BODY>
</HTML>
