@Stroker-007 - Deine Erläuterungen lassen sich einfacher nachvollziehen, wenn du unterstützende Verlinkungen einfügst, z.B.
StringReplace vs
StrReplace(). HTH
Deine generelle Annahme, dass für die Funktion StrReplace() die Parameterangaben mittels Anführungszeichen grundsätzlich als Strings zu kennzeichnen seien, teile ich nicht.
Beispiel:
MsgBox % StrReplace(12345,3,9)
Kein einziger String, womit die von dir angemahnte Vorgabe, dass diese Parameter als Strings zu kennzeichnen wären nicht zwingend ist.
Deine vermeintlich "richtige" Auslegung sieht den (da nicht explicit als String deklarierten) Heuhaufen als Variable vor, doch auch dies ist nicht zwingend, da an deren Stelle auch ein String verwendbar wäre.
Daraus folgt, die Art der Darstellung in der AHK-Hilfe wie Parameter in Funktionen zu setzen sind, zielt nicht auf deren Schreibweise ab, sondern auf deren Position als auch Optionalität.
Weitere Details zu den jeweiligen Parametern werden übrigens direkt im Anschluß zur syntaktischen Darstellung ausgeführt. Die muß man/frau nur lesen wollen.
Ergänzend dazu gilt: in
Funktionen ist die Expression-Schreibweise anzuwenden. Damit erübrigt sich dein Einwand.
Befehle in der 'Legacy'-Schreibweise, welche (gefühlt mehrheitlich) als "deprecated"/veraltet gekennzeichnet sind, enthalten ggf noch Hinweise ob 'Expression'-Schreibweise möglich ist, oder ggf "forced"/erzwungen werden kann.
Beide Befehle auf 2 getrennten Seiten erklären, so wie es mit "StringGetPos" und "InStr()" bereits vorbildlich demonstriert wird. Geht doch...
Hierbei unterschlägst du, daß
InStr() die ersetzende Funktion für die Befehle
IfInString UND StringGetPos ist, was auch explizit angemerkt wird.
This function is a combination of IfInString and StringGetPos.
Womit die umfangreichere/abweichende Funktionalität eine "neue" Beschreibung notwendig machte. It's just that!
Ich gestehe zu, das z.B. für langjährigste AHK-Nutzer die Verwendung der "neueren" (mit AHK 2.x abermals veralteten) Syntax Widerstände provoziert.
Nevertheless, läßt sich auch hier, wie so oft im Leben, der Fortschritt nicht aufhalten. Frei nach dem Motto:
"Wer zuletzt kommt den bestraft das Leben"
[mention]Stroker-007[/mention] - Deine Erläuterungen lassen sich einfacher nachvollziehen, wenn du unterstützende Verlinkungen einfügst, z.B. :arrow: [docs]StringReplace[/docs] vs :arrow: [url=https://www.autohotkey.com/docs/commands/StrReplace.htm]StrReplace()[/url]. HTH
Deine generelle Annahme, dass für die Funktion StrReplace() die Parameterangaben mittels Anführungszeichen grundsätzlich als Strings zu kennzeichnen seien, teile ich nicht.
Beispiel:
[c]MsgBox % StrReplace(12345,3,9)[/c]
Kein einziger String, womit die von dir angemahnte Vorgabe, dass diese Parameter als Strings zu kennzeichnen wären nicht zwingend ist.
Deine vermeintlich "richtige" Auslegung sieht den (da nicht explicit als String deklarierten) Heuhaufen als Variable vor, doch auch dies ist nicht zwingend, da an deren Stelle auch ein String verwendbar wäre.
Daraus folgt, die Art der Darstellung in der AHK-Hilfe wie Parameter in Funktionen zu setzen sind, zielt nicht auf deren Schreibweise ab, sondern auf deren Position als auch Optionalität.
Weitere Details zu den jeweiligen Parametern werden übrigens direkt im Anschluß zur syntaktischen Darstellung ausgeführt. Die muß man/frau nur lesen wollen.
Ergänzend dazu gilt: in :arrow: [url=https://www.autohotkey.com/docs/Functions.htm#intro]Funktionen[/url] ist die Expression-Schreibweise anzuwenden. Damit erübrigt sich dein Einwand.
Befehle in der 'Legacy'-Schreibweise, welche (gefühlt mehrheitlich) als "deprecated"/veraltet gekennzeichnet sind, enthalten ggf noch Hinweise ob 'Expression'-Schreibweise möglich ist, oder ggf "forced"/erzwungen werden kann.
[quote]Beide Befehle auf 2 getrennten Seiten erklären, so wie es mit "StringGetPos" und "InStr()" bereits vorbildlich demonstriert wird. Geht doch...[/quote]
Hierbei unterschlägst du, daß :arrow: [docs]InStr()[/docs] die ersetzende Funktion für die Befehle :arrow: [docs]IfInString[/docs] [b]UND[/b] [docs]StringGetPos[/docs] ist, was auch explizit angemerkt wird.
[quote]This function is a combination of IfInString and StringGetPos.[/quote]
Womit die umfangreichere/abweichende Funktionalität eine "neue" Beschreibung notwendig machte. It's just that!
Ich gestehe zu, das z.B. für langjährigste AHK-Nutzer die Verwendung der "neueren" (mit AHK 2.x abermals veralteten) Syntax Widerstände provoziert.
Nevertheless, läßt sich auch hier, wie so oft im Leben, der Fortschritt nicht aufhalten. Frei nach dem Motto: [i]"Wer zuletzt kommt den bestraft das Leben"[/i]