AS
AS in ProBuilder labels a returned value or screener column with a custom name. Covers RETURN AS and SCREENER output naming with worked examples.
Syntaxe
RETURN expression AS "Custom Name"Comment ça marche
AS attache une étiquette texte à une valeur en sortie. Dans un indicateur, elle nomme la ligne dessinée sur le graphique, ce qui rend plus lisible un script qui renvoie plusieurs séries. Dans un ProScreener, elle nomme une colonne du tableau de résultats. Le nom doit être une chaîne entre guillemets doubles.
AS ne modifie pas la valeur qu'il étiquette et n'intervient pas dans la logique. Il contrôle simplement la présentation du résultat. Il apparaît à côté de la valeur renvoyée, que ce soit dans un RETURN instruction ou dans la liste de valeurs d'un SCREENER.
Exemples
Exemple 1, Nommer une ligne tracée (Indicateur)
// Plot a 14-period average and label it on the chart
MAVariable = Average[14](close)
RETURN MAVariable AS "My Moving Average"C'est le modèle de la référence officielle. La moyenne est tracée sur le graphique sous l'étiquette "My Moving Average" plutôt qu'en ligne anonyme.
Exemple 2, Nommer plusieurs séries renvoyées (Indicateur)
// Return two averages, each with its own label
fast = Average[20](close)
slow = Average[50](close)
RETURN fast AS "Fast MA", slow AS "Slow MA"Chaque valeur renvoyée porte sa propre étiquette, les deux lignes sont donc faciles à distinguer sur un graphique qui trace les deux.
Exemple 3, Nommer une colonne de screener (ProScreener)
// Uptrend filter, showing the distance above the average as a named column
avg = Average[200](close)
cond = close > avg
gap = close - avg
SCREENER[cond](gap AS "Above 200MA")Le screener renvoie les instruments correspondants avec une colonne intitulée « Above 200MA » contenant la valeur de gap, ce qui est plus clair qu'un chiffre sans libellé.
Erreurs et pièges courants
- Pas un opérateur logique. Bien qu'elle figure dans la catégorie Opérateurs,
ASn'effectue aucune comparaison et ne renvoie aucun booléen. Il ne fait que nommer une sortie. Pour la logique, utilisezAND,OR,NOT, ouXOR. - Les guillemets sont obligatoires. L'étiquette après
ASdoit être une chaîne entre guillemets doubles, commeAS "Signal". Omettre les guillemets provoque une erreur de syntaxe. - Étiquette la valeur, pas la variable.
ASrenomme la sortie pour l'affichage. Cela ne crée ni ne renomme une variable réutilisable plus loin dans le code. - Placement.
ASva avec la valeur renvoyée ou listée, directement après l'expression qu'elle désigne, et non sur sa propre ligne.
Instructions liées
RETURN, renvoie une ou plusieurs valeurs d'un indicateur, oùASles étiquette.SCREENER, définit un screener dont les colonnes de sortieASpeut nommer.GRAPH, trace une valeur supplémentaire qui peut elle aussi porter une étiquette.IF,AND,OR, la logique qui décide de ce qui est renvoyé, distincte de son étiquetage.