help/info/permutation.html

   1 <!--
   2  Copyright (c) 2000-2016 Ericsson Telecom AB
   3  All rights reserved. This program and the accompanying materials
   4  are made available under the terms of the Eclipse Public License v1.0
   5  which accompanies this distribution, and is available at
   6  http://www.eclipse.org/legal/epl-v10.html
   7
   8  Contributors:
   9   Baji, Laszlo
  10   Balasko, Jeno
  11   Forstner, Matyas
  12   Gecse, Roland
  13   Szabados, Kristof
  14 -->
  15 <html>
  16 <head>
  17 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  18 <meta http-equiv="Content-Language" content="en-us">
  19 <title>permutation</title>
  20 </head>
  21 <body bgcolor="#DAD3C5" vlink="#0094D2" link="#003258">
  22 <table align="left" border="0" cellspacing="0" cellpadding="0" valign=top>
  23   <tr>
  24     <td width=105 height=40><a href="https://projects.eclipse.org/projects/tools.titan"><img src="../images/titan_transparent.gif" border=0 width=105 height=40 align="left" alt="Titan"></a></td>
  25   </tr>
  26 </table>
  27 <table border="0" align="right" cellpadding="0" cellspacing="0">
  28   <tr>
  29     <td><a href="../titan_main.html" alt="contents"><img border="0" src="../images/ao.jpg" width="53" height="40"></a></td>
  30     <td><a href="../titan_index.html" alt="index"><img border="0" src="../images/up.jpg" width="53" height="40"></a></td>
  31     <td><a href="pattern.html" alt="previous"><img border="0" src="../images/left.jpg" width="53" height="40"></a></td>
  32     <td><a href="port.html" alt="next"><img border="0" src="../images/right.jpg" width="53" height="40"></a></td>
  33   </tr>
  34 </table>
  35 <p><br clear="all">
  36 </p>
  37 <hr>
  38 <h1>permutation</h1>
  39 <hr align="left" width="75%">
  40 <p>The keyword is only used in conjunction with <font face="Courier New"><b>template</b></font> definition. It denotes the inside matching mechanism where the incoming field contains exactly those
  41 elements that appear in the value list of permutation but in any order. It is applicable inside of <font face="Courier New" size="4"><b>record</b></font> <font face="Courier New" size="4"><b>of</b></font>
  42 templates or template fields only (i.e. within the pair of {}-s of the record of).
  43 <hr align="left" width="50%">
  44 <p>Related keyword:</p>
  45 <ul>
  46   <li><a href="template.html"><b><font face="Courier New" color="#003258" size="4">template</font></b></a></li>
  47 </ul>
  48 <hr align="left" width="50%">
  49 <div align="center">
  50 <center>
  51 <table border="0" width="90%" bgcolor="#FFB599" cellpadding="4">
  52   <tr>
  53     <td width="100%">
  54     <h3 align="center"><font face="Courier New" color="#003258" size="5"><b>permutation(</b></font><i>value_list</i><font face="Courier New" color="#003258" size="5"><b>)</b></font></h3>
  55     </td>
  56   </tr>
  57 </table>
  58 </center>
  59 </div>
  60 <ul>
  61   <li>
  62   <p><i>value_list</i> is a comma separated list containing all the values that are&nbsp; permitted for the concerned field.
  63 </ul>
  64 <hr align="left" width="25%">
  65 <p>Example:
  66 <p><code> type record of integer ROI; template ROI tr_OneTwoThree := { permutation ( 1, 2, 3 ) }; </code>
  67 <p>Template tr_OneTwoThree matches all three integers long ROI values that contain the numbers one, two and three in any order. <br>
  68 These is a total of 3! = 6 different matching value lists:
  69 <p><code>{ 1, 2, 3 } <br>
  70 { 1, 3, 2 } <br>
  71 { 2, 1, 3 } <br>
  72 { 2, 3, 1 } <br>
  73 { 3, 1, 2 } <br>
  74 { 3, 2, 1 } </code>
  75 <hr align="left" width="25%">
  76 <p><a HREF="BNF.html#permutationmatch">BNF definition</a> of <font face="Courier New">permutation</font></p>
  77 </body>
  78 </html>