#47097 [Asn]: DomainException documentation problem: insufficient description

ID: 47097 Updated by: helly@php.net Reported By: me at signpostmarv dot name Status: Assigned Bug Type: Documentation problem PHP Version: Irrelevant Assigned To: helly New Comment: Domain means data domain here. That is a DomainException shall be through whenever a value does not adhere to a defined valid data domain. Examples: - 0 is not a in the domain for division. - Foo is not in the domain for weekdays. The first is different from out of range and alike, but you could use InvalidParameter in case it is actually a parameter to the function that performs the division. If it is a value calculated inside the function prior to executing the division and then a pre-conditon check throws instead of executing the division, then it becomes a DomainException. The second could be seen as an OutOfRangeException. Previous Comments: ------------------------------------------------------------------------ [2009-01-14 17:40:34] bjori@php.net (reclassify as documentation problem) ------------------------------------------------------------------------ [2009-01-14 16:40:54] me at signpostmarv dot name Google Code to the rescue! sort of :-S http://code.google.com/p/biblioteca-de-alejandria/source/browse/trunk/workspace/Alejandria/src/ar/alejandria/exceptions/DomainException.java?r=23 Google Translate doesn't help all that much, but if you can find a native speaker/reader they might be able to grok the intention of a Domain Exception, then try and corroborate the meaning with other sources. ~ SVN Humor FTW :-P ------------------------------------------------------------------------ [2009-01-14 15:11:58] me at signpostmarv dot name I suppose the problem is that there are a few too many definitions of "Domain" :-s ------------------------------------------------------------------------ [2009-01-14 15:10:48] me at signpostmarv dot name I've no idea :-P Perhaps ask whoever added DomainException to SPL in the first place ? ------------------------------------------------------------------------ [2009-01-14 14:29:13] bjori@php.net Your are totally right. And there is a good reason for that: We have no idea what its useful for :) Marcus: Could you enlighten us? :) ------------------------------------------------------------------------ The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/47097 -- Edit this bug report at http://bugs.php.net/?id=47097&edit=1