Utilisation de la fonction prop

Langue :

Dans la plupart des cas, les fonctions get et prop renvoient la même valeur. Contrairement à la fonction get, la fonction prop renvoie toujours une valeur scriptable. Une valeur scriptable a la même forme stable pour chaque type de propriété.

Renvoyez la valeur scriptable d'une propriété dans le contexte du noeud actuel.
Pour la plupart des propriétés, les fonctions get et prop renvoient des valeurs identiques, comme illustré dans l'exemple suivant pour la propriété version :
```
> ls
version = 2019.02.28,1-0
> script get('version')
'2019.02.28,1-0'
> script prop('version')
'2019.02.28,1-0'
```
Dans l'exemple suivant relatif à la propriété date, notez la différence entre la valeur renvoyée par la fonction get et la valeur scriptable renvoyée par la fonction prop :
```
> ls
date = 2019-2-28 10:43:11
> script get('date')
Tue Feb 28 2019 10:43:11 GMT+0000 (UTC) (Date object)
> script prop('date')
'2019-02-28T10:43:11Z'
```
Définissez la valeur d'une propriété dans le contexte du noeud actuel sur une valeur scriptable.
Incluez une valeur dans l'appel de fonction prop pour définir la valeur de la propriété nommée. Un message d'erreur s'affiche si la valeur donnée n'est pas au format scriptable spécifié pour cette propriété. Sinon, le format défini de la fonction prop ne renvoie pas de valeur.
```
> ls
date = 2019-2-28 10:43:11
> script prop('date', '2019-03-09T12:34:56Z')
> ls
date = 2019-3-09 12:34:56
> script prop('date')
'2019-03-09T12:34:56Z'
```
Définissez la valeur d'une propriété booléenne.
Etant donné que la fonction prop peut être utilisée pour renvoyer une valeur de propriété ou pour définir une valeur de propriété, contrairement à la fonction set, la fonction prop ne permet pas de définir une propriété booléenne sur true sans spécifier la valeur.

L'exemple suivant montre comment utiliser la version abrégée de la fonction set pour définir une propriété booléenne sur la valeur true :
```
set('booleanproperty')
```
La forme abrégée de la fonction prop renvoie la valeur de la propriété booléenne, c'est-à-dire true ou false :
```
script prop('booleanproperty')
'false'
```
Pour utiliser la fonction prop pour définir la valeur d'une propriété booléenne, vous devez fournir la valeur :
```
script prop('booleanproperty', true)
script prop('booleanproperty')
'true'
```

Définissez la valeur d'une propriété list.

Pour définir une valeur scriptable pour une propriété avec le modificateur list, vous devez spécifier un tableau de valeurs :

> ls
stringlist = a,string,list
> script prop('stringlist', ['a', 'b', 'c', 'd'])
> script prop('stringlist')
['a', 'b', 'c', 'd']
> ls
stringlist = a,b,c,d

Pour spécifier une valeur unique pour une propriété list, spécifiez la valeur unique en tant que tableau de taille une :

> ls
stringlist = a,string,list
> script prop('stringlist', ['a'])
> script prop('stringlist')
['a']
> ls
stringlist = a

Pour spécifier la valeur vide d'une propriété avec le modificateur empty ou list, spécifiez un tableau vide :

> ls
emptystringlist = a,string,list
> script prop('emptystringlist', [])
> script prop('emptystringlist')
[]
> ls
emptystringlist =