Documentation.

Also: don't return reference to temporary variables.