help/info/testcasename.html

   1 <!--
   2  Copyright (c) 2000-2014 Ericsson Telecom AB
   3
   4  All rights reserved. This program and the accompanying materials
   5  are made available under the terms of the Eclipse Public License v1.0
   6  which accompanies this distribution, and is available at
   7  http://www.eclipse.org/legal/epl-v10.html
   8  -->
   9 <html>
  10 <head>
  11 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  12 <meta http-equiv="Content-Language" content="en-us">
  13 <title>testcasename</title>
  14 </head>
  15 <body bgcolor="#DAD3C5" vlink="#0094D2" link="#003258">
  16 <table align="left" border="0" cellspacing="0" cellpadding="0" valign=top>
  17   <tr>
  18     <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>
  19   </tr>
  20 </table>
  21 <table border="0" align="right" cellpadding="0" cellspacing="0">
  22   <tr>
  23     <td><a href="../titan_main.html" alt="contents"><img border="0" src="../images/ao.jpg" width="53" height="40"></a></td>
  24     <td><a href="../titan_index.html" alt="index"><img border="0" src="../images/up.jpg" width="53" height="40"></a></td>
  25     <td><a href="testcase.html" alt="previous"><img border="0" src="../images/left.jpg" width="53" height="40"></a></td>
  26     <td><a href="timeout.html" alt="next"><img border="0" src="../images/right.jpg" width="53" height="40"></a></td>
  27   </tr>
  28 </table>
  29 <p><br clear="all">
  30 </p>
  31 <hr>
  32 <h1>testcasename</h1>
  33 <p>The <b><font face="Courier New">testcasename</font></b> function returns the unqualified name of the actually executing test case.
  34 When it's called from the control part and no testcase is being executed, it returns the empty string.
  35 (For more information check ETSI ES 201 873-1 (TTCN-3 Core Language).)
  36 <hr align="left" width="50%">
  37 <p>Related keywords:</p>
  38 <ul>
  39   <li><a href="charstring.html"><b><font face="Courier New" color="#003258" size="4">charstring</font></b></a></li>
  40   <li><a href="testcase.html"><b><font face="Courier New" color="#003258" size="4">testcase</font></b></a></li>
  41 </ul>
  42 <hr align="left" width="50%">
  43 <div align="center">
  44 <center>
  45 <table border="0" width="90%" bgcolor="#FFB599" cellpadding="4">
  46   <tr>
  47     <td width="100%">
  48       <h3 align="center"><font face="Courier New" color="#003258" size="5"><b>testcasename</b></font><font face="Courier New" color="#003258" size="5"><b>() return charstring</b></font></h3>
  49     </td>
  50   </tr>
  51 </table>
  52 </center>
  53 </div>
  54 <hr align="left" width="50%">
  55 <p>Example 1:</p>
  56 <!-- Always use <pre></pre>! //-->
  57 <font size="+1">
  58 <pre>
  59 module MyModule {
  60   type component Empty { }
  61
  62   testcase MyTestCase() runs on Empty {
  63     // It'll return "MyTestCase".
  64     var charstring TCName := testcasename()
  65   }
  66
  67   control {
  68     // It'll return "".
  69     var charstring TCName := testcasename()
  70   }
  71 }
  72 module YourModule {
  73   function MyFunction() {
  74     // It'll return "MyTestCase" if the function is called e.g. by another function
  75     // during the execution of MyTestCase.
  76     var charstring TCName := testcasename()
  77   }
  78 }
  79 </pre>
  80 <hr align="left" width="25%">
  81 </body>
  82 </html>