Documentation |
Documentation.Script-Statements-2-2 HistoryHide minor edits - Show changes to output November 28, 2016, at 11:29 AM
by
- Changed line 1 from:
!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-2-2|Manual devel]] -> Script Statements to:
!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-2-2|Manual 2.2]] -> Script Statements July 16, 2015, at 03:18 PM
by
- Changed lines 166-167 from:
for ($json(it) in $(avp(res)[*])) xlog("Found: $json(it/field1) $json(it/field2)\n"); to:
for ($json(contact) in $(avp(res)[*])) xlog("Found: $json(contact/phone) $json(contact/email)\n"); July 16, 2015, at 03:16 PM
by
- Added lines 163-167:
# iterate through all JSON documents returned by a MongoDB query cache_raw_query("mongodb:location", "{... find ...}", "$avp(res)"); for ($json(it) in $(avp(res)[*])) xlog("Found: $json(it/field1) $json(it/field2)\n"); March 20, 2014, at 08:29 PM
by
- Added lines 1-164:
!!!!!Documentation -> [[Documentation.Manuals|Manuals]] -> [[Documentation.Manual-2-2|Manual devel]] -> Script Statements (:title Script Statements - 2.2:) ---- (:allVersions Script-Statements 2.2:) \\ || %color=#185662%[+'''Script Statements v2.2 '''+]%% || ||[[Script-Operators-2-2|Prev]] || [[Script-CoreFunctions-2-2|Next]]|| ---- (:toc-float Table of Content:) Statements you can use in the '''OpenSIPS''' config file while building the routing logic. !!!!if IF-ELSE statement Prototype: [@ if (expr) { actions; } else { actions; } @] The 'expr' should be a valid logical expression. The logical operators that can be used in the logical expressions: * == - equal * != - not equal * =~ - regular expression matching (e.g. $rU =~ '^1800*' is "$rU begins with 1800" ) * !~ - regular expression not-matching * > - greater * >= - greater or equal * < - less * <= - less or equal * && - logical AND * || - logical OR * ! - logical NOT * [ ... ] - test operator - inside can be any arithmetic expression Example of usage: [@ if ( is_method("INVITE") && $rp==5060 ) { log("this sip message is an invite\n"); } else { log("this sip message is not an invite\n"); } @] !!!!switch SWITCH statement - it can be used to test the value of a pseudo-variable. IMPORTANT NOTE: 'break' can be used only to mark the end of a 'case' branch (as it is in shell scripts). If you are trying to use 'break' outside a 'case' block the script will return error -- you must use 'return' there. Example of usage: [@ route { route(my_logic); switch($retcode) { case -1: log("process INVITE requests here\n"); break; case 1: log("process REGISTER requests here\n"); break; case 2: case 3: log("process SUBSCRIBE and NOTIFY requests here\n"); break; default: log("process other requests here\n"); } # switch of R-URI username switch($rU) { case "101": log("destination number is 101\n"); break; case "102": log("destination number is 102\n"); break; case "103": case "104": log("destination number is 103 or 104\n"); break; default: log("unknown destination number\n"); } } route[my_logic]{ if(is_method("INVITE")) { return(-1); }; if(is_method("REGISTER")) return(1); } if(is_method("SUBSCRIBE")) return(2); } if(is_method("NOTIFY")) return(3); } return(-2); } @] >>warning<< Take care while using 'return' - 'return(0)' stops the execution of the script. >><< !!!!while while statement Example of usage: [@ $var(i) = 0; while($var(i) < 10) { xlog("counter: $var(i)\n"); $var(i) = $var(i) + 1; } @] !!!!for each for each statement - easy iteration over indexed pseudo variables Example of usage: [@ $avp(arr) = 0; $avp(arr) = 1; $avp(arr) = 2; $avp(arr) = 3; $avp(arr) = 4; for ($var(it) in $(avp(arr)[*])) xlog("array value: $var(it)\n"); # iterate through all Contact URIs from each Contact header for ($var(ct) in $(ct[*])) xlog("Contact: $var(ct)\n"); # iterate through all Via headers of a SIP request for ($var(via) in $(hdr(Via)[*])) xlog("Found \"Via\" header: $var(via)\n"); @] |
Page last modified on November 28, 2016, at 11:29 AM