ConFoo Montreal 2017 Calling for Papers

mb_eregi

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

mb_eregiRegular expression match ignoring case with multibyte support

Description

int mb_eregi ( string $pattern , string $string [, array &$regs ] )

Executes the case insensitive regular expression match with multibyte support.

Parameters

pattern

The regular expression pattern.

string

The string being searched.

regs

If matches are found for parenthesized substrings of pattern and the function is called with the third argument regs, the matches will be stored in the elements of the array regs. If no matches are found, regs is set to an empty array.

$regs[1] will contain the substring which starts at the first left parenthesis; $regs[2] will contain the substring starting at the second, and so on. $regs[0] will contain a copy of the complete string matched.

Return Values

Returns the byte length of the matched string if a match for pattern was found in string, or FALSE if no matches were found or an error occurred.

If the optional parameter regs was not passed or the length of the matched string is 0, this function returns 1.

Changelog

Version Description
PHP 7.1.0 mb_eregi() will now set regs to an empty array, if nothing matched. Formerly, regs was not modified in that case.

Notes

Note:

The internal encoding or the character encoding specified by mb_regex_encoding() will be used as the character encoding for this function.

See Also

add a note add a note

User Contributed Notes 3 notes

up
5
bubalula at gmail dot com
5 years ago
This function does not work - it is not case insensitive for non latin characters.
up
0
steve at brainwashstudios dot com
13 years ago
When this function is perfected, and is not experimental, it may be very usefull in the searching and pinpointing of places inside large text files.
up
-2
lasmit at what dot com
4 years ago
I simulated it:
<?php
   $text
= 'Äpfel';
  
mb_internal_encoding( 'utf-8' );
  
printf( "%d\n", mb_eregi( 'äpfel', $text ) ); // Output: 0
  
printf( "%d\n", mb_ereg( 'äpfel', mb_strtolower( $text ) ) ); // Output: 1
  
printf( "%d\n", mb_eregi( 'äpfel', mb_strtolower( $text ) ) ); // Output: 1
?>
To Top