219

What is the purpose of writing comments in Swift as:

// MARK: This is a comment

When you can also do:

// This is a comment

What does the // MARK achieve?

2 Answers 2

397

The // MARK: and // MARK: - syntax in Swift functions identically to the #pragma mark and #pragma mark - syntax in Objective-C.

When using this syntax (plus // TODO: and // FIXME:), you can get some extra information to show up in the quick jump bar.

Consider these few lines of source code:

// MARK: A mark comment lives here.

func isPrime(_ value: UInt) -> Bool { return true }

enter image description here

And for reference, the quick jump bar is at the top in Xcode:

enter image description here

It exists mostly to help with quick navigation within the file.

Note that the dash (// MARK: -) causes a nice separation line to show up. Consider this MARK comment:

// MARK: - A mark comment lives here.

enter image description here

The darker gray separator line just above the bolded option in that menu comes from the dash.

Additionally, we can achieve this separator line without a comment by simply not having any text after the dash:

// MARK: -

enter image description here

As mentioned, // TODO: and // FIXME: comments will also appear here.

// MARK: - Prime functions

func isPrime(_ value: UInt) -> Bool {
    // TODO: Actually implement the logic for this method
    return true
}

func nthPrime(_ value: UInt) -> Int {
    // FIXME: Returns incorrect values for some arguments
    return 2
}

enter image description here

  • FIXMEs get a little band-aid icon that help them standout.
  • MARK icon looks like a table of contents
  • TODO icons look more like a checklist

Clicking on any line in the quick jump bar takes you directly to that line in the source code.

8
  • Is this functionality specific to Swift/Objective-C or Xcode?
    – ma11hew28
    Jul 7, 2019 at 23:32
  • Xcode, presumably. Although, I can easily imagine that other IDEs will potentially exhibit similar behavior.
    – nhgrif
    Jul 8, 2019 at 14:08
  • You can also put the hyphen after your text, // MARK: /Delegate impl. -, to mark the end of a section, or why not both: // MARK: - Attention! -
    – Andreas
    Jul 12, 2020 at 13:07
  • @Andreas hyphen - is just a horizontal line. No any additional mark presents the meaning of the end of section.
    – Yam
    Oct 6, 2020 at 17:36
  • @ooops Sorry, I'm not entirely sure what you mean. Yes, it's a horizontal line.
    – Andreas
    Oct 6, 2020 at 19:17
16

MARK simply adds a visual MARK in the jump bar like this:

ex // MARK: Core Data Stack

enter image description here

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.