AGB  ·  Datenschutz  ·  Impressum  







Anmelden
Nützliche Links
Registrieren
Zurück Delphi-PRAXiS Delphi-PRAXiS - Lounge Klatsch und Tratsch Eure besten Quellcode Kommentare...
Thema durchsuchen
Ansicht
Themen-Optionen

Eure besten Quellcode Kommentare...

Ein Thema von Relicted · begonnen am 20. Jul 2007 · letzter Beitrag vom 1. Okt 2022
 
Benutzerbild von Tonic1024
Tonic1024

Registriert seit: 10. Sep 2003
Ort: Cuxhaven
559 Beiträge
 
RAD-Studio 2009 Ent
 
#19

AW: Eure besten Quellcode Kommentare...

  Alt 13. Dez 2013, 13:58
Das ist ein Zeichen dafür, dass deine Methoden zu lang sind.
Das ist reine Theorie.

Wenn man zum Beispiel einem Webserver einige Aufgaben gibt, so steht der Code im Indys OnCommandGet Routine. Wenn man jetzt hin geht und die individuelle Parameter Detektion in eine Funktion auslagert und jede einzelne Aufgabe in eine separate Funktion auslagert braucht man dennoch die selben 10 Zeilen (okay, sehr ähnliche 10 Zeilen) im Code wieder und wieder und wieder untereinander. Ein fürs Auge leicht wieder zu findender grüner "Eyecatcher" ist beim scrollen sehr hilfreich. Die Länge der Methode ist damit, unabhängig davon ob man ein Buch gelesen hat oder nicht, direkt abhängig vom Funktionsumfang des Servers. Nur mal ein Beispiel.

Oder ein Gegensätzliches. Wenn man komplexe aber dennoch überschaubare Aufgaben (z.B. Stream empfangen, manipulieren und weiterleiten) solange in separate Routinen aufteilt bis kaum noch ersichtlich ist welche Nebenwirkungen eine Änderung in einer Sub-Sub-Routine hätte ist das auch nicht besonders übersichtlich.

Ich wundere mich warum hier so eine Abneigung gegen Kommentare mit optischem Charakter herrscht. Ich hab noch beigebracht bekommen über jede Routine einen Funktionsbeschreibung, Parameterdefinition, Precondition und Postcondition zu tippen.
Der frühe Vogel fängt den Wurm, richtig.
Aber wird nicht auch der frühe Wurm vom Vogel gefressen?

Geändert von Tonic1024 (13. Dez 2013 um 14:09 Uhr)
  Mit Zitat antworten Zitat
 

 

Forumregeln

Es ist dir nicht erlaubt, neue Themen zu verfassen.
Es ist dir nicht erlaubt, auf Beiträge zu antworten.
Es ist dir nicht erlaubt, Anhänge hochzuladen.
Es ist dir nicht erlaubt, deine Beiträge zu bearbeiten.

BB-Code ist an.
Smileys sind an.
[IMG] Code ist an.
HTML-Code ist aus.
Trackbacks are an
Pingbacks are an
Refbacks are aus

Gehe zu:

Impressum · AGB · Datenschutz · Nach oben
Alle Zeitangaben in WEZ +1. Es ist jetzt 01:28 Uhr.
Powered by vBulletin® Copyright ©2000 - 2025, Jelsoft Enterprises Ltd.
LinkBacks Enabled by vBSEO © 2011, Crawlability, Inc.
Delphi-PRAXiS (c) 2002 - 2023 by Daniel R. Wolf, 2024 by Thomas Breitkreuz