|
Magic Comments
Submitted by |
Have you ever been working on a piece of code, and been using block
comments to comment out something that you later find you want to
uncomment? When doing this, you normally have to add the /* to the
start of the block and */ the end of the block. Then when you want to
uncomment it, you have to do the reverse.. not exactly time consuming,
but a bit annoying.. especially if the block is large, and you end up
doing it a number of times. There is a simple way to get around this
problem, and I've found it immensely useful.
You start the block comment as per usual, with /* but you end it with
/**/
e.g.
/*
// ..lots of code here..
DoSomethingHere();
// ..more lots of code here
/**/ |
When you want to uncomment the code, just remove the /* at the start,
everything becomes uncommented, and the end of the block just remains in
a nice little 'no-op' comment all by itself.
but wait, it gets better...
Say you are making some changes to a bit of code, but you want to keep
the original code for testing purposes. i.e. you want to test the
differences between the code, so you will sometimes want to use the
original code, and sometimes you want to use your changes... but never
both at the same time. You can use a set of comments like:
/*
// ... lots of code here...
OriginalCode();
// and here ...
/*/
// ... some code here...
ChangedCode();
// ... and here
/**/ |
Adding or removing the start of the initial block comment (/*) will
automagically leave either the first, or the second code block commented
out, respectively. It's quite simple in how it works. If the start
comment /* is there, the middle comment /*/ is treated as the terminator
of the block comment, and the final comment /**/ just remains harmlessly
by itself. If the start comment isn't there, the middle comment /*/ is
treated as the start of the block, and the final comment /**/ acts as
the block terminator.
If anyone else uses/has seen this type of commenting, let me know,
because i've never seen it used elsewhere except by myself, and the
people i've told about it.
imron.
|
The zip file viewer built into the Developer Toolbox made use
of the zlib library, as well as the zlibdll source additions.
|