Wenn dieses Flag angegeben wird, wird die Eingabezeichenfolge, die das Muster angibt, als eine Sequenz von Literalzeichen behandelt. Metazeichen oder Escapesequenzen in der Eingabesequenz erhalten keine besondere Bedeutung. Es stellt sich heraus, dass viele Kommentare, und in einigen Code vielleicht die meisten, da sind, um zu klären, was der Code tut. Es ist oft möglich, den Code besser für sich sprechen zu lassen, indem er ausdrucksstärker wird. Ein besonderer Vorteil dabei ist, dass Code eindeutig ist und es ziemlich schwierig ist, Englisch (oder Ihre menschliche Sprache Ihrer Wahl) eindeutig zu schreiben. In diesem Beispiel ist die Arrange-Phase so kompliziert, dass ich sie in verschiedene Abschnitte unterteilen musste, um sie etwas besser lesbar zu machen. Da ich Leerzeichen verwenden musste, um die verschiedenen Abschnitte anzuzeigen, benötige ich einen anderen Mechanismus, um die drei AAA-Phasen anzuzeigen. Codekommentare sind eine einfache Möglichkeit, dies zu tun. Ich sehe Kommentare als Dunkle Seelen Blutflecken, hinterlässt eine Nachricht für den zukünftigen Abenteurer, kann es jemand anderes oder Sie von einem Jahr oder so sein Beispiel: Dieses Beispiel geht das gleiche für C und C++, da der Stil des Kommentierens bleibt für beide Sprache gleich. Viele Programmierer verwenden das AAA-Muster, indem sie jede Phase explizit mit einem Codekommentar kennzeichnen: Erklären Sie “was” mithilfe von Code. Erläutern Sie “Warum” mithilfe von Kommentaren.

In diesem klassischen frühen BASIC-Codefragment wird das Schlüsselwort REM (“Remark”) verwendet, um Kommentare hinzuzufügen. Wie ich vor ein paar Wochen in diesem Blog besprochen habe, gibt es einen großen Unterschied zwischen dem Schreiben von Code und “Zukunft Sie”, Ihrem Team und allen anderen, die Code lesen. Hier ist, was ich über kommentare in Swift Style zu sagen habe: Angesichts eines Beispiels wie dem oben genannten, scheint dies wie ein gutartiger Ansatz, aber die obligatorische Verwendung von Code-Kommentaren beginnt auseinander zu fallen, wenn Tests sehr einfach sind. Beachten Sie die Verwendung von Codekommentaren, um den Beginn jeder der drei Phasen anzugeben. Wir sehen deutlich, dass das Arrange-Act-Assert-Muster für Feature-Tests sowie Komponententests funktioniert. Experten haben unterschiedliche Standpunkte dazu, ob und wann Kommentare im Quellcode angebracht sind. [9] [29] Einige behaupten, dass Quellcode mit wenigen Kommentaren geschrieben werden sollte, auf der Grundlage, dass der Quellcode selbsterklärend oder selbstdokumentierend sein sollte. [9] Andere schlagen vor, dass Code ausführlich kommentiert werden sollte (es ist nicht ungewöhnlich, dass über 50 % der Nicht-Leerzeichen im Quellcode in Kommentaren enthalten sind).

[30] [31] Hier ist der Kommentar wirklich nicht notwendig, da es leicht zu verstehen ist, was zurückgegeben wird. Der einzige Grund, warum ich mit, wie dieser Kommentar eingeführt werden kann, war, dass der Entwickler Kommentare verwendet, um die Methode zu zuordnen, bevor sie tatsächlichen Code hinzufügen, dann nicht die Kommentare zu entfernen. Aber das scheint mir wie eine Strecke zu sein … insbesondere dann, wenn ein Codeüberprüfungsprozess eingerichtet wurde.