PHP :: Doc Bug #76245 :: mb_ereg_match matches at beginning of subject only
php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #76245 mb_ereg_match matches at beginning of subject only
Submitted: 2018-04-20 19:25 UTC Modified: -
From: jake at qzdesign dot co dot uk Assigned:
Status: Open Package: mbstring related
PHP Version: 7.1.16 OS: Windows 7 32-bit
Private report: No CVE-ID: None
Have you experienced this issue?
Rate the importance of this bug to you:

 [2018-04-20 19:25 UTC] jake at qzdesign dot co dot uk
Description:
------------
The manual page for `mb_ereg_match` at https://secure.php.net/manual/en/function.mb-ereg-match.php makes no mention that `$pattern` is only matched at the beginning of `$string` (i.e. it includes an implied `^` at the start).

It is mentioned in a user contributed note, but this behaviour really should be included in the main documentation, probably in a highlighted "Note" or "Warning" box, as it is very important for using the function, and the behaviour would be unexpected as most other similar functions in both PHP and other languages do not behave this way.

(It may be a bug in the function and it is not supposed to behave this way, but for compatibility reasons it probably can't be fixed until a major release.)

Test script:
---------------
<?php

// note space at start of $string parameter
echo mb_ereg_match('[[:alpha:]]', ' a') ? 'matched' : 'not matched';


Expected result:
----------------
Based on the documentation as it is, I expected "matched" to be output.

I expect to be able to easily determine what this simple script would output from the documantation.

Actual result:
--------------
"not matched" is output, but the documentation makes no indication that this would be the case.

Patches

Add a Patch

Pull Requests

Add a Pull Request

 
PHP Copyright © 2001-2018 The PHP Group
All rights reserved.
Last updated: Sat Aug 18 12:01:26 2018 UTC