Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
de:cachevariables [2022/05/14 11:23] – angelegt lineflyer | de:cachevariables [2022/05/14 13:09] – Fixme entfernt lineflyer | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | FIXME **Diese Seite wurde noch nicht vollständig übersetzt. Bitte helfen Sie bei der Übersetzung.**\\ //(diesen Absatz entfernen, wenn die Übersetzung abgeschlossen wurde)// | ||
- | |||
====== Cache-Variablen ====== | ====== Cache-Variablen ====== | ||
===== Einleitung ===== | ===== Einleitung ===== | ||
- | c:geo bietet für jede [[.: | + | c:geo bietet für jede [[.: |
{{ : | {{ : | ||
Zeile 11: | Zeile 9: | ||
Dies kann praktisch sein, wenn du z.B. einen Multi-Cache suchst, der es erfordert draußen im Feld bestimmte Werte zu sammeln und mit diesen mathematische Berechnungen durchzuführen um zur nächsten Station oder zum Final zu gelangen. | Dies kann praktisch sein, wenn du z.B. einen Multi-Cache suchst, der es erfordert draußen im Feld bestimmte Werte zu sammeln und mit diesen mathematische Berechnungen durchzuführen um zur nächsten Station oder zum Final zu gelangen. | ||
- | Du kannst | + | Du kannst |
- | Der folgende Abschnitt dieser Seite beschreibt den Inhalt und die Funktionen | + | Der folgende Abschnitt dieser Seite beschreibt den Inhalt und die Funktionen |
- | ===== Control section | + | ===== Kontrollbereich |
- | On the top of the variable tab you will see a set of buttons offering functions to populate the variable section below: | + | Oben in der Ansicht sieht du einige Schaltflächen, |
{{ : | {{ : | ||
- | ^ Button | + | ^ Schaltfläche |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | ===== Variable section | + | ===== Variablenbereich |
{{ : | {{ : | ||
- | This section allows you the enter the value or formula for the generated variables. You can perform the following actions here: | + | Dieser Bereich ermöglicht es einen Wert oder eine Formel für die erstellen Variablen einzugeben. Du kannst hier die folgenden Aktionen durchführen: |
- | ^ Button | + | ^ Schaltfläche |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | |{{: | + | |{{: |
- | The text below the value field will show a result preview. This can either be the concrete result of the formula or hints regarding syntax errors or missing values. | + | Der Text unter dem Variablenfeld zeigt eine Vorschau des Ergebnisses. Dies ist entweder das konkrete Ergebnis der Formel oder gibt Hinweise bzgl. Syntax-Fehlern oder fehlenden Werten. |
+ | ===== Formelsyntax ===== | ||
- | ===== Formula syntax ===== | + | Das Wertefeld jeder Variable kann verschiedene Arten von Werten und auch andere Variablen enthalten. Es unterstützt vielfältige mathematische Operationen sowie einige |
- | + | ||
- | The value field of each variable can hold different types of values and also other variables. It supports numerous mathematical operations as well as several | + | |
<WRAP center round info 100%> | <WRAP center round info 100%> | ||
- | Don't be afraid of the syntax. While it supports rather complex operations, it can also be used for simple and plain calculations as you are used to from any calculator. Some supported functions are probably for advanced users only. | + | Fürchte dich nicht vor der Syntax. Sie unterstützt zwar auch relativ komplexe Operationen, can aber auch für einfache Kalkulationen genutzt werden, wie du sie von jedem Taschenrechner kennst. Einige der Funktionen sind wahrscheinlich nur für fortgeschrittene Nutzer. |
</ | </ | ||
- | The syntax will be explained | + | Die Syntax wird in den folgenden Unterkapiteln im Detail beschrieben. Als erste Übersicht über die unterstützten Funktionen, findest du hier eine Liste von Beispielen: |
- | However as a quick overview about what is supported, you will find a list of examples here: | + | |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
+ | ==== Typen von Variablen ==== | ||
+ | Die Formelsyntax unterstützt drei Typen von Variablen. | ||
+ | Du kannst einfach drauf los schreiben, generell versucht die Formelberechnung die gegebenen Werte so gut wie möglich einzupassen. | ||
- | ==== Value types ==== | + | ^ Typ ^ Beschreibung ^ Anwendung ^ Bedeutung ^ |
+ | |Ganzzahlen (Integer) | Zahlen ohne Dezimalstellen | Nutze Zahlen | '' | ||
+ | |Dezimalzahlen (Decimal) | Zahlen mit Dezimalstellen | Nutze Zahlen mit Punkt oder Komma | '' | ||
+ | |Text (String) | Text | Umgebe Text mit '' | ||
- | The formula syntax supports three types of values. | ||
- | Typing is loose, in general formula evaluation will try to fit given values as best as possible. | ||
- | ^ Type ^ Description ^ Literal syntax ^ Examples ^ | + | ==== Numerische Operatoren ==== |
- | |Integer | Number without decimal places | Use digits | '' | + | |
- | |Decimal | Number with decimal places | Use digits with decimal point or comma | '' | + | |
- | |String | Text | Surround value with '' | + | |
+ | Die folgenden numerischen Operationen werden unterstützt: | ||
- | ==== Numeric operators ==== | + | ^ Operator ^ Funktion ^ Beispiel ^ |
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |''/'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
- | The following numeric operators are supported: | + | ==== Vergleichende Operatoren und Bedingungen ==== |
- | ^ Operator ^ Function ^ Example ^ | + | Vergleichende Operatoren wie '' |
- | |'' | + | |
- | |'' | + | |
- | |'' | + | |
- | |''/'' | + | |
- | |'' | + | |
- | |'' | + | |
- | |'' | + | |
- | ==== Relational operators and conditions ==== | + | Beispielsweise ergibt der Ausdruck '' |
- | Relational operators like '' | + | Vergleichende Operatoren werden insbesondere in der '' |
- | For example, the expression | + | Die '' |
- | Relational operators are especially used in the '' | + | Dies bedeutet, dass z.B. wenn die Funktion 5 Parameter hat: |
+ | * Wenn der erste Parameter wahr ist, wird der zweite zurückgegeben | ||
+ | * Andernfalls, wenn der dritte Parameter war ist, wird der vierte Parameter zurückgegeben. | ||
+ | * Andernfalls wird der fünfte Parameter zurückgegeben. | ||
- | The '' | + | Beispielsweise ergibt |
- | This means, that if the function was given 5 parameters then: | ||
- | * If the first parameter is true, then the second is returned | ||
- | * Else if the third parameter is true, then the fourth parameter is returned | ||
- | * Else the fifth parameter is returned | ||
- | For example | + | ^ Operator ^ Bedeutung ^ Beispiel ^ |
+ | |'' | ||
+ | | '' | ||
+ | |'' | ||
+ | | ''< | ||
+ | |''>'' | ||
+ | |'' | ||
- | ^ Operator ^ Meaning ^ Example ^ | + | ==== Funktionen |
- | |'' | + | |
- | | ''<>'' | + | |
- | |''<'' | + | |
- | | ''< | + | |
- | |''>'' | + | |
- | |''> | + | |
- | ==== Functions ==== | + | Funktionen starten alle mit einem Buchstaben, enthalten nur Buchstaben oder Ziffern und haben eine direkt daran angeschlossene Liste von Parametern, die in Klammern stehen. Mehrere Parameter werden dabei durch '';'' |
- | Functions all start with a letter, contain only letters and digits and have a directly attached parameter list in parenthesis. Multiple parameters are separated using '';'' | + | Ein Beispiel für einen Funktionsaufruf mit einem Parameter ist '' |
- | An example for a one-parameter function call is '' | + | Die folgenden Funktionen sind definiert: |
- | The following functions are defined: | + | ^ Funktion ^ Synonym ^ Beschreibung ^ Parameter 1 ^ Parameter 2 ^ Beispiel ^ |
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
- | ^ Function ^ Synonyms ^ Description ^ Parameter1 ^ Parameter 2 ^ Example ^ | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
- | |'' | ||
+ | ==== Variablen ==== | ||
- | ==== Variables ==== | + | Variablen werden in Formeln als Platzhalter für Werte verwendet. Wenn eine Formel berechnet wird, die eine Variable enthält, benötigt diese einen Wert für jede enthaltene Variable, damit sie korrekt berechnet wird. |
- | Variables are used in a formula as placeholders for values. When a formula containing a variable is evaluated, it needs to be passed a value for each of the contained variables in order to be correctly evaluated. | + | Namen von Variablen unterscheiden Groß-/ |
+ | Beispiel für gültige Variablennamen sind: '' | ||
- | Variable names are case sensitive and have to start with an alphanumeric char. Remaining chars can be alphanumeric or digits. | + | Variablen, die nur aus einem Buchstaben bestehen, können einfach in Formeln eingegeben werden und werden direkt ausgewertet. |
- | Examples for legal variable names are: '' | + | Zum Beispiel ist die Formel |
- | One-letter-variables can just be typed into the formula and will be evaluated along. For example, the formula | + | Wenn mehrere Buchstaben in einer Formel direkt hintereinander geschrieben werden, werden diese als Wiederholung dieser Ein-Buchstaben-Variable angesehen. Zum Beispiel wird die Formel |
- | If multiple chars are concatenated within a formula, they will be interpreted as individual one-letter-variables. For example, the formula | + | Namen von Variablen mit mehr als einem Buchstaben können im Unix-Bash-Stil verwendet werden, in dem ihnen ein '' |
+ | Beispielsweise kann eine Variable mit der Bezeichnung | ||
- | Variable names longer than one char can be declared | + | In Situationen, |
- | In situations where variable name conflicts with following alphas/ | + | Einige weitere komplexe Beispiele: |
- | + | ||
- | Some more complex examples: | + | |
- | * The formula | + | * Die Formel |
- | * The formula | + | * Die Formel |
- | * The formula | + | * Die Formel |
- | * The formula | + | * Die Formel |
- | * Using '' | + | * Nutzt man die '' |
- | ==== Concatenations | + | ==== Verkettungen |
- | If multiple expressions are concatenated directly after another with no separating operator, values are concatenated to a consecutive expression. This expression evaluates to a number if it forms a valid numeric expression, otherwise it evaluates to a text value. | + | Wenn mehrere Ausdrücke direkt hintereinander ohne trennenden Operator verkettet werden, werden deren Werte ebenso zu einem fortlaufenden Ausdruck verkettet. Dieser Ausdruck ergibt eine Zahl wenn es eine gültiger numerischer Ausdruck ist, sonst zu einem Textwert. |
- | Expressions, which can be concatenated, include e.g. integer digits, variables, expressions | + | Ausdrücke, die verketten werden können, sind z.B. Ganzzahlen, Variablen, Ausdrücke |
- | For example, the formula | + | Beispielsweise enthält die Formel |
- | ==== Overflow character | + | ==== Überlaufzeichen |
- | In concatenated expressions, the character | + | In verketteten Ausdrücken, kann das Zeichen |
- | An example should make the usage clear: | + | Ein Beispiel sollte die Nutzung klarer machen: |
- | * The Formula | + | * Die Formel |
- | * The Formula | + | * Die Formel |
- | * The Formula | + | * Die Formel |
- | * The Formula | + | * Die Formel |
- | * The Formula | + | * Die Formel |
- | ==== Range expressions | + | ==== Wertebereiche |
- | You can specify ranges | + | Du kannst |
**FIXME** Link to anchor on waypoint calc page as soon as its updated to cover waypoint generation with ranges. | **FIXME** Link to anchor on waypoint calc page as soon as its updated to cover waypoint generation with ranges. | ||
- | An example for a range expression is '' | + | Ein Beispiel für einen Wertebereich-Ausdruck ist '' |
+ | |||
+ | Du kannst mit dem Trennzeichen '','' | ||
+ | Die Bereiche werden von links-nach-rechts gelesen und ergeben daraus die Anordnung der Elemente im Bereich. Die folgenden Beispiele zeigen gültige Bereichsangaben: | ||
+ | |||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | Wenn ein Wertebereich in einem Kontext verwendet wird, in dem nur ein Einzelwert erlaubt ist (das ist bei normalen Berechnungen der Fall), wird der erste Wert im Bereich für die Berechnung genommen. Beispielsweise wird der Wertebereich '' | ||
+ | |||
+ | Wertebereiche unterstützen aktuell nur positive konstante Ganzzahlen. Ein Bereich muss immer mindestens einen Wert und nicht mehr als zwanzig Werte enthalten. | ||
+ | Beispielsweise sind die folgenden Wertebereiche ungültig: | ||
- | You may specify consecutive values using '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * '' | + | * '' |
+ | * '' | ||
- | When a range is used in a context where only one value is allowed (this is the case in normal calculation), | + | Eine Formel kann eine oder mehrere Wertebereiche gemischt mit normalen anderen Formelelementen enthalten. Zum Beispiel sind folgende Formeln gültig: |
- | Ranges currently support only positive constant integer values. A range must always be evaluate to at least 1 value and a range may not evaluate to more than 20 values. For example the following ranges are invalid: | + | |
- | | + | * '' |
- | * '' | + | * '' |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | A formula may include one or more range definitions mixed with normal other formula parts. For example the following formulas are valid: | ||
- | * '' | ||
- | * '' | ||
- | * '' | ||
+ | ==== Kommentare ==== | ||
- | ==== Comments ==== | + | Durch Nutzung von ''#'' |
+ | Alles, was im Kommentar steht, wird während der Berechnung ignoriert. | ||
+ | Beispiele: | ||
- | You may enter comments into formula expressions using the ''#'' | + | |
- | | + | * '' |
- | * '' | + |