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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Asterisk Project : Application_Goto</title>
<link rel="stylesheet" href="styles/site.css" type="text/css" />
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
<tr>
<td valign="top" class="pagebody">
<div class="pageheader">
<span class="pagetitle">
Asterisk Project : Application_Goto
</span>
</div>
<div class="pagesubheading">
This page last changed on Jun 18, 2011 by <font color="#0050B2">wikibot</font>.
</div>
<h1><a name="Application_Goto-Goto%28%29"></a>Goto()</h1>
<h3><a name="Application_Goto-Synopsis"></a>Synopsis</h3>
<p>Jump to a particular priority, extension, or context.</p>
<h3><a name="Application_Goto-Description"></a>Description</h3>
<p>This application will set the current context, extension, and priority in the channel structure. After it completes, the pbx engine will continue dialplan execution at the specified location. If no specific <em>extension</em>, or <em>extension</em> and <em>context</em>, are specified, then this application will just set the specified <em>priority</em> of the current extension. </p>
<p>At least a <em>priority</em> is required as an argument, or the goto will return a <tt>-1</tt>, and the channel and call will be terminated. </p>
<p>If the location that is put into the channel information is bogus, and asterisk cannot find that location in the dialplan, then the execution engine will try to find and execute the code in the <tt>i</tt> (invalid) extension in the current context. If that does not exist, it will try to execute the <tt>h</tt> extension. If neither the <tt>h</tt> nor <tt>i</tt> extensions have been defined, the channel is hung up, and the execution of instructions on the channel is terminated. What this means is that, for example, you specify a context that does not exist, then it will not be possible to find the <tt>h</tt> or <tt>i</tt> extensions, and the call will terminate!</p>
<h3><a name="Application_Goto-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>Goto([context[,extensions,priority]])</pre>
</div></div>
<h5><a name="Application_Goto-Arguments"></a>Arguments</h5>
<ul>
<li><tt>context</tt></li>
<li><tt>extensions</tt></li>
<li><tt>priority</tt></li>
</ul>
<h3><a name="Application_Goto-SeeAlso"></a>See Also</h3>
<p><a href="Application_GotoIf.html" title="Application_GotoIf">Application_GotoIf</a><br/>
<a href="Application_GotoIfTime.html" title="Application_GotoIfTime">Application_GotoIfTime</a><br/>
<a href="Application_Gosub.html" title="Application_Gosub">Application_Gosub</a><br/>
<a href="Application_Macro.html" title="Application_Macro">Application_Macro</a></p>
<h3><a name="Application_Goto-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-1.8-r324178.</p>
</td>
</tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td height="12" background="https://wiki.asterisk.org/wiki/images/border/border_bottom.gif"><img src="images/border/spacer.gif" width="1" height="1" border="0"/></td>
</tr>
<tr>
<td align="center"><font color="grey">Document generated by Confluence on Oct 04, 2011 12:42</font></td>
</tr>
</table>
</body>
</html>
|