Python 3.x multi line comment throws syntax error

Question

I'm working on a Python project and as of now, my code has over 400+ lines. At one point, I had to write a multi-line comment about a small bug which needs a work around, and the interpreter decided to throw a syntax error.

According to the interpreter, the syntax error is occuring at elif. I re-checked my indentation, converted tabs to spaces etc. Nothing seems to work.

                    if some_condition_1 == True:
                       do_something()

                    """
                    Sub stage (b):
                    Refer documentation [1.7A] for ...
                    ....
                    ....
                    ....
                    """
                    elif condition_1 == True:
                        if condition_2 == False:
                            list.append(item)

However, if I remove the multi-line comment, the code executes fine.

Any idea what's going wrong? Please note that the code sample I've show above, is at very top of the file, and there's no chance for anything to go wrong elsewhere.

Two-Bit Alchemist · Accepted Answer · 2016-06-01 14:48:37Z

9

This is an indentation error. Your "multi-line comment" (really multi-line string) must be indented under the if block just like anything else.

""" These kinds of things """ are not really comments in Python. You're just creating a string and then throwing the value away (not storing it anywhere). Since Python doesn't have true multi-line comments, many people use them this way. However, since they are not true comments (they aren't ignored by the interpreter), they must obey all normal syntax rules, including indentation rules.

(Do note that when I say "creating a string" I'm speaking loosely. CPython, at least, has an optimization not to create an object here.)

answered Jun 1, 2016 at 14:48

Two-Bit Alchemist

18.6k6 gold badges52 silver badges85 bronze badges

Sign up to request clarification or add additional context in comments.

3 Comments

user5979025 Over a year ago

Thanks a ton. Got it!

Two-Bit Alchemist Over a year ago

@PawanKartik Please hit the checkmark under the answer to mark this "Solved" if you don't mind. It keeps the robot janitors from going crazy. :)

user5979025 Over a year ago

I did. There was a time limit of 10 minutes. So I was waiting for it to end. :)

Collectives™ on Stack Overflow

Python 3.x multi line comment throws syntax error

1 Answer 1

3 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

3 Comments

Your Answer

Sign up or log in

Post as a guest

Related