X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fdev%2Fconcepts.texi;fp=doc%2Fdev%2Fconcepts.texi;h=29d2b584d68532d7308739dfd29f7ed45750e3f5;hb=c41f14854e73ad44824b54933ae96eb52f781fc2;hp=b1d8583b475fa3693781004e257e7b2a0a7826ea;hpb=f662ba6c542ef66d8ab80cb0a4154ff853cfc0af;p=pspp diff --git a/doc/dev/concepts.texi b/doc/dev/concepts.texi index b1d8583b47..29d2b584d6 100644 --- a/doc/dev/concepts.texi +++ b/doc/dev/concepts.texi @@ -1359,16 +1359,12 @@ Looks for a label for @var{value} in @var{var}'s set of value labels. Returns the label if one exists, otherwise a null pointer. @end deftypefun -@deftypefun {const char *} var_get_value_name (const struct variable *@var{var}, const union value *@var{value}) +@deftypefun void var_append_value_name (const struct variable *@var{var}, const union value *@var{value}, struct string *@var{str}) Looks for a label for @var{value} in @var{var}'s set of value labels. -Returns the label if one exists. If none exists, formats @var{label} -using @var{var}'s print format (@pxref{Input and Output Formats}) in a -static buffer and returns the buffer. - -@quotation Important -This function's use of a static buffer means that it must be used with -care. -@end quotation +If a label exists, it will be appended to the string pointed to by @var{str}. +Otherwise, it formats @var{value} +using @var{var}'s print format (@pxref{Input and Output Formats}) +and appends the formatted string. @end deftypefun The underlying @struct{val_labs} structure may also be accessed