Difference between revisions of "IDE Macros in paths and filenames/de"

From Lazarus wiki
Jump to navigationJump to search
m
(categories)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{IDE Macros in paths and filenames}}
 
{{IDE Macros in paths and filenames}}
  
* Col - aktuelle Spalte im Quelltexteditor
+
Macros verwenden das folgende Format. Dabei wird ''macro-name'' durch eines der unten aufgelisteten Macros ersetzt.
* Row - aktuelle Zeile im Quelltexteditor
+
 
* CompPath - Compilerpfad gesetzt in den Umgebungseinstellungen
+
$(macro-name)
* CurToken - current token at the cursor in the source editor
+
 
* EdFile - aktueller Dateiname im Quelltexteditor
+
Beispiel: Dieses Format gibt das Ausgabeverzeichnis für Units an. Es wird häufig für Lazarus Packages benutzt:
* ExeExt - executable Dateierweiterung
+
 
* FPCSrcDir - FPC Quellverzeichnis gesetzt in den Umgebungseinstellungen
+
lib/$(TargetCPU)-$(TargetOS)
* LazarusDir - Lazarus Quellverzeichnis gesetzt in den Umgebungseinstellungen
+
 
* LCLWidgetType - LCL widgetset des aktuellen Projekts
+
unter einem x86 Linux 32-bit System würde daraus:  '''lib/i386-linux''' <br>
* TargetCPU - Ziel CPU des aktuellen Projekts
+
unter einem x86 Linux 64-bit System würde daraus:  '''lib/x86_64-linux'''
* TargetOS - Ziel OS des aktuellen Projekts
+
 
* SrcOS - 'unix' für Linux, Darwin, BSD. 'win' für win32, win64, wince
+
Es gibt auch einige '''Macrofunktionen''' die folgendes Format verwenden:
* FPCVer - FPC Version (seit 0.9.25). Zum Beispiel '2.2.2'.
+
$macro_name(parameters)
* LanguageID - IDE Sprache, zum Beispiel en für Englisch, de für Deutsch
+
 
* LanguageName - IDE Sprachname, der übersetzte Name der aktuellen Sprache. Zum Beispiel: Deutsch für german.
+
Beispiel:
* Params - Startparameter des aktuellen Projekts
+
$Ext(unit1.pas)
* Prompt - fragt den Benutzer nach einem Wert. Dies ist ein interaktives Makro.
+
 
* ProjFile - der vollständige Dateiname der Hauptquelldatei des aktuellen Projekts (.lpr)
+
liefert die Dateierweiterung ''.pas''.
* ProjPath - das Projektverzeichnis (das Verzeichnis der .lpi Datei)
+
 
* Save - speichert die aktuelle Datei im Quelltexteditor
+
 
* SaveAll - Alles speichern
+
==Allgemeine Verwendung==
* TargetFile - die Ausgabedatei des aktuellen Projekts (z.B. das executable oder die Bibliothek)
+
* '''Col''' - aktuelle Spalte im Quelltexteditor
* TargetCmdLine - das Projekt-executable plus Startparameter
+
* '''Row''' - aktuelle Zeile im Quelltexteditor (Bildschirm, kann von der Byte-Position abweichen aufgrund von Tabulatoren und UTF-8)
* TestDir - Testverzeichnis gesetzt in den Umgebungseinstellungen
+
* '''CurToken''' - aktuelles Element unter dem Kursor im Quelltexteditor
* RunCmdLine - das Kommando zum Starten des Projekts
+
* '''EdFile''' - aktueller Dateiname im Quelltexteditor
* ProjPublishDir - publishing Verzeichnis des aktuellen Projekts
+
* '''Params''' - Startparameter des aktuellen Projekts
* ProjUnitPath - Unitpfad des Projektverzeichnisses
+
* '''Prompt''' - fragt den Benutzer nach einem Wert. Dies ist ein interaktives Makro.
* ProjIncPath - Includepfad des Projektverzeichnisses
+
* '''RunCmdLine''' - der Befehl zum Starten des Projekts
* ProjSrcPath - Quellpfad des Projektverzeichnisses
+
* '''Save''' - speichert die aktuelle Datei im Quelltexteditor
* ProjOutDir - Pfad des Projekt-Ausgabeverzeichnisses (z.B. wo die .ppu Dateien erzeugt werden) (seit 0.9.27)
+
* '''SaveAll''' - Alles speichern
* ConfDir - Verzeichnis in dem die IDE ihre Konfigurationsdateien speichert
+
* '''TargetCmdLine''' - das Projekt-executable plus Startparameter
* MakeExe - Pfad zum 'make' Programm (gmake unter BSD)
+
 
* Project() - Makrofunktion für verschiedene Werte
+
==Dateinamen und Teile davon==
** Project(UnitPath) - Unitpfad des Projektverzeichnisses
+
* '''Ext(filename)''' - Makrofunktion für ExtractFileExt
** Project(SrcPath) - Quellpfad des Projektverzeichnisses
+
* '''MakeDir(filename)''' - Makrofunktion für AppendPathDelim
** Project(IncPath) - Includepfad des Projektverzeichnisses
+
* '''MakeFile(filename)''' - Makrofunktion für ChompPathDelim
** Project(InfoFile) - Dateiname der .lpi Datei (seit Revision 15287, 0.9.25)
+
* '''MakeExe(filename)''' - ändert die Dateierweiterung nach .exe unter Windows, nichts unter Linux, BSD, OS X
** Project(OutputDir) - Verzeichnis, in dem die Projekt ppu Dateien angelegt werden (seit 0.9.27)
+
* '''MakeLib(filename)''' - ändert die Dateierweiterung nach .dll unter Windows, unter Linux/BSD nach libname.so (kleingeschrieben), unter OS X nach libname.so (seit Version 0.9.29)
* Ext() - Makrofunktion für ExtractFileExt
+
* '''Name(filename)''' - Makrofunktion für ExtractFileName
* Path() - Makrofunktion für ExtractFilePath
+
* '''NameOnly(filename)''' - Makrofunktion für ExtractFileNameOnly
* Name() - Makrofunktion für ExtractFileName
+
* '''Path(filename)''' - Makrofunktion für ExtractFilePath
* NameOnly() - Makrofunktion für ExtractFileNameOnly
+
 
* MakeDir() - Makrofunktion für AppendPathDelim
+
==Pfade und Teile davon==
* MakeFile() - Makrofunktion für ChompPathDelim
+
* '''Env(name)''' - Makrofunktion für an die IDE übergebene Umgebungsvariablen (nicht an Projekt oder Debugger) (siehe [http://lazarus-ccr.sourceforge.net/docs/lcl/fileutil/getenvironmentvariableutf8.html GetEnvironmentVariableUTF8]) (seit Version 0.9.27)
* PkgDir() - Makrofunktion für das Verzeichnis (Ort der .lpk Datei) einer als Parameter übergebenen Package ID
+
* '''CompPath''' - Compilerpfad gesetzt in den Umgebungseinstellungen. Kann nicht das Makro FPCVer benutzen, aber Sie können die Makros LazarusDir und Env benutzen.
* PkgSrcPath() - Makrofunktion für den Quellpfad einer als Parameter übergebenen Package ID
+
* '''ConfDir''' - Verzeichnis in dem die IDE ihre Konfigurationsdateien speichert
* PkgUnitPath() - Makrofunktion für den Unitpfad einer als Parameter übergebenen Package ID
+
* '''ExeExt''' - ausführbare Dateierweiterung für das Betriebssytem, unabhängig vom Ziel-OS des Projektes. Für die Erweiterung für das Ziel-OS des aktuellen Projekts verwenden Sie $MakeExe().
* PkgIncPath() - Makrofunktion für den Includepfad einer als Parameter übergebenen Package ID
+
* '''FPCSrcDir''' - FPC Quellverzeichnis gesetzt in den Umgebungseinstellungen
* PkgOutDir() - Makrofunktion für das Ausgabeverzeichnis eines Packages (z.B. wo die ppu Dateien erzeugt werden)
+
* '''FPCVer''' - FPC Version (seit 0.9.25). Zum Beispiel '2.4.2'. Diese Version stammt von dem Compiler $(CompPath), dessen Pfad in den Umgebungseinstellungen gesetzt ist.
 +
* '''LanguageID''' - IDE Sprache, zum Beispiel en für Englisch, de für Deutsch
 +
* '''LanguageName''' - IDE Sprachname, der übersetzte Name der aktuellen Sprache. Zum Beispiel: Deutsch für german.
 +
* '''LazarusDir''' - Lazarus Quellverzeichnis gesetzt in den Umgebungseinstellungen. Keine Makros erlaubt.
 +
* '''LCLWidgetType''' - LCL widgetset des aktuellen Projekts
 +
* '''ProjFile''' - der vollständige Dateiname der Hauptquelldatei des aktuellen Projekts (.lpr)
 +
* '''ProjPath''' - das Projektverzeichnis (das Verzeichnis der .lpi Datei)
 +
* '''TargetFile''' - die Ausgabedatei des aktuellen Projekts (z.B. das executable oder die Bibliothek)
 +
* '''TestDir''' - Testverzeichnis gesetzt in den Umgebungseinstellungen
 +
* '''SrcOS''' - 'unix' für Linux, Darwin, BSD. 'win' für win32, win64, wince
 +
* '''TargetCPU''' - Ziel CPU des aktuellen Projekts. Im Makefile: %(CPU_TARGET)
 +
* '''TargetOS''' - Ziel OS des aktuellen Projekts. Im Makefile: %(OS_TARGET)
 +
* '''LCLWidgetType''' - LCL Widgettyp des aktuellen Projekts. Im Makefile: %(LCL_PLATFORM)
 +
* '''Make''' - Pfad zum 'make' Programm (gmake unter BSD) (seit Version 0.9.29)
 +
* '''ProjIncPath''' - Includepfad des Projektverzeichnisses
 +
* '''ProjOutDir''' - Pfad des Projekt-Ausgabeverzeichnisses (z.B. wo die .ppu Dateien erzeugt werden) (seit 0.9.27)
 +
* '''ProjPublishDir''' - Verzeichnis für Veröffentlichung des aktuellen Projekts
 +
* '''ProjSrcPath''' - Quellpfad des Projektverzeichnisses
 +
* '''ProjUnitPath''' - Unitpfad des Projektverzeichnisses
 +
* '''Project(param)''' - Makrofunktion für verschiedene Werte:
 +
** '''Project(UnitPath)''' - Unitpfad des Projektverzeichnisses
 +
** '''Project(SrcPath)''' - Quellpfad des Projektverzeichnisses
 +
** '''Project(IncPath)''' - Includepfad des Projektverzeichnisses
 +
** '''Project(InfoFile)''' - Dateiname der .lpi Datei (seit Revision 15287, 0.9.25)
 +
** '''Project(OutputDir)''' - Verzeichnis, in dem die Projekt ppu Dateien angelegt werden (seit 0.9.27)
 +
* '''Package macros''' - diese können in den Feldern eines Packages stehen. Zum Beispiel in den Suchpfaden von einem Package. Um sie woanders einzusetzen übergeben Sie einen Packagenamen als Parameter.
 +
** '''PkgDir()''' - Makrofunktion für das Verzeichnis (Ort der .lpk Datei) einer als Parameter übergebenen Package ID
 +
** '''PkgIncPath(id)''' - Makrofunktion für den Includepfad einer als Parameter übergebenen Package ID
 +
** '''PkgOutDir(id)''' - Makrofunktion für das Ausgabeverzeichnis eines Packages (d.h. wo die .ppu Dateien erzeugt werden)
 +
** '''PkgSrcPath(id)''' - Makrofunktion für den Quellpfad einer als Parameter übergebenen Package ID
 +
** '''PkgUnitPath(id)''' - Makrofunktion für den Unitpfad einer als Parameter übergebenen Package ID
 +
* '''IDEBuildOptions''' - die Extra-Options des 'Configure Build Lazarus' Dialogs (seit Version 0.9.29). Im Makefile leer.
 +
* '''PrimaryConfigPath''' - das Verzeichnis der IDE Konfigurationsdateien (seit Version 0.9.31)
 +
* '''SecondaryConfigPath''' - das Verzeichnis der IDE Konfigurations-Vorlagen (seit Version 0.9.31)
 +
* '''FallbackOutputRoot''' - das Verzeichnis wo die IDE die .ppu Dateien ablegt, wenn das Ausgabeverzeichnis schreibgeschützt ist. Vorgabe: $(PrimaryConfigPath)/lib. Seit Version 0.9.31.
 +
 
 +
 
 +
{{AutoCategory}}
 +
[[Category:Lazarus/de]]
 +
[[Category:IDE Macros/de]]

Latest revision as of 21:35, 7 June 2015

Deutsch (de) English (en) español (es) français (fr) português (pt) русский (ru)

Macros verwenden das folgende Format. Dabei wird macro-name durch eines der unten aufgelisteten Macros ersetzt.

$(macro-name)

Beispiel: Dieses Format gibt das Ausgabeverzeichnis für Units an. Es wird häufig für Lazarus Packages benutzt:

lib/$(TargetCPU)-$(TargetOS)

unter einem x86 Linux 32-bit System würde daraus: lib/i386-linux
unter einem x86 Linux 64-bit System würde daraus: lib/x86_64-linux

Es gibt auch einige Macrofunktionen die folgendes Format verwenden:

$macro_name(parameters)

Beispiel:

$Ext(unit1.pas)

liefert die Dateierweiterung .pas.


Allgemeine Verwendung

  • Col - aktuelle Spalte im Quelltexteditor
  • Row - aktuelle Zeile im Quelltexteditor (Bildschirm, kann von der Byte-Position abweichen aufgrund von Tabulatoren und UTF-8)
  • CurToken - aktuelles Element unter dem Kursor im Quelltexteditor
  • EdFile - aktueller Dateiname im Quelltexteditor
  • Params - Startparameter des aktuellen Projekts
  • Prompt - fragt den Benutzer nach einem Wert. Dies ist ein interaktives Makro.
  • RunCmdLine - der Befehl zum Starten des Projekts
  • Save - speichert die aktuelle Datei im Quelltexteditor
  • SaveAll - Alles speichern
  • TargetCmdLine - das Projekt-executable plus Startparameter

Dateinamen und Teile davon

  • Ext(filename) - Makrofunktion für ExtractFileExt
  • MakeDir(filename) - Makrofunktion für AppendPathDelim
  • MakeFile(filename) - Makrofunktion für ChompPathDelim
  • MakeExe(filename) - ändert die Dateierweiterung nach .exe unter Windows, nichts unter Linux, BSD, OS X
  • MakeLib(filename) - ändert die Dateierweiterung nach .dll unter Windows, unter Linux/BSD nach libname.so (kleingeschrieben), unter OS X nach libname.so (seit Version 0.9.29)
  • Name(filename) - Makrofunktion für ExtractFileName
  • NameOnly(filename) - Makrofunktion für ExtractFileNameOnly
  • Path(filename) - Makrofunktion für ExtractFilePath

Pfade und Teile davon

  • Env(name) - Makrofunktion für an die IDE übergebene Umgebungsvariablen (nicht an Projekt oder Debugger) (siehe GetEnvironmentVariableUTF8) (seit Version 0.9.27)
  • CompPath - Compilerpfad gesetzt in den Umgebungseinstellungen. Kann nicht das Makro FPCVer benutzen, aber Sie können die Makros LazarusDir und Env benutzen.
  • ConfDir - Verzeichnis in dem die IDE ihre Konfigurationsdateien speichert
  • ExeExt - ausführbare Dateierweiterung für das Betriebssytem, unabhängig vom Ziel-OS des Projektes. Für die Erweiterung für das Ziel-OS des aktuellen Projekts verwenden Sie $MakeExe().
  • FPCSrcDir - FPC Quellverzeichnis gesetzt in den Umgebungseinstellungen
  • FPCVer - FPC Version (seit 0.9.25). Zum Beispiel '2.4.2'. Diese Version stammt von dem Compiler $(CompPath), dessen Pfad in den Umgebungseinstellungen gesetzt ist.
  • LanguageID - IDE Sprache, zum Beispiel en für Englisch, de für Deutsch
  • LanguageName - IDE Sprachname, der übersetzte Name der aktuellen Sprache. Zum Beispiel: Deutsch für german.
  • LazarusDir - Lazarus Quellverzeichnis gesetzt in den Umgebungseinstellungen. Keine Makros erlaubt.
  • LCLWidgetType - LCL widgetset des aktuellen Projekts
  • ProjFile - der vollständige Dateiname der Hauptquelldatei des aktuellen Projekts (.lpr)
  • ProjPath - das Projektverzeichnis (das Verzeichnis der .lpi Datei)
  • TargetFile - die Ausgabedatei des aktuellen Projekts (z.B. das executable oder die Bibliothek)
  • TestDir - Testverzeichnis gesetzt in den Umgebungseinstellungen
  • SrcOS - 'unix' für Linux, Darwin, BSD. 'win' für win32, win64, wince
  • TargetCPU - Ziel CPU des aktuellen Projekts. Im Makefile: %(CPU_TARGET)
  • TargetOS - Ziel OS des aktuellen Projekts. Im Makefile: %(OS_TARGET)
  • LCLWidgetType - LCL Widgettyp des aktuellen Projekts. Im Makefile: %(LCL_PLATFORM)
  • Make - Pfad zum 'make' Programm (gmake unter BSD) (seit Version 0.9.29)
  • ProjIncPath - Includepfad des Projektverzeichnisses
  • ProjOutDir - Pfad des Projekt-Ausgabeverzeichnisses (z.B. wo die .ppu Dateien erzeugt werden) (seit 0.9.27)
  • ProjPublishDir - Verzeichnis für Veröffentlichung des aktuellen Projekts
  • ProjSrcPath - Quellpfad des Projektverzeichnisses
  • ProjUnitPath - Unitpfad des Projektverzeichnisses
  • Project(param) - Makrofunktion für verschiedene Werte:
    • Project(UnitPath) - Unitpfad des Projektverzeichnisses
    • Project(SrcPath) - Quellpfad des Projektverzeichnisses
    • Project(IncPath) - Includepfad des Projektverzeichnisses
    • Project(InfoFile) - Dateiname der .lpi Datei (seit Revision 15287, 0.9.25)
    • Project(OutputDir) - Verzeichnis, in dem die Projekt ppu Dateien angelegt werden (seit 0.9.27)
  • Package macros - diese können in den Feldern eines Packages stehen. Zum Beispiel in den Suchpfaden von einem Package. Um sie woanders einzusetzen übergeben Sie einen Packagenamen als Parameter.
    • PkgDir() - Makrofunktion für das Verzeichnis (Ort der .lpk Datei) einer als Parameter übergebenen Package ID
    • PkgIncPath(id) - Makrofunktion für den Includepfad einer als Parameter übergebenen Package ID
    • PkgOutDir(id) - Makrofunktion für das Ausgabeverzeichnis eines Packages (d.h. wo die .ppu Dateien erzeugt werden)
    • PkgSrcPath(id) - Makrofunktion für den Quellpfad einer als Parameter übergebenen Package ID
    • PkgUnitPath(id) - Makrofunktion für den Unitpfad einer als Parameter übergebenen Package ID
  • IDEBuildOptions - die Extra-Options des 'Configure Build Lazarus' Dialogs (seit Version 0.9.29). Im Makefile leer.
  • PrimaryConfigPath - das Verzeichnis der IDE Konfigurationsdateien (seit Version 0.9.31)
  • SecondaryConfigPath - das Verzeichnis der IDE Konfigurations-Vorlagen (seit Version 0.9.31)
  • FallbackOutputRoot - das Verzeichnis wo die IDE die .ppu Dateien ablegt, wenn das Ausgabeverzeichnis schreibgeschützt ist. Vorgabe: $(PrimaryConfigPath)/lib. Seit Version 0.9.31.