Make y_array_get_no_zeroes() use y_get_cleansed_parameter() underneath the covers.

Also adds a bit more example code to the documentation and improves the error messaging of that function a bit.