Question

I came across this wordpress build-in function
get_page_by_path,

but I am still confused after reading
the documentation,

can anyone explain better to me
what does it exactly do and what value it returns ???

thanks !

Answer 1

Internally, get_page_by_path() eventually uses get_page() (source here), returning an object or array (depending on the second $output argument) representing a DB row from wp_posts.

See http://codex.wordpress.org/Function_Reference/get_page#Return_Values