On Tue, Feb 5, 2013 at 1:45 AM, Karoly Negyesi <kar...@negyesi.net> wrote: > Hi, > > So strtr can return FALSE according to current docs and I just > documented the case where it can return a NULL. > > So, do we document it as returning mixed or is it string? I mean, it's > only mixed when some error is happening.
The return value of internal functions when passing in invalid data is undefined. We do document the "general case" (returning null), but there are _plenty_ of exceptions from that rule. When a internal method only returns integer when passing "relatively correct data", then the return type is "integer". Mixed return value is only reserved for functions that in normal circumstances will return mixed values. -Hannes
