bug#11764: Missing C API doc for accessing unknown number of values

[Andy Wingo]

Hi David,

Thanks for the report.  I've added this somewhat strangely named
function:

 -- C Function: size_t scm_c_nvalues (SCM obj)
     If OBJ is a multiple-values object, returns the number of values
     it contains.  Otherwise returns 1.

Incidentally there is also this new one:

 -- C Function: SCM scm_c_values (SCM *base, size_t n)
     `scm_c_values' is an alternative to `scm_values'.  It creates a
     new values object, and copies into it the N values starting from
     BASE.

     Currently this creates a list and passes it to `scm_values', but we
     expect that in the future we will be able to use more a efficient
     representation.

Suggestions for different names are welcome.

Regards,

Andy
-- 
http://wingolog.org/