|
<< Fare clic per visualizzazione il sommario >> Percorso: Il linguaggio OEL > Funzioni > PadRight |
Restituisce una stringa della larghezza totale specificata, aggiungendo il numero necessario di caratteri di riempimento alla fine della stringa specificata.
Funzione
string PadRight(string s, int totalWidth, string paddingChar)
La funzione può essere utilizzata nelle seguenti modalità:
1) PadRight(string s, int totalWidth)
2) PadRight(string s, int totalWidth, string paddingChar)
Output |
||
Nome |
Descrizione |
Tipo |
returnValue |
Stringa iniziale rielaborata. |
String |
Modalità 1)
string PadRight(string s, int totalWidth)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
s |
Stringa da convertire. |
String |
|
totalWidth |
Lunghezza totale che la stringa deve raggiungere. |
Integer |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Stringa iniziale rielaborata. |
String |
|
Commenti
Il metodo restituisce:
Restituisce |
Condizione |
Il testo assegnato al parametro s |
Se il numero assegnato al parametro totalWidth è minore o uguale alla lunghezza della testo in input. |
Esempio
In una risorsa di tipo Dati, in cui è definito un campo denominato CodiceSeriale di tipo Testo breve e un campo denominato Dimensione di tipo Numerico Intero, si vuole ottenere un testo della lunghezza specificata nel campo Dimensione, composto dal carattere speciale # postposto al codice seriale.
PadLeft(#data.Fields['CodiceSeriale'],#data.Fields['Dimensione'])) |
Se il parametro CodiceSeriale assume il valore "AB52FGT" e il parametro Dimensione assume il valore "9" la funzione restituisce "AB52FGT ", con due spazi vuoti aggiunti in coda al testo.
Modalità 2)
string PadRight(string s, int totalWidth, string paddingChar)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
s |
Stringa da convertire. |
String |
|
totalWidth |
Lunghezza totale che la stringa deve raggiungere. |
Integer |
|
paddingChar |
Carattere di riempimento. |
String |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Stringa iniziale rielaborata. |
String |
|
Commenti
Non specificando il carattere di riempimento, il metodo aggiunge il numero necessario di spazi alla fine della stringa di input per raggiungere la lunghezza specificata.
Il metodo restituisce:
Restituisce |
Condizione |
Il testo assegnato al parametro s |
Se il numero assegnato al parametro totalWidth è minore o uguale alla lunghezza della stringa di input. |
Errore |
Se al parametro paddingChar vengono assegnati più di un carattere |
Esempio
In una risorsa di tipo Dati, in cui è definito un campo denominato CodiceSeriale di tipo Testo breve e un campo denominato Dimensione di tipo Numerico Intero, si vuole ottenere un testo della lunghezza specificata nel campo Dimensione, composto dal carattere speciale # postposto al codice seriale.
PadLeft(#data.Fields['CodiceSeriale'],#data.Fields['Dimensione'],'#')) |
Se il parametro CodiceSeriale assume il valore "AB52FGT" e il parametro Dimensione assume il valore "9" la funzione restituisce "AB52FGT##".