Kamailio SIP Server Wiki

User Tools

Site Tools

Trace:
cookbooks:5.3.x:pseudovariables

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
cookbooks:5.3.x:pseudovariables [2020/04/02 21:28]
miconda [$xavp(id) - XAVPs] 		cookbooks:5.3.x:pseudovariables [2020/04/02 21:35]
miconda [$xavp(id) - XAVPs]
Line 724: Line 724:
 **xavp** - eXtended AVPs - are variables that can store multiple values, which can also be grouped in a structure-like fashion. Their value can be a string, an integer number or a list of named values. **xavp** - eXtended AVPs - are variables that can store multiple values, which can also be grouped in a structure-like fashion. Their value can be a string, an integer number or a list of named values.
  
-They work like a stack, similar to AVPs, and are attached to SIP transactions. Each xavp has a name and can contain multiple named values, the structure name (or root list name) and the value name (or field name) are separated by <nowiki>=></nowiki> like <nowiki>$xavp(root=>field)</nowiki> where "root" is the name of the structure and "field" is the name of the value. To assign a value use:+They work like a stack, similar to AVPs, and are attached to SIP transactions and automatically destroyed when the transaction is finished. 
 + 
 +Each xavp has a string name and can contain a string, and integer or a list of named value. The structure name (or root list name) and the value name (or field name) are separated by <nowiki>=></nowiki> like <nowiki>$xavp(root=>field)</nowiki> where "root" is the name of the structure and "field" is the name of the value. 
 + 
 +To assign a single value use: 
 + 
 +<code c> 
 +$xavp(root)="string value"; 
 +$xavp(root)=intnumber; 
 +</code> 
 + 
 +To assign a named value use:
  
 <code c> <code c>
Line 732: Line 743:
  
 Like avps, xavp act like a stack. To refer to an existing value, use an index. The newest xavp has index zero [0]. Like avps, xavp act like a stack. To refer to an existing value, use an index. The newest xavp has index zero [0].
 +
 <code c> <code c>
 $xavp(root[0]=>field)=12; $xavp(root[0]=>field)=12;
Line 739: Line 751:
  
 <code c> <code c>
-# new item (example => (name = "one"))+# new item (example => [(name = "one")])
 $xavp(example=>name)="one"; $xavp(example=>name)="one";
-# add new item (example => (name = "two"))+ 
 +# add new item (example => [(name = "two")])
 $xavp(example=>name)="two"; $xavp(example=>name)="two";
 +
 # add another named value to the last example item # add another named value to the last example item
 +#   (example => [(value="John"), (name = "one")])
 $xavp(example[0]=>value)="John"; $xavp(example[0]=>value)="John";
 +
 # add another named value to first example item # add another named value to first example item
 +#   (example => [(value="Ana"), (name = "one")])
 xavp(example[1]=>value)="Anna"; xavp(example[1]=>value)="Anna";
 </code> </code>
cookbooks/5.3.x/pseudovariables.txt · Last modified: 2020/04/06 18:09 by pojogas

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki