Commit | Line | Data |
---|---|---|
970ed795 | 1 | <!-- |
3abe9331 | 2 | Copyright (c) 2000-2015 Ericsson Telecom AB |
970ed795 EL |
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>log</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="lengthof.html" alt="previous"><img border="0" src="../images/left.jpg" width="53" height="40"></a></td> | |
3abe9331 | 26 | <td><a href="log2str.html" alt="next"><img border="0" src="../images/right.jpg" width="53" height="40"></a></td> |
970ed795 EL |
27 | </tr> |
28 | </table> | |
29 | <p><br clear="all"> | |
30 | </p> | |
31 | <hr> | |
32 | <h1>log</h1> | |
33 | <hr align="left" width="75%"> | |
34 | <p>The log statement provides the means to write a character string to some logging device associated with test control or the test component in which the statement is used. | |
35 | <ul> | |
36 | <li>In TITAN, the logging device is the log file. As an extension to the standard, it is possible to refer also to constants, variables, templates or expressions in the argument. Every element | |
37 | of the argument may be repeated.</li> | |
38 | </ul> | |
39 | <hr align="left" width="50%"> | |
40 | <div align="center"> | |
41 | <center> | |
42 | <table border="0" width="90%" bgcolor="#FFB599" cellpadding="4"> | |
43 | <tr> | |
44 | <td width="100%"> | |
45 | <h3 align="center"><font face="Courier New" color="#003258" size="5"><b>log ( "</b></font> <i>free_text_string</i> <font face="Courier New" color="#003258" size="5"><b>"</b></font> [<font | |
46 | face="Courier New" color="#003258" size="5"><b>,</b></font><i>constanst_ref</i>] [<font face="Courier New" color="#003258" size="5"><b>,</b></font><i>variable_ref</i>] [<font face="Courier New" | |
47 | color="#003258" size="5"><b>,</b></font><i>template_ref</i>] [<font face="Courier New" color="#003258" size="5"><b>,</b></font><i>expression</i>] <font face="Courier New" color="#003258" | |
48 | size="5"><b>);</b></font></h3> | |
49 | </td> | |
50 | </tr> | |
51 | </table> | |
52 | </center> | |
53 | </div> | |
54 | <ul> | |
55 | <li><i>free_text_string</i> is copied to the log file. It may contain numbers and letters from the BASIC LATIN and the LATIN-1 SUPPLEMENT character sets.</li> | |
56 | </ul> | |
57 | <div align="center"> | |
58 | <center> | |
59 | <table border="0" width="100%" bgcolor="#C9C2BB" cellpadding="4"> | |
60 | <tr> | |
61 | <td width="100%"> | |
62 | <blockquote> | |
63 | <p><u>TITAN specific extensions to the standard:</u></p> | |
64 | </blockquote> | |
65 | <ul> | |
66 | <li> | |
67 | <p><i>constanst_ref</i> refers to a constant. The value of the constant appears in the log file.</p> | |
68 | </li> | |
69 | <li> | |
70 | <p><i>variable_ref</i> refers to a variable. The actual value of the variable is copied to the log file.</p> | |
71 | </li> | |
72 | <li> | |
73 | <p><i>template_ref</i> refers to a template. The log file will contain the actual field values of the referred template.</p> | |
74 | </li> | |
75 | <li> | |
76 | <p><i>expression</i> denotes a predefined or user-defined TTCN-3 function. Functions with actual arguments can also be passed to log statement. This will print the return value of the | |
77 | function into the log. The match operation is an exception: instead of the Boolean return value the detailed matching process is logged field-by-field.</p> | |
78 | </li> | |
79 | </ul> | |
80 | </td> | |
81 | </tr> | |
82 | </table> | |
83 | </center> | |
84 | </div> | |
85 | <hr align="left" width="50%"> | |
86 | <p>Example 1: | |
87 | <p><font face="Courier New">log ("Note the following value: ", rnd(float .217))<br> | |
88 | </font> | |
89 | <p>The text between quotation marks will be added to the log file followed by the a random value generated using the seed 0.217.</p> | |
90 | <hr align="left" width="25%"> | |
91 | <p><a HREF="../info/BNF.html#logstatement">BNF definition</a> of <font face="Courier New">log</font></p> | |
92 | </body> | |
93 | </html> |