In Ziel C kann ich #pragma markAbschnitte meines Codes im Symbolnavigator markieren. Da dies ein C-Präprozessorbefehl ist, ist er in Swift nicht verfügbar. Gibt es dafür in Swift einen Ersatz oder muss ich hässliche Kommentare verwenden?

Sie können verwenden // MARK:

Es wurde auch diskutiert, dass die liberale Verwendung von Klassenerweiterungen ohnehin eine bessere Praxis sein könnte. Da Erweiterungen Protokolle implementieren können, können Sie z. B. alle Delegierungsmethoden für Ihre Tabellenansicht in eine Erweiterung einfügen und Ihren Code auf einer semantischeren Ebene gruppieren, als dies möglich #pragma markist.

Bis Xcode 5 existierte die Präprozessor-Direktive #pragma mark.

Ab Xcode 6 müssen Sie verwenden // MARK:

Diese Präprozessorfunktionen ermöglichen es, dem Funktions-Dropdown-Feld des Quellcode-Editors eine gewisse Struktur zu verleihen.

einige Beispiele :

// MARK:

-> wird ein horizontaler Teiler vorangestellt

// MARK: your text goes here

-> setzt "Ihr Text geht hierher" in Fettdruck in die Dropdown-Liste

// MARK: - your text goes here

-> setzt "Ihr Text geht hierher" in Fettdruck in die Dropdown-Liste, gefolgt von einem horizontalen Teiler

Update: Screenshot hinzugefügt, da einige Leute immer noch Probleme damit haben:

Für diejenigen, die an der Verwendung von Erweiterungen im Vergleich zu Pragma-Zeichen interessiert sind (wie im ersten Kommentar erwähnt), ist hier die folgende Implementierung von einem Swift Engineer:

import UIKit

class SwiftTableViewController: UITableViewController {

    init(coder aDecoder: NSCoder!) {
        super.init(coder: aDecoder)

    }

    override func viewDidLoad() {
        super.viewDidLoad()

    }
}

extension SwiftTableViewController {
    override func numberOfSectionsInTableView(tableView: UITableView?) -> Int {
        return 1
    }

    override func tableView(tableView: UITableView?, numberOfRowsInSection section: Int) -> Int {
        return 5
    }

    override func tableView(tableView: UITableView?, cellForRowAtIndexPath indexPath: NSIndexPath?) -> UITableViewCell? {
        let cell = tableView?.dequeueReusableCellWithIdentifier("myCell", forIndexPath: indexPath) as UITableViewCell;

        cell.textLabel.text = "Hello World"

        return cell
    }

}

Es ist auch nicht unbedingt die beste Vorgehensweise, aber so machen Sie es, wenn Sie möchten.

Pragma mark - [SOME TEXT HERE]wurde in Objective-C verwendet, um mehrere Funktionen durch Zeilentrennung zu gruppieren .

In Swift können Sie dies mit erreichenMARK, TODO OR FIXME

ich. KENNZEICHEN : //MARK: viewDidLoad

Dadurch wird eine horizontale Linie mit Funktionen erstellt, die unter viewDidLoad gruppiert sind (siehe Abbildung 1).

ii. MACHEN : //TODO: - viewDidLoad

Dadurch wird die Funktion unter TODO gruppiert: - viewDidLoad- Kategorie (siehe Screenshot 2)

iii. FIXME: //FIXME - viewDidLoad

Dadurch wird die Funktion unter FIXME gruppiert: - viewDidLoad- Kategorie (siehe Screenshot 3)

Weitere Informationen finden Sie in dieser Apple-Dokumentation .

Offizielle Dokumentation

Apples offizielles Dokument zur Xcode- Sprungleiste : Fügen Sie der Sprungleiste Code-Anmerkungen hinzu

Screenshots der Sprungleiste für Beispielcode

Verhalten in Xcode 10.1 und macOS 10.14.3 (Mojave)

Verhalten in Xcode 10.0 und macOS 10.13.4 (High Sierra)

Verhalten in Xcode 9.4.1 und macOS 10.13.0

Diskussion

!!!:und ???:manchmal können nicht angezeigt werden.

In Objective-C-Code erkennt Xcode Kommentare, // MARK: - foodie etwas portabler sind als #pragma. Aber diese scheinen (noch?) Auch nicht aufgegriffen zu werden.

Bearbeiten: In Xcode 6 Beta 4 behoben.

Ich denke, es Extensionsist ein besserer Weg als #pragma mark.

Der Code vor der Verwendung Extensions:

class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate {
    ...

    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
        ...
    }
}

Der Code nach der Verwendung von Extensions:

class ViewController: UIViewController {
    ...
}

extension ViewController: UICollectionViewDataSource {
    func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
        ...
    }

    func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
        ...
    }
}

extension ViewController: UICollectionViewDelegate {
    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
       ...
    }
}

Xcode 8 behandelt es jetzt wie folgt und wird in der Methoden-Dropdown-Liste folgendermaßen angezeigt:

Mit einem Apple Engineer im Swift-Labor heute Morgen auf der WWDC bestätigt, dass es derzeit kein #pragma oder ähnliches gibt. Sie halten dies für einen Fehler und er wird bald eintreffen. Ich vermute also, dass es sich um Beta 2 handelt.

Wie auch immer, es ist auf dem Weg.

Xcode unterstützt jetzt die Markierungen // MARK:, // TODO: und // FIXME, um Ihren Code zu kommentieren und in der Sprungleiste aufzulisten

#pragma_markIn Swift können drei Optionen hinzugefügt werden :

1) // MARK: - your text here -

2) // TODO: - your text here -

3) // FIXME: - your text here -

Hinweis: Wird -zum Hinzufügen von Trennzeichen verwendet

Verwenden

// MARK: SectionName

oder

// MARK: - SectionName

Dadurch wird eine Linie über der Pragma-Markierung angezeigt, wodurch die Lesbarkeit verbessert wird.

Zur Vereinfachung einfach hinzufügen

// MARK: - <#label#>

zu Ihren Code-Schnipsel.

Alternativer Weg -

Verwenden Sie es auf diese Weise

private typealias SectionName = ViewController
private extension SectionName  {
    // Your methods
}

Dadurch wird nicht nur eine Markierung hinzugefügt (genau wie bei einer Pragma-Markierung), sondern der Code wird auch gut getrennt.

//# MARK: - Spinner Class Methods

Fügen Sie eine Zeile zwischen dem Doppelpunkt und Ihrer Beschreibung ein, um eine Trennlinie einzufügen. Dies hilft, Ihren Code noch besser zu organisieren. Der Code und der Screenshot oben verwenden den MARK-Kommentar mit einer Zeile.

1. // # MARK: - Textmethoden (LINE)
2. // # MARK: Textmethoden (NO LINE)

Dies funktioniert nur mit dem MARK-Kommentar.

Sie könnten auch an Swift 4.2 / XCode 10- Compiler-Direktiven wie interessiert sein

#warning("Some string to display")

und

#error("Some error to display")

Es kann nützlich sein, wenn Sie wirklich nichts verpassen möchten.

Professionelle Programmierer müssen dieses Tag für guten Code verwenden. Es ist auch gut für die Teamarbeit.

// MARK: example Web Service start here
// TODO: example 1
// FIXME: Please change BASE url before live 

Es ist leicht, eine solche Methode zu finden

In Xcode 11 wurde eine Minikarte hinzugefügt, die aktiviert werden kann Editor -> Minimap.

Die Minikarte zeigt jeden Markentext zur schnellen Orientierung im Code an. Jede Marke ist wie geschrieben// MARK: Variables

//MARK:scheint für mich in Xcode 6.3.2 nicht zu funktionieren. Dies habe ich jedoch getan, um es zum Laufen zu bringen :

1) Code:

import Cocoa

class MainWindowController: NSWindowController {

    //MARK: - My cool methods

    func fly() {
    }

    func turnInvisible() {

    }
}

2) In der jump barscheint sich beim Hinzufügen des //MARK: Kommentars nichts zu ändern . Wenn ich jedoch auf den Namen ganz rechts in der Sprungleiste klicke, heißt es in meinem Fall MainWindowController(with a leading C icon), wird ein Popup-Fenster mit den Auswirkungen des Kommentars // MARK: angezeigt, nämlich eine Überschrift mit der Aufschrift "Meine coolen Methoden":

3) Ich stelle auch fest, dass, wenn ich auf eine der Methoden in meinem Code klicke, die Methode zum Eintrag ganz rechts in der Sprungleiste wird. Um MainWindowController(with a leading C icon)der Eintrag ganz rechts in der Sprungleiste zu sein, muss ich auf das Leerzeichen über meinen Methoden klicken.

Apple gibt in der neuesten Version von Building Cocoa Apps an :

Der Swift-Compiler enthält keinen Präprozessor. Stattdessen werden Attribute zur Kompilierungszeit, Build-Konfigurationen und Sprachfunktionen verwendet, um dieselbe Funktionalität zu erzielen. Aus diesem Grund werden Präprozessoranweisungen nicht in Swift importiert.

Das # -Zeichen scheint immer noch so zu sein, wie Sie mit verschiedenen Build-Konfigurationen und ähnlichen Dingen arbeiten, aber es sieht so aus, als würden sie versuchen, Ihren Bedarf an Vorverarbeitung im Sinne von Pragma zu verringern und Sie insgesamt an andere Sprachfunktionen weiterzuleiten. Vielleicht soll dies dazu beitragen, dass die Spielplätze und die REPL so nah wie möglich am vollständig kompilierten Code sind.

Hinzufügen eines Aufgabenelements: Fügen Sie einen Kommentar mit dem Präfix TODO: ein. Zum Beispiel: // TODO: [Ihr Aufgabenelement].

Hinzufügen einer Bugfix-Erinnerung: Fügen Sie einen Kommentar mit dem Präfix FIXME: ein. Zum Beispiel: // FIXME: [Ihre Fehlerbehebungserinnerung].

Überschrift hinzufügen: Fügen Sie einen Kommentar mit dem Präfix MARK: ein. Zum Beispiel: // MARK: [Ihre Abschnittsüberschrift].

Trennlinie hinzufügen: Um ein Trennzeichen über einer Anmerkung hinzuzufügen, fügen Sie vor dem Kommentarteil der Anmerkung einen Bindestrich (-) ein. Zum Beispiel: // MARK: - [Ihr Inhalt]. Um ein Trennzeichen unter einer Anmerkung hinzuzufügen, fügen Sie nach dem Kommentarteil der Anmerkung einen Bindestrich (-) ein. Zum Beispiel: // MARK: [Ihr Inhalt] -.

Versuche dies:

// MARK: Reload TableView

func reloadTableView(){

    tableView.reload()
}

Pragma Mark ist eine Möglichkeit, die Lesbarkeit Ihres Codes zu verbessern. Die Pragma-Kommentare werden wie Tags in der Xcode-Sprungleiste angezeigt.

//MARK:  <Your comment goes here>

Beispiel: Im Code

//MARK: Properties

// MARK: View Life cycle

//MARK: Helper methods

So würde es in der Xcode-Sprungleiste erscheinen.