From 43d3b06a68c324615c5d1909e183687a40b0bb19 Mon Sep 17 00:00:00 2001 From: Karl Williamson Date: Sun, 15 Jul 2012 17:02:19 -0600 Subject: [PATCH] perlapi: Clarify hv_fetch() docs I was confused by the earlier documentation. Thanks to Leon Timmermans for clarifying, and to Vicent Pitt for most of the wording --- hv.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/hv.c b/hv.c index ac826f1..c4cf736 100644 --- a/hv.c +++ b/hv.c @@ -277,7 +277,10 @@ negative the key is assumed to be in UTF-8-encoded Unicode. Returns the SV which corresponds to the specified key in the hash. The absolute value of C is the length of the key. If C is negative the key is assumed to be in UTF-8-encoded Unicode. If -C is set then the fetch will be part of a store. Check that the +C is set then the fetch will be part of a store. This means that if +there is no value in the hash associated with the given key, then one is +created and a pointer to it is returned. The C it points to can be +assigned to. But always check that the return value is non-null before dereferencing it to an C. See L for more -- 1.8.3.1