php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #41070 mb_list_encodings_alias_names - Does not exists
Submitted: 2007-04-12 22:48 UTC Modified: 2007-08-17 10:06 UTC
From: carpetsmoker at xs4all dot nl Assigned:
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS: FreeBSD 6.2
Private report: No CVE-ID: None
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: carpetsmoker at xs4all dot nl
New email:
PHP Version: OS:

 

 [2007-04-12 22:48 UTC] carpetsmoker at xs4all dot nl
Description:
------------
The php documentation for mb_list_encodings_alias_names(http://www.php.net/manual/en/function.mb-list-encodings-alias-names.php) states that this function is available from php version 5.2.0 and up.

I am currently using php 5.2.1, and the function is not defined in this version (I did not try 5.2.0).

I assume that this is a documentation error and not an actual bug(?)

Note:
I have the mbstring extension loaded, other mbstring functions work fine.

Reproduce code:
---------------
<?php
mb_list_encodings_alias_names('UTF-8');
?>

Actual result:
--------------
Fatal error:  Call to undefined function mb_list_encodings_alias_names() in /data/www/mailview/mailview.php on line 131

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2007-04-13 14:50 UTC] bjori@php.net
"disabled mb_list_*_names() and mb_list_encodings(arg) which are introduced in PHP 5.2.0RC to reconsider/discuss the specification." - hirokawa (http://cvs.php.net/viewvc.cgi/php-src/ext/mbstring/mbstring.c?r1=1.224.2.22.2.14&r2=1.224.2.22.2.15)

Guess we should simply remove those two files, but this will be tough for our version checker to understand
 [2007-04-14 13:26 UTC] carpetsmoker at xs4all dot nl
Maybe an experimental note like this?
http://www.php.net/manual/en/function.ncurses-putp.php
 [2007-04-14 18:03 UTC] sean@php.net
The problem is that the PHP_FUNCTION and {{ proto still exist in 5.2.0, 5.2.1, 5.2.2, but the function itself isn't actually registered (there's no actual PHP_FE for it).

The functable script (ie, the one that figures out which versions of PHP have which functions) can't check for proper PHP_FE registration; it only finds protos and PHP_FUNCTION declarations. It would become needlessly complex if we made it check for PHP_FE (it would have to check other files, make sure that entries aren't commented or #ifdefed, etc.).

This really is an edge case. I think it's very rare that we have function code that exists but doesn't get registered.

I propose we add a note to this page that says something like "This function does not actually exist in PHP 5.2.x, it can be enabled (without documentation or support) by hacking on the code here: http://cvs.php.net/viewvc.cgi/php-src/ext/mbstring/mbstring.c?view=markup"

S

 [2007-08-17 10:06 UTC] vrana@php.net
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

Documentation removed for now.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved.
Last updated: Tue Jul 15 21:01:32 2025 UTC