<p>Friendly Automation <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/13542">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  Joshua Colp: Looks good to me, but someone else must approve
  George Joseph: Looks good to me, approved
  Friendly Automation: Approved for Submit

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">res_agi: Improve GET FULL VARIABLE documentation<br><br>ASTERISK-28673 #close<br>Reported by: Jonathan Harris<br><br>Change-Id: I591afdec669622bfa19243aabec31b579652c92f<br>---<br>M res/res_agi.c<br>1 file changed, 13 insertions(+), 7 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/res/res_agi.c b/res/res_agi.c</span><br><span>index d88d511..6f8815d 100644</span><br><span>--- a/res/res_agi.c</span><br><span>+++ b/res/res_agi.c</span><br><span>@@ -323,15 +323,21 @@</span><br><span>                    Evaluates a channel expression</span><br><span>               </synopsis></span><br><span>            <syntax></span><br><span style="color: hsl(0, 100%, 40%);">-                  <parameter name="variablename" required="true" /></span><br><span style="color: hsl(0, 100%, 40%);">-                     <parameter name="channel name" /></span><br><span style="color: hsl(120, 100%, 40%);">+                     <parameter name="expression" required="true" /></span><br><span style="color: hsl(120, 100%, 40%);">+                     <parameter name="channelname" /></span><br><span>             </syntax></span><br><span>              <description></span><br><span style="color: hsl(0, 100%, 40%);">-                     <para>Returns <literal>0</literal> if <replaceable>variablename</replaceable> is not set</span><br><span style="color: hsl(0, 100%, 40%);">-                  or channel does not exist. Returns <literal>1</literal> if <replaceable>variablename</replaceable></span><br><span style="color: hsl(0, 100%, 40%);">-                      is set and returns the variable in parenthesis. Understands complex variable names and builtin</span><br><span style="color: hsl(0, 100%, 40%);">-                  variables, unlike GET VARIABLE.</para></span><br><span style="color: hsl(0, 100%, 40%);">-                    <para>Example return code: 200 result=1 (testvariable)</para></span><br><span style="color: hsl(120, 100%, 40%);">+                     <para>Evaluates the given <replaceable>expression</replaceable> against the</span><br><span style="color: hsl(120, 100%, 40%);">+                 channel specified by <replaceable>channelname</replaceable>, or the current</span><br><span style="color: hsl(120, 100%, 40%);">+                       channel if <replaceable>channelname</replaceable> is not provided.</para></span><br><span style="color: hsl(120, 100%, 40%);">+                   <para>Unlike GET VARIABLE, the <replaceable>expression</replaceable> is</span><br><span style="color: hsl(120, 100%, 40%);">+                     processed in a manner similar to dialplan evaluation, allowing complex</span><br><span style="color: hsl(120, 100%, 40%);">+                        and built-in variables to be accessed, e.g. <literal>The time is</span><br><span style="color: hsl(120, 100%, 40%);">+                        ${EPOCH}</literal></para></span><br><span style="color: hsl(120, 100%, 40%);">+                 <para>Returns <literal>0</literal> if no channel matching</span><br><span style="color: hsl(120, 100%, 40%);">+                   <replaceable>channelname</replaceable> exists, <literal>1</literal></span><br><span style="color: hsl(120, 100%, 40%);">+                   otherwise.</para></span><br><span style="color: hsl(120, 100%, 40%);">+                       <para>Example return code: 200 result=1 (The time is 1578493800)</para></span><br><span>          </description></span><br><span>                 <see-also></span><br><span>                     <ref type="agi">get variable</ref></span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/13542">change 13542</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/13542"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 16 </div>
<div style="display:none"> Gerrit-Change-Id: I591afdec669622bfa19243aabec31b579652c92f </div>
<div style="display:none"> Gerrit-Change-Number: 13542 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Sean Bright <sean.bright@gmail.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Joshua Colp <jcolp@sangoma.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>