BLOBTOSTRING
Consente di scomporre una variabile di tipo BLOB su più stringhe aventi ciascuna dimensione massima pari quella indicata nel parametro DIM o alla dimensione del campo specificato nel parametro CAMPO.
Tali stringhe vengono inserite o all'interno di un vettore (parametro VET) o all'interno di una struttura (parametro STRUTTURA). Il numero di righe ottenute viene riportato nella variabile indicata in NUMRIGHE[]. Nel caso in cui il numero di elementi del vettore sia insufficiente a contenere tutte le stringhe generate, viene riportato un errore nella variabile indicata nel parametro ERRORE[].
- La specifica, prima di eseguire lo scompattamento, svuota il vettore o la struttura che dovrà contenere le righe di stampa.
- Nel caso in cui si trovi nel testo una riga vuota, questa sarà riportata nel vettore o nella struttura come un elemento 'vuoto'.
- Le variabili della STRUTTURA devono essere dimensionate all'interno del sorgente.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| VARBLOB | Blob | ||||
| VET | Vettore di Stringa | ||||
| DIM | Intero | ||||
| STRUTTURA | Stringa | ||||
| CAMPO | Stringa | ||||
| SEPARATORE | Stringa | ||||
| NUMRIGHE | Intero | ||||
| ERRORE | Intero |
VARBLOB
Blob o stringa contenente il testo da analizzare e da segmentare in stringhe.
VET
È un vettore di tipo alfanumerico, nel quale la specifica inserisce le diverse righe.
DIM
Indica la dimensione massima delle stringhe con cui verrà segmentato il contenuto del parametro VarBlob.
Il parametro è obbligatorio in presenza del parametro VET[] o nella traduzione .NET.
STRUTTURA
Nome della struttura nella quale inserire le diverse stringhe estratte.
Deve essere un valore costante.
CAMPO
Campo della struttura nel quale inserire il valore delle diverse stringhe estratte. Può contenere una variabile blob o una stringa.
- Il parametro è obbligatorio solo in presenza del parametro STRUTTURA[].
- I campi VET[] e STRUTTURA[] sono alternativi tra di loro.
NUMRIGHE
Variabile che conterrà il numero di righe ottenute dallo scompattamento di VarBlob.
ERRORE
È una variabile che conterrà un eventuale errore.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Nessun errore |
1 | Il numero di righe del vettore indicato in VET[] è insufficiente |
2 | Nome struttura non indicato |
3 | Campo delle struttura non indicato |
4 | Errore in inserimento dei valori nella struttura |
Errori
| Codice | Descrizione |
|---|---|
| 1 | Il numero di righe del vettore indicato in VET[] è insufficiente |
Esempi
Conversione di un blob in string
DIM RIGHE$[40](20)
NRIGHE%[3]=0
ERR[1] = 0
TESTO?="Gli autotrasportatori per conto terzi iscritti nel relativo albo, indipendentemente dalla loro natura giuridica e dal volume d'affari,possono ai fini IVA annotare le fatture emesse per le prestazioni di servizi"
'@BLOBTOSTRING VARBLOB[TESTO?] _ ' Nome della variabile Blob
DIM[40] _ ' Larghezza delle singole stringhe
VET[RIGHE$()] _ ' Nome del vettore di stringhe
NUMRIGHE[NRIGHE%] _ ' Numero di stringhe ottenute
ERRORE[ERR] ' 0-Ok;1-Errore, numero righe insufficiente
'Output
' NUMRIGHE = 6
' RIGHE$(1)="Gli autotrasportatori per conto terzi"
' RIGHE$(2)="iscritti nel relativo albo,"
' RIGHE$(3)="indipendentemente dalla loro natura"
' RIGHE$(4)="giuridica e dal volume d'affari, possono"
' RIGHE$(5)="ai fini IVA annotare le fatture emesse"
' RIGHE$(6)="per le prestazioni di servizi"