Escaping parentheses within parentheses for batch file

Question

This is what I am trying to do:

( @echo This is some code that is @echo Important to echo exactly as-is @echo Even if I use parenthesis @echo for something (like this) )|clip 

So having that copied into clipboard. I have tried the following:

( @echo This is some code that is @echo Important to echo exactly as-is @echo Even if I use parenthesis @echo for something ^(like this^) )|clip 

But this seems to affect my WANTED parentheses as well because I receive an error. To test this, I simply done:

( @echo This is some code that is @echo Important to echo exactly as-is @echo Even if I use parenthesis @echo for something ^(like this^) FFF )|clip 

Hey! This almost works, the text is copied all the way to the "s" in "this". It does not copy the last parentheses, or obviously the F's. Any ideas?

Answer 1

It's obvious that you need three carets there :-)

( @echo This is some code that is @echo Important to echo exactly as-is @echo Even if I use parenthesis @echo for something (like this^^^) )|clip 

Why? That is a bit tricky...

First the parser parses the block and escapes the part this^^^) to this^), the parenthesis was escaped here the first time.

But as you used a pipe, the complete block will be translated and transfered to a new cmd.exe instance.
C:\Windows\system32\cmd.exe /S /D /c" ( @ echo This is some code is ... & @ echo for something (like this^) )"

And in the new instance it is necessary again to escape the closing parenthesis.
That's all!

And for more information you could read a similar question
SO: why does delayed expansion fail when inside a piped block of code

Answer 2

If you get confused by the caret count, remember that it is always a power of 2 minus 1. Alternatively, remember that the first time you add 2, the second time 4, the third time 8, ...

For example, (tested on XP)

( for /f "tokens=* delims=" %%S in ( 'echo X^^^^^^^^^^^^^^^& ^^^^^^^^^^^^^^^| ^^^| find " "' ) do @echo %%S ) | find "X" 

The echo statement gets read first normally when DOS parses the batch file (1), second because it is a piped internal command (DOS seems to want programs in pipes, and internal commands are not programs) (3), third because it is in a 'for /f' command-driven word list (see for /?) (7), and a fourth time for reasons already given in this thread (15).

I may also note that personally, I consider it sloppy coding to leave proper escaping of hot characters away just because DOS happens to ignore the missing escaping in that particular case. So if I wanted to echo a literal pair of parentheses in the above example, I would give each 15 carets, even if the opening parenthesis does not need it. Then anyone reading my code does not have to wonder why one parenthesis is quoted and the other is not. And how to modify the quoting under code modification.