Passa al contenuto principale

BLOBTOSTRING

DesktopWeb
warning
La specifica è deprecata nei sorgenti con STRICT maggiore o uguale a 3

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[].

note
  • 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

ParametroDefinizioneI/OInformazioniVersione traduttoreSMP
VARBLOBBlobINObbligatorioDesktopWeb
VETVettore di StringaRefDesktopWeb
DIMInteroINDesktopWeb
STRUTTURAStringaINDesktopWeb
CAMPOStringaINDesktopWeb
SEPARATOREStringaINDesktopWeb
NUMRIGHEInteroOUTObbligatorioDesktopWeb
ERROREInteroOUTDesktopWeb

VARBLOB

BlobINInputObbligatorioObbligatorioValore non necessarioValore non necessarioDesktopWeb

Blob o stringa contenente il testo da analizzare e da segmentare in stringhe.

VET

Vettore di StringaRefReferenzaValore non necessarioValore non necessarioDesktopWeb

È un vettore di tipo alfanumerico, nel quale la specifica inserisce le diverse righe.

DIM

InteroINInputValore non necessarioValore non necessarioDesktopWeb

Indica la dimensione massima delle stringhe con cui verrà segmentato il contenuto del parametro VarBlob.

note

Il parametro è obbligatorio in presenza del parametro VET[] o nella traduzione .NET.

STRUTTURA

StringaINInputValore non necessarioValore non necessarioDesktopWeb

Nome della struttura nella quale inserire le diverse stringhe estratte.

warning

Deve essere un valore costante.

CAMPO

StringaINInputValore non necessarioValore non necessarioDesktopWeb

Campo della struttura nel quale inserire il valore delle diverse stringhe estratte. Può contenere una variabile blob o una stringa.

note
  • Il parametro è obbligatorio solo in presenza del parametro STRUTTURA[].
  • I campi VET[] e STRUTTURA[] sono alternativi tra di loro.

SEPARATORE

StringaINInputValore non necessarioValore non necessarioDesktopWeb

Carattere separatore.

NUMRIGHE

InteroOUTOutputObbligatorioObbligatorioValore non necessarioValore non necessarioDesktopWeb

Variabile che conterrà il numero di righe ottenute dallo scompattamento di VarBlob.

ERRORE

InteroOUTOutputValore non necessarioValore non necessarioDesktopWeb

È una variabile che conterrà un eventuale errore.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
0Nessun errore
1Il numero di righe del vettore indicato in VET[] è insufficiente
2Nome struttura non indicato
3Campo delle struttura non indicato
4Errore in inserimento dei valori nella struttura

Errori

CodiceDescrizione
1Il 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"