Asterisk-13-Function_SHARED_29394662.html 4.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Asterisk Project : Asterisk 13 Function_SHARED</title>
  5. <link rel="stylesheet" href="styles/site.css" type="text/css" />
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. </head>
  8. <body class="theme-default aui-theme-default">
  9. <div id="page">
  10. <div id="main" class="aui-page-panel">
  11. <div id="main-header">
  12. <div id="breadcrumb-section">
  13. <ol id="breadcrumbs">
  14. <li class="first">
  15. <span><a href="index.html">Asterisk Project</a></span>
  16. </li>
  17. <li>
  18. <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
  19. </li>
  20. <li>
  21. <span><a href="Asterisk-13-Dialplan-Functions_29394287.html">Asterisk 13 Dialplan Functions</a></span>
  22. </li>
  23. </ol>
  24. </div>
  25. <h1 id="title-heading" class="pagetitle">
  26. <span id="title-text">
  27. Asterisk Project : Asterisk 13 Function_SHARED
  28. </span>
  29. </h1>
  30. </div>
  31. <div id="content" class="view">
  32. <div class="page-metadata">
  33. Created by <span class='author'> wikibot</span> on Aug 08, 2014
  34. </div>
  35. <div id="main-content" class="wiki-content group">
  36. <h1 id="Asterisk13Function_SHARED-SHARED()">SHARED()</h1>
  37. <h3 id="Asterisk13Function_SHARED-Synopsis">Synopsis</h3>
  38. <p>Gets or sets the shared variable specified.</p>
  39. <h3 id="Asterisk13Function_SHARED-Description">Description</h3>
  40. <p>Implements a shared variable area, in which you may share variables between channels.</p>
  41. <p>The variables used in this space are separate from the general namespace of the channel and thus <code>SHARED(foo)</code> and <code>foo</code> represent two completely different variables, despite sharing the same name.</p>
  42. <p>Finally, realize that there is an inherent race between channels operating at the same time, fiddling with each others' internal variables, which is why this special variable namespace exists; it is to remind you that variables in the SHARED namespace may change at any time, without warning. You should therefore take special care to ensure that when using the SHARED namespace, you retrieve the variable and store it in a regular channel variable before using it in a set of calculations (or you might be surprised by the result).</p>
  43. <h3 id="Asterisk13Function_SHARED-Syntax">Syntax</h3>
  44. <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
  45. <pre>SHARED(varname,channel)</pre>
  46. </div></div>
  47. <h5 id="Asterisk13Function_SHARED-Arguments">Arguments</h5>
  48. <ul>
  49. <li><code>varname</code> - Variable name</li>
  50. <li><code>channel</code> - If not specified will default to current channel. It is the complete channel name: <code>SIP/12-abcd1234</code> or the prefix only <code>SIP/12</code>.</li>
  51. </ul>
  52. <h3 id="Asterisk13Function_SHARED-SeeAlso">See Also</h3>
  53. <h3 id="Asterisk13Function_SHARED-ImportVersion">Import Version</h3>
  54. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
  55. </div>
  56. </div> </div>
  57. <div id="footer">
  58. <section class="footer-body">
  59. <p>Document generated by Confluence on Aug 11, 2014 13:48</p>
  60. </section>
  61. </div>
  62. </div> </body>
  63. </html>