DOC: add note and examples to `isrealobj` docstring
DOC: add note and examples to `isrealobj` docstring

Clarify that `isrealobj` returns True for non-array input rather
than raise an exception, which may be surprising.

Closes gh-12652

Co-authored-by: Mukulikaa <df2b6b10c42cf30f9625aae39254654914f3b5e0@users.noreply.github.com>

charris/numpy,jakirkham/numpy,pdebuyl/numpy,mhvk/numpy,jakirkham/numpy,charris/numpy,seberg/numpy,charris/numpy,rgommers/numpy,simongibbons/numpy,seberg/numpy,simongibbons/numpy,rgommers/numpy,charris/numpy,numpy/numpy,pdebuyl/numpy,mhvk/numpy,mhvk/numpy,mattip/numpy,mattip/numpy,seberg/numpy,pdebuyl/numpy,endolith/numpy,numpy/numpy,anntzer/numpy,simongibbons/numpy,endolith/numpy,pdebuyl/numpy,jakirkham/numpy,mhvk/numpy,endolith/numpy,mattip/numpy,simongibbons/numpy,mhvk/numpy,rgommers/numpy,jakirkham/numpy,jakirkham/numpy,endolith/numpy,anntzer/numpy,simongibbons/numpy,numpy/numpy,numpy/numpy,anntzer/numpy,mattip/numpy,seberg/numpy,rgommers/numpy,anntzer/numpy