The levenshtein() function returns the Levenshtein distance between two strings.The Levenshtein distance is the number of characters you have to replace, insert or delete to transform string1 into string2.
By default, PHP gives each operation (replace, insert, and delete) equal weight. However, you can define the cost of each operation by setting the optional insert, replace, and delete parameters.
int levenshtein ( string $str1 , string $str2 )
int levenshtein ( string $str1 , string $str2 , int $cost_ins , int $cost_rep , int $cost_del )
The Levenshtein distance is defined as the minimal number of characters you have to replace, insert or delete to transform str1 into str2. The complexity of the algorithm is O(m*n), where n and m are the length of str1 and str2 (rather good when compared to similar_text(), which is O(max(n,m)**3), but still expensive).
In its simplest form the function will take only the two strings as parameter and will calculate just the number of insert, replace and delete operations needed to transform str1 into str2. A second variant will take three additional parameters that define the cost of insert, replace and delete operations. This is more general and adaptive than variant one, but not as efficient.
Parameter | Description |
---|---|
str1 | One of the strings being evaluated for Levenshtein distance. |
str2 | One of the strings being evaluated for Levenshtein distance. |
cost_ins | Defines the cost of insertion. |
cost_rep | Defines the cost of replacement. |
cost_del | Defines the cost of deletion. |
This function returns the Levenshtein-Distance between the two argument strings or -1, if one of the argument strings is longer than the limit of 255 characters.