[src/trunk]: src/usr.bin/make/unit-tests make(1): add test for :U modifier

[rillig <rillig%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8c71f4d53cbc
branches:  trunk
changeset: 943025:8c71f4d53cbc
user:      rillig <rillig%NetBSD.org@localhost>
date:      Sun Aug 23 20:49:33 2020 +0000

description:
make(1): add test for :U modifier

diffstat:

 usr.bin/make/unit-tests/varmod-undefined.mk |  50 +++++++++++++++++++++++++++-
 1 files changed, 47 insertions(+), 3 deletions(-)

diffs (62 lines):

diff -r 5d3119606cd4 -r 8c71f4d53cbc usr.bin/make/unit-tests/varmod-undefined.mk
--- a/usr.bin/make/unit-tests/varmod-undefined.mk       Sun Aug 23 20:23:56 2020 +0000
+++ b/usr.bin/make/unit-tests/varmod-undefined.mk       Sun Aug 23 20:49:33 2020 +0000
@@ -1,11 +1,55 @@
-# $NetBSD: varmod-undefined.mk,v 1.2 2020/08/16 14:25:16 rillig Exp $
+# $NetBSD: varmod-undefined.mk,v 1.3 2020/08/23 20:49:33 rillig Exp $
 #
 # Tests for the :U variable modifier, which returns the given string
 # if the variable is undefined.
 #
-# This modifier is heavily used when expanding .for loops.
+# The pattern ${:Uword} is heavily used when expanding .for loops.
+
+# This is how an expanded .for loop looks like.
+# .for word in one
+# .  if ${word} != one
+# .    error ${word}
+# .  endif
+# .endfor
+
+.if ${:Uone} != one
+.  error ${:Uone}
+.endif
+
+# The variable expressions in the text of the :U modifier may be arbitrarily
+# nested.
+
+.if ${:U${:Unested}${${${:Udeeply}}}} != nested
+.error
+.endif
 
-# TODO: Implementation
+# The nested variable expressions may contain braces, and these braces don't
+# need to match pairwise.  In the following example, the :S modifier uses '{'
+# as delimiter, which confuses both editors and humans because the opening
+# and # closing braces don't match anymore.  It's syntactically valid though.
+# For more similar examples, see varmod-subst.mk, mod-subst-delimiter.
+
+.if ${:U${:Uvalue:S{a{X{}} != vXlue
+.error
+.endif
+
+# The escaping rules for the :U modifier (left-hand side) and condition
+# string literals (right-hand side) are completely different.
+#
+# In the :U modifier, the backslash only escapes very few characters, all
+# other backslashes are retained.
+#
+# In condition string literals, the backslash always escapes the following
+# character, no matter whether it would be necessary or not.
+#
+# In both contexts, \n is an escaped letter n, not a newline; that's what
+# the .newline variable is for.
+#
+# Whitespace at the edges is preserved, on both sides of the comparison.
+
+.if ${:U \: \} \$ \\ \a \b \n } != " : } \$ \\ \\a \\b \\n "
+.error
+.endif
 
 all:
        @:;