Add omission hints to return values

[shaedrich]

[jordikroon]

There isn't really an equivalent. So we can omit that.

[shaedrich]

Do you have a working example where object is null? My assumption is that if it would be null it would be omitted.

Yeah, it's not exactly right, I'd be omitted, which, aside from emitting a warning if trying to access it, is treated as null as well as being considered null by is_null() and even in strict comparison with null—how would you describe that as a type?

(in reply to #5545 (comment))

[jordikroon]

Do you have a working example where object is null? My assumption is that if it would be null it would be omitted.

Yeah, it's not exactly right, I'd be omitted, which, aside from emitting a warning if trying to access it, is treated as null as well as being considered null by is_null() and even in strict comparison with null—how would you describe that as a type?

(in reply to #5545 (comment))

It wouldn't be right to change the signature because of that. PHP doesn't have an undefined type like javascript. So if it isn't there, it isn't there. The table already explicitly mentions that Possible returned elements from. Indicating that if may or may not return all values.

The types should stay object and string. They have also wrongfully been changed to array (+ null).