From: Jan Beulich Date: Wed, 19 Apr 2023 09:43:44 +0000 (+0200) Subject: gas: document that get_symbol_name() can clobber the input buffer X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=ac164fa8540426238670184e0007e1d4261eaec8;p=binutils-gdb.git gas: document that get_symbol_name() can clobber the input buffer Callers which want to make further parsing attempts at the buffer passed to the function need to be aware that due to the potential of string concatenation the input buffer may be altered in ways beyond what can be undone by putting back at *input_line_pointer the character that the function returns. --- diff --git a/gas/expr.c b/gas/expr.c index afb346ebab3..680ec13b192 100644 --- a/gas/expr.c +++ b/gas/expr.c @@ -2388,12 +2388,17 @@ resolve_expression (expressionS *expressionP) here lessens the crowd at read.c. Assume input_line_pointer is at start of symbol name, or the - start of a double quote enclosed symbol name. - Advance input_line_pointer past symbol name. - Turn that character into a '\0', returning its former value, - which may be the closing double quote. + start of a double quote enclosed symbol name. Advance + input_line_pointer past symbol name. Turn that character into a '\0', + returning its former value, which may be the closing double quote. + This allows a string compare (RMS wants symbol names to be strings) - of the symbol name. + of the symbol name. + + NOTE: The input buffer is further altered when adjacent strings are + concatenated by the function. Callers caring about the original buffer + contents will need to make a copy before calling here. + There will always be a char following symbol name, because all good lines end in end-of-line. */