>>I disagree. You only really know you need to code against it because you get an error. It's not like trying to access record 5 in an empty table. You'd know intuitively that would fail. I don't feel that _vfp.datatoclip with an empty table is necessarily the sort of thing you'd code against intuitively.
>>
>>I agree with Peter and Cetin that it's a bug in the documentation.
>
>But then I'd rather see the code fixed, not the documentation. The function could simply return empty string for zero records. Wouldn't that be nice?

You forget that the function also copies the field names. They are line 1 and this line is useful for me. It may also be the case that you haven't noticed that field names are copied too. There is a weird thing happening here. The end of a line presumably only has a carriage return character and misses the linefeed character. Demonstration:

clear
create cursor effe ( effe1 i)
insert into effe values ( 1 )
insert into effe values ( 2 )
go top

_vfp.datatoclip
? _cliptext
?
for n = 1 to len( _cliptext )
	?? substr( _cliptext, n, 1 )
	inkey(.5)
next

I agree that the function needs repairment, not the documentation. It even still exists in 9! Unbelievable that such a bug is still alive.

I have also encountered that no error came, but nonetheless the _cliptext was not altered. Cannot reproduce it at the moment. Need a monkey for that one, I guess. Any monkeys here?