|
<< Fare clic per visualizzazione il sommario >> Percorso: Il linguaggio OEL > Funzioni > PadLeft |
Restituisce una stringa della larghezza totale specificata, aggiungendo il numero necessario di caratteri di riempimento all'inizio della stringa specificata.
Funzione
string PadLeft(string s, int totalWidth, string paddingChar)
La funzione può essere utilizzata nelle seguenti modalità:
1) PadLeft(string s, int totalWidth)
2) PadLeft(string s, int totalWidth, string paddingChar)
Output |
||
Nome |
Descrizione |
Tipo |
returnValue |
Stringa iniziale rielaborata. |
String |
Modalità 1)
string PadLeft(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 # anteposto 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 prima del testo.
Modalità 2)
string PadLeft(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 all'inizio della stringa specificata 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 testo in 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 # anteposto 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".