cvs: qaweb / expectf_details.php

zoe Mon Jan 12 13:03:36 2009 UTC Added files: /qaweb expectf_details.php Log: Table documenting EXPECTF substituion tags in run-tests http://cvs.php.net/viewvc.cgi/qaweb/expectf_details.php?view=markup&rev=1.1 Index: qaweb/expectf_details.php +++ qaweb/expectf_details.php <?php include("include/functions.php"); $TITLE = "Writing Tests [PHP-QAT: Quality Assurance Team]"; $SITE_UPDATE = date("D M d H:i:s Y T", filectime(__FILE__)); /* $Id: expectf_details.php,v 1.1 2009/01/12 13:03:36 zoe Exp $ */ common_header(); ?> <table width="70%" border="0" cellspacing="0" cellpadding="0"> <tr> <td width="10"><img src="gfx/spacer.gif" width="10" height="1"></td> <td width="100%"> <h1>EXPECTF substitution options</h1> </td> <td width="10"><img src="gfx/spacer.gif" width="10" height="1"></td> </tr> <tr> <td width="10">&nbsp;</td> <td width="100%"> <dl> <p>The --EXPECTF--section uses a number of substitution tags for strings or digits that appear in test case output but which may vary between test runs. The most common example of this is to use %s and %d to match the file path and line number which are output by PHP Warnings.</p> <p>The substitution tags and their meanings are summarised below</p> <table border="1"> <tr> <th> %code </th> <th> Meaning </th> </tr> <tr> <td> %e </td> <td> Represents a directory separator, for example / on Linux. </td> </tr> <tr> <td> %s </td> <td> One or more of anything (charater or white space) except the end of line character. </td> </tr> <tr> <td> %S </td> <td> Zero or more of anything (charater or white space) except the end of line character. </td> </tr> <tr> <td> %a </td> <td> One or more of anything (charater or white space) including the end of line character. </td> </tr> <tr> <td> %A </td> <td> Zero or more of anything (charater or white space) including the end of line character. </td> </tr> <tr> <td> %w </td> <td> Zero or more white space characters. </td> </tr> <tr> <td> %i </td> <td> A signed integer value, for example +3142, -3142. </td> </tr> <tr> <td> %d </td> <td> An unsigned integer value, for example 123456. </td> </tr> <tr> <td> %x </td> <td> One or more hexadecimal character. That is, characters in the range 0-9, a-f, A-F. </td> </tr> <tr> <td> %f </td> <td> A floating point number, for example: 3.142, -3.142, 3.142E-10, 3.142e+10. </td> </tr> <tr> <td> %c </td> <td> A single character of any sort (.) </td> </tr> <tr> <td> %unicode|string% </td> <td> Matches the string 'unicode' in PHP6 test output and 'string' in PHP5 test output. </td> </tr> <tr> <td> %binary_string_optional% </td> <td> Matches 'Binary string' in PHP6 output, 'string' in PHP5 output. Used in PHP Warning messages. </td> </tr> <tr> <td> %unicode_string_optional% </td> <td> Matches 'Unicode string' in PHP6 output, 'string' in PHP5 output. Used in PHP Warning messages. </td> </tr> <tr> <td> %u\|b% </td> <td> Matches a single 'u' in PHP6 test output where the PHP5 output from the same test hs no character in that position.</td> </tr> </table>