select_val() documentation

[prev] [thread] [next] [Date index for 2005/01/06]

This is a multi-part message in MIME format.
--------------080408010809030103070102
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

I just used select_val() to implement a simple query, which is great. 
Sadly, it took me longer than I expected because I didn't understand the 
docs, so here's a suggested patch to the documentation that makes it 
clearer for me at least.

Sorry, there's no test :)

Cheers, Dave

--------------080408010809030103070102
Content-Type: text/plain;
 name="cdbi-select_val-doc.diff"
Content-Transfer-Encoding: base64
Content-Disposition: inline;
 filename="cdbi-select_val-doc.diff"

LS0tIC91c3IvbG9jYWwvc2hhcmUvcGVybC81LjYuMS9DbGFzcy9EQkkucG0JRnJpIE5vdiAx
OSAxNzoxODowNSAyMDA0CisrKyBEQkkucG0JVGh1IEphbiAgNiAxMDoyNTo1OCAyMDA1CkBA
IC0yNjU1LDE3ICsyNjU1LDI3IEBACiAKID1oZWFkMiBTaW5nbGUgVmFsdWUgU0VMRUNUcwog
Ci1TZWxlY3RzIHdoaWNoIG9ubHkgcmV0dXJuIGEgc2luZ2xlIHZhbHVlIGNhbiB0YWtlIGFk
dmFudGFnZSBvZiBJbWE6OkRCSSdzCitTZWxlY3RzIHdoaWNoIG9ubHkgcmV0dXJuIGEgc2lu
Z2xlIHZhbHVlIGNhbiB0YWtlIGFkdmFudGFnZSBvZgorREJJeDo6Q29udGV4dHVhbEZldGNo
J3MgdW5kb2N1bWVudGVkCiAkc3RoLT5zZWxlY3RfdmFsKCkgY2FsbCwgY291cGxlZCB3aXRo
IENsYXNzOjpEQkkncyBzcWxfc2luZ2xlIFNRTC4KIAotaGVhZDMgc2VsZWN0X3ZhbAorPWhl
YWQzIHNlbGVjdF92YWwKIAotU2VsZWN0cyB3aGljaCBvbmx5IHJldHVybiBhIHNpbmdsZSB2
YWx1ZSBjYW4gdGFrZSBhZHZhbnRhZ2Ugb2YgSW1hOjpEQkkncwotJHN0aC0+c2VsZWN0X3Zh
bCgpIGNhbGwuIEZvciBleGFtcGxlLAorU2VsZWN0cyB3aGljaCBvbmx5IHJldHVybiBhIHNp
bmdsZSB2YWx1ZSBjYW4gdGFrZSBhZHZhbnRhZ2Ugb2YgCitEQkl4OjpDb250ZXh0dWFsRmV0
Y2gncyB1bmRvY3VtZW50ZWQgJHN0aC0+c2VsZWN0X3ZhbCgpIGNhbGwuCitXaGVuIHNlbGVj
dF92YWwoKSBpcyBpbnZva2VkIG9uIGEgc3RhdGVtZW50IGhhbmRsZSwgaXQgZXhlY3V0ZXMg
dGhlCitzdGF0ZW1lbnQgYW5kIHJldHJpZXZlcyB0aGUgc2luZ2xlIHJlc3VsdC4gRm9yIGV4
YW1wbGUsCiAKIAlfX1BBQ0tBR0VfXy0+c2V0X3NxbChjb3VudF9hbGwgPT4gIlNFTEVDVCBD
T1VOVCgqKSBGUk9NIF9fVEFCTEVfXyIpOwogCSMgLi4gdGhlbiAuLgogCW15ICRjb3VudCA9
ICRjbGFzcy0+c3FsX2NvdW50X2FsbC0+c2VsZWN0X3ZhbDsKKworSXQgY2FuIHRha2UgYXJn
dW1lbnRzIGZvciBTUUwgcGxhY2Vob2xkZXJzIGlmIHJlcXVpcmVkOgorCisJX19QQUNLQUdF
X18tPnNldF9zcWwoY291bnRfcmVjZW50ID0+CisJICAgICAgICAiU0VMRUNUIENPVU5UKCop
IEZST00gX19UQUJMRV9fIFdIRVJFIHllYXIgPiA/Iik7CisJIyAuLiB0aGVuIC4uCisJbXkg
JGNvdW50ID0gJGNsYXNzLT5zcWxfY291bnRfcmVjZW50LT5zZWxlY3RfdmFsKDIwMDApOwog
CiA9aGVhZDMgc3FsX3NpbmdsZQogCg==
--------------080408010809030103070102--