funzioneScopo
Consente di formattare una stringa parametrica in funzione degli argomenti passati.
Sintassi
string risultato = "" // Leggo il risultato della funzione
//
Risultato := FormatMessage(stringa, par1, par2, par3, par4, par5)
//
Risultato := FormatMessage(stringa, par1, par2, par3, par4, par5)
Argomenti
| stringa | Obbligatorio. È l'espressione di tipo stringa da formattare. Deve essere una qualunque espressione il cui risultato sia una stringa. Può contenere fino a un massimo di 5 tag (|1..|5) che saranno sostituiti dai valori dei corrispondenti parametri passati come argomenti. |
| Par1 | Opzionale. Contiene una espressione qualsiasi (il cui risultato non sia né un object né un generic document) il cui valore sarà utilizzato per sostituire il tag corrispondente. |
| Par2 | Opzionale. Contiene una espressione qualsiasi (il cui risultato non sia né un object né un generic document) il cui valore sarà utilizzato per sostituire il tag corrispondente. |
| Par3 | Opzionale. Contiene una espressione qualsiasi (il cui risultato non sia né un object né un generic document) il cui valore sarà utilizzato per sostituire il tag corrispondente. |
| Par4 | Opzionale. Contiene una espressione qualsiasi (il cui risultato non sia né un object né un generic document) il cui valore sarà utilizzato per sostituire il tag corrispondente. |
| Par5 | Opzionale. Contiene una espressione qualsiasi (il cui risultato non sia né un object né un generic document) il cui valore sarà utilizzato per sostituire il tag corrispondente. |
Valore di ritorno
Viene ritornata la stringa risultante dalla sostituzione di ogni tag eventualmente presente con il valore del corrispondente parametro passato come argomento.
Esempio di codice
// ***********************************************************
// Ritorna una stringa formattata in base ai parametri passati
// ***********************************************************
public void Functionstring.FormatMessage()
{
Applicazione.FunzioniString.String1 := messaggio
Applicazione.FunzioniString.String2 := format message
Applicazione.FunzioniString.String3 := stringhe
Applicazione.FunzioniString.Risultato := FormatMessage(Applicazione.
FunzioniString.String1, Applicazione.FunzioniString.String2, Applicazione.
FunzioniString.String3, ??, ??, ??)
}
// Ritorna una stringa formattata in base ai parametri passati
// ***********************************************************
public void Functionstring.FormatMessage()
{
Applicazione.FunzioniString.String1 := messaggio
Applicazione.FunzioniString.String2 := format message
Applicazione.FunzioniString.String3 := stringhe
Applicazione.FunzioniString.Risultato := FormatMessage(Applicazione.
FunzioniString.String1, Applicazione.FunzioniString.String2, Applicazione.
FunzioniString.String3, ??, ??, ??)
}
- Se Stringa è Null la funzione ritorna Stringa Vuota.
- Se un parametro è Null o mancante viene considerato come Stringa Vuota.
- Se il risultato di una delle espressioni passate come parametro non è di tipo stringa allora viene automaticamente convertito in stringa.
- NOTA Se un parametro contiene al suo interno |n (con n = 1..5) si possono avere comportamenti indesiderati.
Ultima modifica: 20/11/2020 / Validità: da 7.0.3200