====== RFC: strn(case)cmp supporting a negative length as its third paramter ======
  * Version: 1.0
  * Date: 2011-07-28
  * Author: Xinchen Hui <laruence@php.net>
  * Status: Withdrawn
  * First Published at: http://wiki.php.net/rfc/strncmpnegativelen/

===== Introduction =====
strncmp doesn't supporting negative length:

<code php>
<?php
   if (strncmp("prefix_num", "num", -3) === 0) {
        echo "they have same suffix\n";
   }
?> 
</code>

running the above script in PHP 5.3.6 will result:
<code>
warning: Length must be greater than or equal to 0 in /tmp/1.php 
</code>

We need to write some codes like following one to make it works as expect: 
<code php>
<?php
   if (strncmp(substr("prefix_num", -3, 3), "num", 3) === 0) {
        echo "they have same suffix\n";
   }
?> 
</code>

===== Proposal =====
base on feature request: https://bugs.php.net/bug.php?id=36944 , I wrote a patch to make strn(case)cmp supporting negative length,

after patched, following script:
<code php>
<?php
   if (strncmp("prefix_num", "num", -3) === 0) {
        echo "they have same suffix\n";
   }
?> 
</code>

will work as expect.

and if the abs of the negative length is greater than any strlen of the first two parameters, then strn(case)cmp will work as strncmp in the reverse order with the abs value:

<code php>
<?php
var_dump(strncmp("prefix_num", "num", -10));
var_dump(strncmp("mun_xiferp", "mun", 10));
/** output:
int(7)
int(7)
*/
?> 
</code>

===== BC Breaks =====
   * Any strncmp call with a computed length which may end up being negative will now potentially return a match where it wouldn't before.
===== Patches =====
   * http://www.laruence.com/php-dev/php-5.4-trunk-strncmp-supproting-negative-len.patch
===== Tests =====
   * http://www.laruence.com/php-dev/strncmpnegativelen.phpt
===== Vote =====
<doodle 
title="Do you want this feature in PHP 5.4" auth="laruence" voteType="single" closed="yes">
   * yes
   * no
</doodle>

===== Changelog =====
  * 2011-07-28 Xinchen Hui: Initial RFC creation
  * 2011-07-28 Xinchen Hui: Updated patch to avoid making binary API changed
  * 2011-08-01 Xinchen Hui: Start voting
  * 2011-08-08 Xinchen Hui: Edited phpt
  * 2011-08-13 Xinchen Hui: Stop voting
  * 2011-08-14 Xinchen Hui: Open voting again, since there comes some new objections
  * 2011-12-13 Xinchen Hui: Won't apply now