Namensgebung - Path oder Directory oder Dir

[bernau]

Die Vergabe von anständigen Bezeichnern ist nicht wirklich meins. Beim Durchforsten von altem Code fällt mir immer wieder auf, welchen Mist ich mir ausgedacht habe. Nun ja, ich versuche dann meinen Code aufzuräumen.

Ein Thema ist folgendes: Bei der Angabe von Verzeichnissen verwende ich mal das Anhängsel "Path", dann mal "Directory" und auch mal "Dir"

Ich Beispiel nehme ich mal das Updateverzeichnis. Dabei kommen folgende Namen (in verschiedenen Programmen) vor:

• UpdatePath
• UpdateDirectory
• UpdateDir
• UpdateVerzeichnis

(Vorab: Bitte nicht über den Präfix "Update" diskutieren. Kann auch jede andere Bedeutung gemeint sein)

Was wäre euerer Meinung nach die sinnvollste Bezeichnung für ein "Verzeichnis".

[Klaus01]

Hallo,

ich würde "Folder" oder "Directory" nehmen.
Ein Path != Directory
Ein Path hat ein Backslash am Ende, ein Directory nicht.

Grüße
Klaus

[Perlsau]

Was in diesem Fall objektiv oder allgemeingültig als sinnvoll zu bezeichnen wäre, kann meiner Ansicht nach nicht zuverlässig ermittelt werden. Mit anderen Worten: Sinnvoll ist bei der Namensvergebung das, was dir sinnvoll erscheint. Das muß nicht zwangsläufig das sein, was anderen sinnvoll erscheint. Manche würden vielleicht DIR vorziehen, weil es kurz und aussagekräftig ist, andere aus ähnlichem Grund vielleicht PATH, wieder andere vielleicht VERZ oder ORDN, weil sie mit dem Englischen nicht so vertraut sind. Es kommt letztendlich darauf an, daß du deine Bezeichner und Präfixe konsequent vergibst, damit sie auch die beabsichtigte Hilfsfunktion ausüben können: Am Namen schnell erkennen zu können, um was für einen Bezeichner-Typ es sich genau handelt.

[hathor]

DELPHI legt sich da offensichtlich nicht fest...

procedure ProcessPath (const EditText: string; var Drive: Char; var DirPart: string; var FilePart: string);
---
Zerlegt einen Dateinamen in seine einzelnen Bestandteile.

Mit Hilfe von ProcessPath kann ein Dateiname in seine Bestandteile Laufwerk, Pfad und Dateibezeichnung zerlegt werden.

Der vollständige Dateiname wird als Parameter EditText übergeben. EditText muss einen vorhandenen Datei- oder Verzeichnisnamen bezeichnen.

ProcessPath gibt die einzelnen Elemente (Laufwerk, Verzeichnis und Dateibezeichnung) in den Parametern Drive, DirPart und FilePart zurück.

Ich würde sagen:
Pfad enthält Laufwerk + Verzeichnis evtl. + Dateibezeichnung
Dir enthält nur Verzeichnis.

[Sir Rufo]

Es gibt

• Datei-Pfad (der Pfad zu einer Datei)
  
  Code:

  C:\Users\Common\Desktop\Datei.txt

• Verzeichnis-Pfad (der Pfad zu einem Verzeichnis)
  
  Code:

  C:\Users\Common\Desktop

• den Pfad von einem Datei-Pfad
  
  Code:

  C:\Users\Common\Desktop\

• das Verzeichnis von einem Datei-Pfad
  
  Code:

  C:\Users\Common\Desktop

Wichtig ist dabei die Unterscheidung, wenn man den Pfad haben möchte von

• einem Verzeichnis
  Code:

  C:\Users\Common\Desktop =PATH=> C:\Users\Common\

• einem Pfad
  Code:

  C:\Users\Common\Desktop\ =PATH=> C:\Users\Common\Desktop\

Und wenn man das Verzeichnis haben möchte von

• einem Verzeichnis
  Code:

  C:\Users\Common\Desktop =DIR=> C:\Users\Common

• einem Pfad
  Code:

  C:\Users\Common\Desktop\ =DIR=> C:\Users\Common\Desktop

[Luckie]

Und nicht vergessen die Differenzierung zwischen Folder und Directory. http://blogs.msdn.com/b/oldnewthing/.../10129908.aspx

[Dejan Vu]

Aha! Das ist einfach.
Moment: Der Pfad eines Verzeichnispfades ist nicht der Pfad zu einem Verzeichnis, weil der Pfad zu einem Verzeichnis ja der Verzeichnispfad ist.
Aber ein Verzeichnis zu einem Dateipfad entspricht dem Verzeichnispfad zur Datei. Logisch: Der Pfad des Verzeichnisses zu einem Dateipfad ist dann auch etwas anderes als der Pfad zum Verzeichnispfad zur Datei. Jetzt hab ichs.

[Sir Rufo]

Wer sich mit Windows auskennt, der weiß das natürlich schon längst.

So ist ein Datei/Verzeichnispfad aufgebaut:

Code:

FILE/DIR-PATH = <PATH><NAME[.<EXTENSION>]>
PATH = <ROOT>\[<NAME>\[...]]
ROOT = <DRIVE>: | \\<SERVER>\<SHARE> | . | .. | (gibt noch weitere)

Also einem Pfad, einem Namen und einer optionalen Erweiterung.

Wenn man sprachlich und fachlich ganz genau sein will, dann würde man schreiben müssen:

Delphi-Quellcode:

ConfigFilePath // C:\Users\Public\Desktop\Config\Data.txt
ConfigFileName // Data.txt
ConfigDirPath // C:\Users\Public\Desktop\Config
PathOfConfigFile // C:\Users\Public\Desktop\Config\
PathOfConfigDir // C:\Users\Public\Desktop\

Man kann da allerdings auch ein Ei drauf schlagen, sich eine Bezeichnungs-Richtlinie ausdenken, diese dokumentieren und dann konsequent durchziehen. Die konkrete Arbeit mit Dateien fällt ja eh in den Randbereich der Anwendung, von daher wirkt sich das auch nicht so stark auf die Anwendung selber aus.

[mm1256]

Die Beiträge ab #2 haben meiner bescheidenen Meinung nach lediglich Potential für "Verschlimmbesserung".

Zitat von Klaus01:

Ein Path hat ein Backslash am Ende, ein Directory nicht.

das hat sich doch zwischenzeitlich als Quasi-Standard bei den Komponenten-Entwicklern durchgesetzt. Aber, kann ja jeder halten wie er will.

Zitat:

Code:

ConfigFilePath // C:\Users\Public\Desktop\Config\Data.txt
...

Ein FilePath mit einem Dateinamen am Schluss ist daher für mich unlogisch.

Code:

ConfigFileName // C:\Users\Public\Desktop\Config\Data.txt
ConfigFilePath // C:\Users\Public\Desktop\Config\
ConfigFileDir // C:\Users\Public\Desktop\Config

[p80286]

Zitat von mm1256:

Ein FilePath mit einem Dateinamen am Schluss ist daher für mich unlogisch.

[Korinthenkackermodus]
Das macht den FilePath ja zum FilePath sonst wäre es ja ein ganz einfacher Path!
[/Korinthenkackermodus]

"Path ist mit dem / am Ende" ist zwar nicht korrekt, aber als Orientierungshilfe, brauchbar.

@Sir Rufo
vielen Dank für die allgemaingültige Beschreibung.

Gruß
K-H