AddNameValuePair<data type> (Metodo)
Questa sezione offre una descrizione generale dei seguenti metodi:
oAddNameValuePairINT
oAddNameValuePairDINT
oAddNameValuePairUDINT
oAddNameValuePairREAL
oAddNameValuePairSTRING
oAddNameValuePairBOOL
Il metodo AddNameValuePairINT è illustrato a titolo di esempio in questa figura:
Aggiunge una coppia nome/valore allaSTRING che è in corso di elaborazione con il valore del tipo dati indicato nel nome del metodo:
oINT = INTEGER
oDINT = DOUBLE INTEGER
oUDINT = UNSIGNED DOUBLE INTEGER
oREAL = valore a virgola mobile secondo il tipo di dati IEC REAL
oSTRING = STRING
oBOOL = BOOL
Il valore assegnato viene convertito, se necessario, in una ASCII STRING e sommato nel formato corretto alla STRING che è in corso di elaborazione.
Il valore restituito è TRUE se la funzione è stata eseguita correttamente. Valutare la proprietà Result, nel caso il valore restituito sia FALSE.
Le cause per la mancata esecuzione del metodo possono essere le seguenti:
|
Causa possibile |
Effetto |
|---|---|
|
È stata raggiunta la lunghezza massima di questa STRING. |
La STRING resta invariata. |
|
Ingresso |
Tipo di dati |
Descrizione |
|---|---|---|
|
i_sName |
STRING(GPL.Gc_uiJsonMaxLengthOfName) |
Specifica il nome della coppia nome/valore da aggiungere. Le virgolette che racchiudono <name> non devono essere specificate in maniera esplicita, ma vengono aggiunte implicitamente dal metodo. |
|
i_*Value |
* |
Specifica il valore da aggiungere. |
|
* Tipo di dati che corrisponde al metodo utilizzato. |
||
Richiamando il metodo AddNameValuePair<data type> si aggiunge il testo che nell'esempio è contrassegnato in rosso magenta e grassetto a STRING:
{"Key":1,"<name>":<value>}
<name> corrisponde al valore specificato con l'ingresso i_sName del metodo.
<value> corrisponde al valore specificato con l'ingresso i_*Value del metodo.
