VOID %ENDSKIP%
Scopo terminare un commento.

Sintassi %ENDSKIP%

Descrizione consente di terminare un commento, oppure di terminare una parte di codice che non deve essere eseguita.
A differenza dei commenti tipici dell'html (<!-- commento -->), l'uso di %SKIP% e %ENDSKIP% consente di alleggerire la pagina html che il modulo Highway Application Server manda in output, perchè la parte racchiusa fra queste istruzioni viene scartata totalmente.

Valore restituito nessuno.

Vedere anche %SKIP%

Esempio
%SKIP% informazioni riservate allo sviluppatore %ENDSKIP%

NUMBER %EVAL%
Scopo valutare e calcolare un'espressione numerica.

Sintassi %EVAL%(%NUMBER% espressione_da_valutare)

Descrizione consente di valutare espressioni numeriche anche annidate fra all'interno di parentesi.
espressione_da_valutare deve essere rappresentato da valori numerici.
Se in espressione_da_valutare sono presenti variabili di tipo stringa dovranno essere opportunamente convertite mediante %ITOA% o %FTOA%.

Valore restituito valore numerico
Torna il risultato del calcolo eseguito.
In caso di errore, l'espressione non viene compilata dal modulo Highway Application Server.

Vedere anche %PARSE%

Esempio
%WRITE%(%ITOA%(%EVAL%((124*56/2)+1)))

Program output
3473

VOID %EXIT%
Scopo terminare il processo corrente.

Sintassi %EXIT%

Descrizione consente di terminare il processo corrente.
Per processo corrente si intende la terminazione del modulo Highway Application Server.

Valore restituito nessuno.

Vedere anche %RETURN%

STRING %EXTRAQ%
Scopo recupera informazioni sulle eventuali restrizioni ai documenti del utente corrente.

Sintassi %EXTRAQ%

Descrizione consente di recuperare le restrizioni dell'utente corrente sulla base dati.
Queste informazioni sono memorizzate in un archivio Highway (HiCnt32.sts) e vengono automaticamente utilizzate da Highway Server al momento della compilazione della frase di ricerca.

Valore restituito valore alfanumerico
Torna una frase di ricerca che indica le eventuali restrizioni d'accesso oppure una stringa vuota se non vi sono restrizioini.
In caso di errore generico l'istruzione non viene compilata.

Vedere anche %WEBHOME%, %WEBUSER%

STRING %FATTRIB%
Scopo visualizzare un attributo multifont mantenendo le caratteristiche di formattazione esistenti.

Sintassi %FATTRIB%(%STRING% nomeattributo)

Descrizione Consente di recuperare il contenuto dell'attributo specificato, di tipo multifont, mantenendo le caratteristiche di formattazione originali (grassetto, italico, giustificazione,...).
Attenzione all'uso di funzioni che necessitano o leggono la dimensione degli attributi multifont: infatti, in coda al buffer dell'attributo sono memorizzate le informazioni della formattazione che falsano le dimensioni del valore contenuto.

Valore restituito valore alfanumerico
Torna la stringa valorizzata con il contenuto alfanumerico dell'attributo indicato.
in caso di errore generico l'istruzione non viene compilata.
Utilizzato con un attributo NON multifont assume il comportamento di %ATTRIB%.

Vedere anche %ATTRIB%

Esempio
<!-- esempio del contenuto dell'attributo
Documento
Titolo -->
%FATTRIB%(<nomeattr>)

Program output
Documento
Titolo

NUMBER %FILESIZE%
Scopo Restituisce la dimensione del file specificato.

Sintassi %FILESIZE%(%STRING% nomefile)

Descrizione utilizzato per ottenere la dimensione in byte di un file specifico.
nomefile va specificato con percorso completo ed estensione, e, se nomefile viene digitato in chiaro nello script, le barre separatrici dei direttori nel percorso completo devono essere tradotte in caratteri di escape.
p.e. "c:\winnt\explorer.exe" diventa "c:\\winnt\\explorer.exe".
Se nomefile non viene risolto, Highway Application Server esegue un tentativo di risoluzione cercando all'interno del file di profilo. Se anche questo non risolve nomefile, Highway Application Server verifica il primo carattere: se è "/" (oppure "\" in NT) e non è indicata la lettera di drive allora viene eseguito un ulteriore tentativo di risoluzione rispetto al direttorio dello script corrente.

Valore restituito valore numerico
Torna la dimensione del file specificato.
Torna 0 in caso di errore generico.

Vedere anche %FILEDATE%, %OPENFILE%, %CLOSEFILE%, %CREATEFILE%, %READFILE%, %WRITEFILE%, %RENFILE%

Esempio
<!-- esempio di visualizzazione di un collegamento
   che mostra la dimensione del file linkato -->
...
Visualizza immagine (<A href="/<aliasIIS>/<nomefile.ext>">%ITOA%(%FILESIZE%("/<aliasIIS>/<nomefile.ext>")) bytes</A>)

Program output
Visualizza immagine (123554 bytes)

STRING %FILEDATE%
Scopo recupera data e ora relativa all'ultima modifica del file specificato.

Sintassi %FILEDATE%(%STRING% nomefile)

Descrizione consente di recuperare la la data e l'ora dell'ultima operazione di salvataggio eseguita sul file specificato da nomefile.
nomefile va specificato con percorso completo ed estensione, e, se nomefile viene digitato in chiaro nello script, le barre separatrici dei direttori nel percorso completo devono essere tradotte in caratteri di escape.
p.e. "c:\winnt\explorer.exe" diventa "c:\\winnt\\explorer.exe".

Valore restituito valore numerico
Torna la dimensione del file specificato.
In caso di errore generico l'istruzione non viene compilata.

Vedere anche %FILESIZE%, %OPENFILE%, %CLOSEFILE%, %CREATEFILE%, %READFILE%, %WRITEFILE%, %RENFILE%

Esempio
%FILEDATE%("<nomefile.ext>")

Program output
27/09/1999 08:47:08

NUMBER %FILLATTR%
Scopo Assegnare ad un attributo specificato un determinato valore.

Sintassi %FILLATTR%(%STRING% nomeattributo, %STRING% valore)

Descrizione viene usato, per assegnare un valore ad un attributo facente parte del documento corrente.
Utlizzato in fase di modifica o inserimento di un documento.

Valore restituito valore numerico
Torna 1 in caso di operazione eseguita correttamente.
Torna 0 in caso di errore generico.

Vedere anche %NEWDOC%, %SAVEDOC%, %FILLBINATTR%

Esempio
%IF%(%NEWDOC%(%TABNAME%(1), 1))
 %FILATTR%("CAMPO1", "<valore>")
 %FILATTR%("CAMPO2", "<valore>")
 %FILATTR%("CAMPO3", "<valore>")
 %SAVEDOC%
%ENDIF%

NUMBER %FILLBINATTR%
Scopo Assegnare ad un attributo specificato un determinato valore in formato binario.

Sintassi %FILLBINATTR%(%STRING% nomeattributo, %STRING% valore_binario)

Descrizione viene usato, per assegnare un valore in formato binario ad un attributo facente parte del documento corrente.
Utlizzato in fase di modifica o inserimento di un documento.

Valore restituito valore numerico
Torna 1 in caso di operazione eseguita correttamente.
Torna 0 in caso di errore generico.

Vedere anche %NEWDOC%, %SAVEDOC%, %FILLATTR%

Esempio
%IF%(%NEWDOC%(%TABNAME%(1), 1))
 %FILATTR%("CAMPO1", "<valore>")
 %FILABINTTR%("CAMPO2", %HEX2BIN%("<valore>"))
 ...
 %SAVEDOC%
%ENDIF%

DECLARATION %FLOAT%
Scopo dichiaraRE e inizializzaRE una variabile di tipo numerico a virgola mobile.

Sintassi %FLOAT%(%STRING% nomevar, %STRING% value)

Descrizione dichiara una variabile di tipo numerico a virgola mobile e la inizializza con value.
value deve contenere un valore convertibile in numerico.
Una variabile può essere dichiarata ovunque ma non come argomento di una funzione (predefinita o non).
La visibilità di una variabile cessa all'uscita del contesto nel quale è stata dichiarata, sia esso il corpo di una funzione o la regione delimitata da una istruzione di controllo del flusso, ad eccezione di %IFSYM% ed %IFNSYM%.

Valore restituito nessuno

Vedere anche %STRING%, %NUMBER%

Esempio
%STRING%(cambio, "")
<!-- chg_lit_to_euro è un alias dichiarato nella sezione generico del file hicgi.ini che corrisponde al valore del cambio fra Lira ed Euro -->
%IF%(%PROFILE% (cambio, "chg_lit_to_euro", "Generico"))
 %FLOAT%(val_cambio, cambio)
%ENDIF%

VOID %FLOATCPY%
Scopo copiare il contenuto di una variabile numerica a virgola mobile in un'altra variabile dello stesso tipo.

Sintassi %FLOATCPY%(%FLOAT% *dest, %FLOAT% valore)

Descrizione copiare il contenuto di una variabile numerica a virgola mobile in un'altra variabile dello stesso tipo.

Valore restituito nessuno

Vedere anche %FTOA%, %FTOI%, %NUMCPY%, %STRCPY%

Esempio
%FLOAT%(fl1, 12.5)
%FLOAT%(fl2, 10.5)
%write%(%FTOA%(%FLOATCPY%(fl1, fl2)))

Program output
23

Esempio
%FLOAT%(fl1, 3.75)
%write%(%FTOA%(%FLOATCPY%(fl1, 0.26)))

Program output
4.01

STRING %FTOA%
Scopo convertire valori numerici a virgola mobile in formato stringa.

Sintassi %FTOA%(%FLOAT% nomevar [, %STRING% formato)

Descrizione esegue una conversione in formato stringa del contenuto della variabile numerica a virgola mobile nomevar.
Il parametro opzionale formato indica a %FTOA% come deve essere visualizzato il risultato della conversione.
I valori che possono essere utilizzati sono :

%[opzioni] [lunghezza] [.precisione] tipo
tipo	f	intero a virgola mobile con forma [-]dddd.dddd dove dddd rappresenta uno o più valori numerici
	e	intero a virgola mobile con forma [sign]dd.dddd dove dd rappresenta due valori numerici e dddd rappresenta uno o più valori numerici; sign è '+' o '-'
opzioni	-	allinea a sinistra il risultato all'interno di 'lunghezza' (diversamente allinea a destra)
	+	mette sempre il segno (+/-) (diversamente mette il segno solo se negativo)
	blank	mette uno spazio prima del valore
	#	forza a mettere sempre il punto decinmale
lunghezza	<valore>	numero minimo di caratteri di che compongono la conversione
.precisione	.<valore>	numero minimo di caratteri decimali di che compongono la conversione

Valore restituito valore alfanumerico
Torna una stringa contenente la conversione effettuata.
In caso di errore generico l'istruzione non viene compilata.

Vedere anche %ITOA%, %ATOI%, %FTOI%

Esempio
%WRITE%(%FTOA%(123.225456, "%+10.2f"))

Program output
   +123.23 con 3 spazi iniziali

NUMBER %FTOI%
Scopo convertire valori numerici a virgola mobile in valori numerici interi.

Sintassi %FTOI%(%FLOAT% nomevar)

Descrizione consente di convertire il valore numerico a virgola mobile di nomevar in un valore intero, senza arrotondamento, troncando la parte decimale.

Valore restituito valore numerico
Torna un valore intero troncando la parte decimale.
In caso di errore generico l'istruzione non viene compilata.

Vedere anche %ITOA%, %ATOI%, %FTOA%

Esempio
WRITE%(%ITOA%(%FTOI(123.925456)))

Program output
123

NUMBER %FREQ%
Scopo ottenere il numero delle occorrenze di un determinato termine all'interno dell'indice corrente.

Sintassi %FREQ%(%NUMBER% riga)

Descrizione permette di verificare, successivamente ad una chiamata al vocabolario verticale di un determinato attributo, il numero delle occorrenze del termine identificato con riga sull'intera base dati limitatatamente all'attributo corrente.
Viene utilizzato in combinazione con %VITEM% all'interno di un ciclo per visualizzare l'indice verticale di un attributo.

Valore restituito valore numerico
Torna il numero delle occorrenze memorizzate all'interno del vocabolario verticale per l'attributo corrente.
In caso di errore generico l'istruzione non viene compilata.

Vedere anche %VITEM%, %VITEMS%, %MAXVITEMS%

Esempio
<table border=1 width=96%>
%REPEAT% (1,%VITEMS%)
<TR><TD>
%IF% (gt(%FREQ%(%INDEX%),1))
<A HREF="%SCRIPT%(/a%CURARC%/t?%CURATTR%=%22%VITEM%(%INDEX%)%22)">
[%FREQ%(%INDEX%)]
</A>
%ELSE%
[%FREQ%(%INDEX%)]
%ENDIF%
</TD>
<TD>
<A HREF="%SCRIPT%(/a%CURARC%?%CURATTR%=%22%VITEM%(%INDEX%)%22)">
%VITEM%(%INDEX%)
</A>
</TD></TR>
%ENDREPEAT%
</TABLE>

Program output

[241]	AFFRESCO
[101]	ALABASTRO
[91]	AVORIO INTAGLIATO
[...]	...

DECLARATION %FUNC%
Scopo dichiarazione di una propria funzione in Highway Language.

Sintassi %FUNC% %NUMBER% [*] | 
                                  %STRING% [*] | 
                                   %FLOAT% [*] | 
                                    %VOID% <nomefunzione> (
                                                               [%NUMBER%[*]|
                                                                %FLOAT%[*]|
                                                                %STRING%[*] parm_1[,
                                                                ...,
                                                                %NUMBER%[*]|
                                                                %FLOAT%[*]|
                                                                %STRING%[*] parm_N]])

Descrizione consente di dichiarare una funzione propria con i comandi CGI, ed inserirla all'interno di uno o più script.
La regione di visibilità di una funzione è sempre globale, anche se può essere definita all'interno di un blocco.
La sintassi dei comandi mostra le modalità di dichiarazione:
%FUNC% constrassegna l'inizio della funzione.
Di seguito va indicato il tipo di dato che la funzione ritorna al chiamante.
La perte successiva è il nome vero e proprio della funzione, quello con il quale verrà richiamata all'interno dello script CGI.
All'interno delle parentesi tonde che terminano la parte dichiarativa della funzione, va indicata la lista dei parametri (tipo e nome)
Il nome della funzione, nel contesto di utilizzo dei caratteri % quali terminatori delle parole chiave per il CGI (default), se NON viene dichiarato racchiuso fra questi terminatori, al momento della chiamata dovrà essere delimitato da caratteri % perchè il modulo Highway Application Server lo riconosca come parola riservata.
Il corpo della funzione si chiude con %ENDFUNC%.

Valore restituito dipendente dalla dichiarazione.
In caso di errore generico non viene compilata.

Vedere anche %ENDFUNC%,

Esempio
%FUNC% %NUMBER% fattoriale (%NUMBER% n)
 %IF%(n<3)
  %RETURN%(n)
 %ENDIF%
 %RETURN%(n*fattoriale(n-1))
%ENDFUNC%

%WRITE%(fattoriale(2))<br>
%WRITE%(fattoriale(3))<br>

Program output
2
6

NUMBER %FWDMAIL%
Scopo replicare una mail ad un nuovo destinatario.

Sintassi %FWDMAIL%(
    %STRING% server,         <!-- nome del server smtp -->
    %STRING% toaddr,         <!-- e-mail destinatario -->
    %STRING% fromname,       <!-- mittente -->
    %STRING% fromaddr,       <!-- e-mail mittente -->
    %STRING% replyaddr,      <!-- e-mail per replica messaggio -->
    %STRING% organization,   <!-- organizzazione per replica messaggio -->
    %STRING% subject,        <!-- oggetto -->
    %STRING% text,           <!-- testo -->
    %STRING% message,        <!-- messaggio originale con header -->
    %NUMBER% timeout)        <!-- timeout(sec.) spedizione -->

Descrizione tramite questa funzione è possibile re-indirizzare una mail esistente verso un nuovo indirizzo.

Valore restituito valore numerico
Torna 1 in caso di esito positivo.
Torna 0 in caso di errore generico.

Vedere anche %GETMAIL%, %SENDMAIL%

Esempio
%STRING%(fromname,"")
%STRING%(fromaddr,"")
%STRING%(subject,"")
%STRING%(date,"")
%STRING%(message,"")
%STRING%(text,"")
%NUMBER%(total,)
%IF%(%GETMAIL%("<pop3.domain.it>", "<user>", "<psw>,
    fromname, fromaddr, subject, date, message, text,
    total, 1, 4096, 0, 360))
 %IF%(%FWDMAIL%("<pop3.domaindest.it>", "<indirdest>",
     "<nomemittente>", "<indirmittente>"
     "<nuovoindir>", "", subject,
     "Ti invio per conoscenza la seguente mail:",
     message, 360)
  <!-- esegui script di avvenuta spedizione correttamente -->
 %ELSE%
  <!-- esegui script di spedizione non eseguita -->
 %ENDIF%
%ENDIF%

STRING %GETENV%
Scopo torna la stringa associata alla variabile di ambiente passata come argomento.

Sintassi %GETENV%(%STRING% var)

Descrizione consente di leggere il valore delle variabili ambientali del sistema operativo, di cui bisogna conoscere l'esistenza ed il nome.

Valore restituito valore alfanumerico.
Torna stringa vuota in caso di errore generico.

Esempio
%GETENV%("WINDIR")

Program output
c:\windows

NUMBER %GETFILE%
Scopo permette di copiare localmente un file da una locazione remota.

Sintassi %GETFILE%(%STRING% filedest, %STRING% url, %STRING% user, %STRING% psw [, %STRING% *header], %NUMBER% timeout [, %STRING% proxy, %NUMBER% pport [, %STRING% puser, %STRING% ppsw]])

Descrizione Utilizzata per copiare in locale, nella webroot, un file referenziato da url.
Sono gestiti solo i protocolli HTTP e FTP.

• filedestcontiene il body della risposta HTTP o il file richiesto via FTP (verrà creato oppure se esistente verrà sovrascritto);
• url contiene la url da eseguire;
• psw contiene la password per l'autenticazione sul server indicato in url;
• *header è un parametro opzionale, identificato da un buffer dichiarato precedentemente, che contiene la header HTTP della risposta;
• timeout tempo di attesa della risposta espresso in secondi;
• proxy è un parametro opzionale, gestito solo per il protocollo HTTP, che identifica il proxy che intercede all'esecuzione della url;
• pport è un parametro opzionale, rispetto all'uso di proxy, che identifica la porta sulla quale avviene l'autenticazione sul proxy;
• puser è un parametro opzionale, rispetto all'uso di proxy, che identifica il nome dell'utente riconosciuto dal proxy;
• ppsw è un parametro opzionale, rispetto all'uso di proxy, che identifica la password dell'utente puser di proxy.

Valore restituito valore numerico
Torna 0 in caso di operazione eseguita con successo;
Torna -1 o un codice di errore specifico, se disponibile, in caso di errore.

Vedere anche %HTTPPOST%

Esempio
%GETFILE%("c:\\temp\\locale.txt", "ftp://pippo.pluto.net:21/pub/esempio.txt", "anonymous","someone@somewhere",60)

NUMBER %GETKEYS%
Scopo cercare le chiavi di ricerca di un attributo relative alla selezione corrente.

Sintassi %GETKEYS%(%STRING% nomeattributo [, %STRING% buffer [, %NUMBER% html = 0]])

Descrizione legge le chiavi di ricerca di un determinato attributo, o in buffer se indicato, rispetto alla selezione corrente, e le scrive nelle variabili d'ambiente %QKPOS%, %QKLEN% e %QKNUM%.
nomeattributo deve comunque essere valorizzato, anche nel caso venga indicato buffer per i riferimenti necessari alla verifica delle caratteristiche delle chiavi. In caso di esito positivo, vengono valorizzati gli array %QKPOS% e %QKLEN% rispettivamente con gli offset e le lunghezze delle chiavi trovate. Il numero totale delle chiavi trovate è invece indicato in %QKNUM%.
html diverso da zero consente di filtrate le parti del testo comprese fra "<" e ">" e fra "<script>" e "</script>".

Valore restituito valore numerico
Torna il numero di chiavi trovate.

Vedere anche %QKPOS%, %QKLEN%, %QKNUM%

Esempio

NUMBER %GETMAIL%
Scopo scaricare una mail dal server di posta.

Sintassi %GETMAIL%(
  %STRING% server,     <!-- server pop -->
  %STRING% user,       <!-- utente pop -->
  %STRING% password,   <!-- password -->
  %STRING% *frommname, <!-- nome sender -->
  %STRING% *fromaddr,  <!-- indirizzo sender -->
  %STRING% *subject,   <!-- oggetto -->
  %STRING% *date,      <!-- data -->
  %STRING% *message,   <!-- messaggio -->
  %STRING% *text,      <!-- messaggio (textplain) -->
  %NUMBER% *total,     <!-- totale messaggi rimasti -->
  %NUMBER% index,      <!-- progressivo messaggio da leggere (1 il + vecchio) -->
  %NUMBER% maxsize,    <!-- dimensione massima messaggio -->
  %NUMBER% remove,     <!-- != 0 cancella il messaggio letto -->
  %NUMBER% timeout)    <!-- timeout in secondi -->

Descrizione Consente di prelevare dal 
server di posta il messaggio individuato.

Valore restituito valore numerico
Torna 0 se non ci sono messaggi.
Torna 1 se OK.
Torna < 0 in caso di errore generico.

Vedere anche %FWDMAIL%, %SENDMAIL%

NUMBER %GETPROFILE%
Scopo legge le impostazioni del file di inizializzazione d'archivio o del modulo Highway Application Server.

Sintassi %GETPROFILE%(%STRING% *val, %STRING% key, %STRING% sect)

Descrizione legge in val il valore associato alla chiave key nella sezione sect; se c'è un archivio corrente la ricerca avviene prima nel file di configurazione di archivio; in caso di chiave non trovata o in assenza di un archivio corrente la ricerca procede nel file di configurazione di Highway Application Server.

Valore restituito valore numerico
Torna il numero di caratteri copiati in caso di esito positivo.
Torna 0 in caso di errore generico.

Vedere anche %PROFILE%

NUMBER %GETTEMPFILENAME%
Scopo Ottenere da Highway Application Server un nome di file univoco.

Sintassi %GETTEMPFILENAME%( %STRING% *dest, %STRING% ext)

Descrizione Consente di ottenere un nome di un file univoco, calcolato da Highway Application Server completo di percorso e di estensione
L'estensione è rappresentata dal parametro ext, mentre il percorso è calcolato in base a quello che viene riconosciuto da Highway Application Server come il direttorio per i file temporanei.
Di norma, per installazioni tipiche, nelle quali i servizi Highway Server e Highway Application Server condividono lo stesso direttorio dei temporanei, questo percorso è dato da %TEMPDIR%/hwtemp.
Il direttorio dei temporanei viene impostato da Highway Application Server all'atto dell'installazione del servizio omonimo.
Se esistono le variabili ambientali TEMP o TMP o TEMPDIR dell'utente System della macchina server su cui avviene l'installazione, il direttorio dei FILE temporanei diverrà <valorevariabileambientale>/HwTemp.
In alternativa è possibile impostare un direttorio dei temporanei dal file di impostazione dell'Highway Application Server, dall'Hicgi.ini, indicando nella sezione [Server] la chiave TEMP associata ad un percorso esistente.
Questo sistema viene utilizzato di norma quando non è consentito il riavvio della macchina server che consentirebbe di rendere attive le impostazioni rilevate durante l'installazione.
%GETTEMPFILENAME% non crea nessun file, ne calcola solo il nome.
Il parametro *dest rappresenta una variabile di tipo %STRING% che deve essere creata dal chiamante, e che verrà valorizzata con il nome + percorso + estensione del file generato dalla %GETTEMPFILENAME%.

Valore restituito valore numerico.
Torna 0 in caso di errore generico.
Torna 1 in caso di successo

Vedere anche %TEMPDIR%, %CREATEFILE%

Esempio
%STRING%(file,"")
%STRING%(ext,"tmp")
%NUMBER%(hf, 0)
%NUMBER%(ret, %GETTEMPFILENAME%(file, ext))
%IF%(ret)
 %NUMCPY%(hf, %CREATEFILE%(file))
 %IF%(hf)
  <!-- elaborazione -->
  %IF%(%CLOSEFILE%(hf) == 0)
   <!-- errore chiusura file -->
  %ENDIF%
 %ELSE%
  <!-- errore creazione file -->
 %ENDIF%
%ELSE%
 <!-- errore in gettempfilename -->
%ENDIF%

NUMBER %GROUPS%
Scopo Variabile numerica di ambiente contenente il numero di gruppi definiti per le immagini associate al documento corrente.

Sintassi %GROUPS%

Descrizione assume valore diverso da 0 se esiste almeno una immagine associata al documento attuale.

Valore restituito valore numerico
Torna 0 in caso di nessuna immagine associata al documento.
Torna il numero dei gruppi di immagin associate al documento.

Vedere anche %CURGRP%, %PERGROUP%

Annotazioni

L'associazione delle immagini ad un documento con la definizione del gruppo di appartenenza è retaggio di archivi provenienti dall'ambiente Highway che fanno uso del modulo Eikon

STRING %HEX2BIN%
Scopo convertire in formato binario un determinato valore in formato esadecimale.

Sintassi %HEX2BIN%(%STRING% string_with_hex_value)

Descrizione dato un buffer di tipo %STRING% che contiene un valore esadecimale, la HEX2BIN ne converte il contenuto in un valore binario e lo memorizza in una stringa che viene tornata al chiamante.

Valore restituito valore alfanumerico
Torna un buffer di tipo %STRING% contenente l'esito della conversione.
In caso di errore generico non viene compilata dal modulo Highway Application Server.

Vedere anche %BIN2HEX%, %OEM2ANSI%, %ansi2oem%

Esempio
<!-- Documento client
genero la chiave di relazione per l'elemento Radice -->
%STRING%(key, "")
%IF%(%THSREL2KEY%(key, "Radice", "Termini specifici", ""))
 <!-- converto la chiave in formato esadecimale -->
 %STRCPY%(key, %BIN2HEX%(key))
 <A HREF="%SCRIPT%/a%CURARC/fForm+Thesaurus?KEY.x=%WRITE%()">Radice</A>
%ENDIF%
<!-- Documento server
prelevo la chiave di relazione e cerco l'elemento Radice -->
%STRING%(key, "")
%STRCPY%(key, %HEX2BIN%(%KEYVAL%(KEY.x))
%IF%(%THSGREATER%(key, key) == 3)
 ...

NUMBER %HIER%
Scopo torna in ndocs gli identificativi fisici (separati da "\n") e in titles i titoli (separati da "\n") dei documenti che compongono la gerarchia che conduce dalla radice al documento fisico indicato.

Sintassi %HIER%(%NUMBER% ndoc, %STRING% *titles, %STRING% *ndocs)

Descrizione consente di recuperare la lista dei documenti che compongono la gerarchia di ndoc a partire dal documento dichiarato come radice.
Le variabili precedentemente dichiarate titles e ndocs saranno valorizzate rispettivamente con le stringhe di titolo e i numeri fisici dei documenti che la compongono.
ndoc rappresenta il numero fisico del documento.

Valore restituito valore numerico
Torna 1 in caso di operazione eseguita con successo.
Torna 0 in caso di errore generico.

Vedere anche %BFIRST%, %BLEV%, %BSON%, %BLAST%, %BDOC%

STRING %HTTP_HOST%
Scopo torna il valore della variabile di ambiente HTTP_HOST.

Sintassi %HTTP_HOST%

Descrizione Contiene il valore impostato dal client nella header "Host:",
Dovrebbe contenere uno degli alias con i quali è noto il server HTTP ovvero il nome specificato dal client nella sua richiesta.
Ad esempio un client che invia la richiesta "http://www.serverhost.com:8000/foo.html" dovrebbe indicare "www.serverhost.com" nella header. Se assente viene restituito il valore della variabile SERVER_NAME.

Valore restituito valore alfanumerico
Torna stringa vuota in caso di errore generico.

NUMBER %HTTPPOST%
Scopo esegue una richiesta HTTP verso un server remoto.

Sintassi %HTTPPOST%(
    %STRING% url,        <!-- url -->
    %STRING% header,     <!-- intestazioni aggiuntive -->
    %STRING% body,       <!-- corpo -->
    %NUMBER% bodylen,    <!-- dimensione body -->
    %STRING% user,       <!-- utente login -->
    %STRING% pass,       <!-- password login -->
    %STRING% *outhdr,    <!-- intestazione risposta -->
    %STRING% *result,    <!-- risposta -->
    %NUMBER% timeout [,  <!-- tempo attesa risposta (sec.) -->
    %STRING% proxy,      <!-- nome proxy -->
    %NUMBER% pport [,    <!-- porta proxy -->
    %STRING% puser,      <!-- utente login proxy -->
    %STRING% ppsw]])     <!-- password login proxy -->

Descrizione consente di eseguire una url verso un server remoto.

Valore restituito valore numerico
Torna 0 in caso di operazione eseguita con successo;
Torna -1 o un codice di errore specifico, se disponibile, in caso di errore.

Vedere anche %GETFILE%

NUMBER %HWCOUNT%
Scopo utilizzato da Highway Application Server nella chiamata a funzioni di librerie esterne

Sintassi %HWCOUNT%

Descrizione viene valorizzato in uscita da una chiamata ad una funzione di libreria esterna con il numero dei parametri ritornati dalla funzione richiesta con %HWCUSTOM% o %HWLIB%

Valore restituito valore anumerico
Torna il numero dei parametri ritornati dalla funzione di libreira esterna invocata.

Vedere anche %HWCUSTOM% %HWLIB%

NUMBER %HWCUSTOM%
Scopo richiede l'esecuzione della funzione specificata della libreria di archivo (nomearchivio.dll/.so).

Sintassi %HWCUSTOM%(%STRING% nomefunzione, %STRING% parametri)

Descrizione Consente di utilizzare le funzioni dichiarate in una determinata libreria che prende il nome dell'archivio corrente.
Ad Highway Server è demandato il compito di inizializzare e terminare la libreria indicata.
In uscita, se non vi sono errori, vengono valorizzati %HWOUT%(%INDEX%) e %HWCOUNT%.

Valore restituito valore numerico
Torna un valore diverso da zero se l'operazione è stata eseguita con successo;
Torna 0 in caso di errore generico.

Vedere anche %HWOUT%, %HWCOUNT%, %HWLIB%

NUMBER %HWLIB%
Scopo richiede l'esecuzione della funzione specificata della libreria indicata.

Descrizione come %HWCUSTOM% permette di eseguire un funzione contenuta in una libreria, ma a differenza di %HWCUSTOM% consente di specificare il nome della libreria da utilizzare.

flags
valori	descrizione
0	la libreria viene scaricata in uscita dalla funzione
0x04	la libreria viene scaricata solo al termine del processo

In uscita, se l'operazione si è svolta con successo, vengono impostati %HWCOUNT% e %HWOUT%(indice) valorizzando rispettivamente il numero di parametri tornati e il loro valore.

Valore restituito valore numerico
Torna un valore diverso da 0 in caso di successo
Torna 0 in caso di errore generico.

Vedere anche %HWOUT%, %HWCUSTOM%, %HWCOUNT%

STRING %HWOUT%
Scopo consente di accedere ad un riferimento ad un parametro in uscita.

Descrizione Utilizzato dopo una chiamata ad una funzione eseguita con %HWCUSTOM% O %HWLIB% riceve i riferimenti ai parametri in uscita della funzione chiamata.
indice è espresso in base 1.

Valore restituito valore alfanumerico
Torna una stringa valorizzata con i parametri tornati.
Torna una stringa vuota in caso di errore generico.

Vedere anche %HWCUSTOM%, %HWLIB%, %HWCOUNT%

NUMBER %IDXGREATER%
Scopo data una chiave di riferimento, consente di leggere la chiave successiva del vocabolario verticale.

Descrizione Data una chiave di posizionamento s consente di richiedere ad Highway Server la chiave successiva del vocabolario verticale dell'attributo corrente.
In *d, precedentemente dichiarata dallo script chiamante, sarà memorizzata la chiave successiva a quella indicata in s.
(direzione di interrogazione: verso il basso)

Valore restituito valore numerico.
Torna 0 in caso di fine lista.
Torna 1 in caso la chiave in d NON ha come radice s.
Torna 2 in caso la chiave in d ha come radice s.
Torna 3 in caso trovata esattamente s.
Torna < 0 in caso di errore.

Vedere anche %IDXNEXT%, %IDXPREV%

Esempio
%IF%(%4CALL%("ThVerticale", <nomeattr>, <valore>, <direzione>, %MAXVITEMS%, ""))
 %STRCPY%(keyth, "")
 %numcpy%(keyon, 0)
 %IF%(idxgreater(keyth, %VITEM%(1)) == 3)
  %STRCPY%(keyth, "")
  %IF%(idxprev(keyth))
   <!-- prima pagina -->
   <A href="..."><img src="primapagina.gif"></A>
   <!-- pagina precedente -->
   <A href="..."><img src="paginaprecedente.gif"></A>
  %ELSE%
   <!-- prima pagina disabilitata-->
   <A href="..."><img src="primapagina_gray.gif"></A>
   <!-- pagina precedente disabilitata-->
   <A href="..."><img src="paginaprecedente_gray.gif"></A>
  %ENDIF%
 %ENDIF%
 %STRCPY%(keyth, "")
 %numcpy%(keyon, 0)
 %IF%(idxgreater(keyth, %VITEM%(%VITEMS%)) == 3)
  %STRCPY%(keyth, "")
  %IF%(idxnext(keyth))
   <!-- pagina successiva -->
   <A href="..."><img src="paginasuccessiva.gif"></a>
   <!-- ultima pagina -->
   <A href="..."><img src="ultimapagina.gif"></A>
  %ELSE%
   <!-- pagina successiva disabilitata-->
   <A href="..."><img src="paginasuccessiva_gray.gif"></a>
   <!-- ultima pagina disabilitata-->
   <A href="..."><img src="ultimapagina_gray.gif"></A>
  %ENDIF%
 %ENDIF%
%ENDIF%

NUMBER %IDXNEXT%
Scopo legge la chiave successiva del vocabolario verticale (rispetto alla posizione corrente).

Descrizione Consente di recuperare la successiva chiave di vocabolario verticale.
Highway Application Server inizializza, al primo accesso al vocabolario verticale, un descrittore che mantiene un riferimento alla chiave corrente.
Invocando %IDXNEXT% senza precedenti chiamate di posizionamento (vedi %IDXGRATER%) la chiave ritrovata corrisponderà alla chiave successiva a quella corrente.
Se il descrittore è attualmente posizionato al termine del vocabolario verticale, sarà tornato il primo termine della lista.

Valore restituito valore numerico
Torna un valore diverso da 0 in caso di esito positivo;
Torna 0 in caso di errore generico.

Vedere anche %IDXGREATER%, %IDXPREV%

Esempio
(vedi %IDXGREATER%)

NUMBER %IDXPREV%
Scopo legge la chiave precedente del vocabolario verticale (rispetto alla posizione corrente).

Descrizione Invocando %IDXPREV% senza aver precedentemente invocato alcuna funzione di posizionamento, si otterra la chiave precedente alla chiave corrente (quella sulla quale il descrittore del file indice è attualmente posizionato).
d dovrà essere dichiarato dallo script chiamante sarà valorizzato al ritorno della chiamata.

Valore restituito valore numerico
Torna un valore diverso da 0 in caso di esito positivo;
Torna 0 in caso di errore generico.

Vedere anche %IDXGREATER%, %IDXNEXT%

Esempio
(vedi %IDXGREATER%)

VOID %IGNOREECHO%
Scopo disabilita l'ascolto delle successive istruzioni di ECHO sullo script in elaborazione.

Descrizione consente di intervenire in un determinato script disabilitando qualsiasi successiva istruzione di ECHO.
Utilizzato in fase di debug per mandare in output l'esecuzione dello script indipendentemente dalle condizioni di ECHO impostate successivamente.

Valore restituito nessun valore

Vedere anche %DETACH%, %ECHOON%, %ECHOOFF%

Esempio
...
%IGNOREECHO%
%ECHOOFF% utilizzare in fase di debug<br>
%SKIP% Frase di ricerca %ENDSKIP%
%SELDATA%
%ECHOON%
...

Program output
utilizzare in fase di debug
(([CAMPO]=VALORE))

NUMBER %IMAGES%
Scopo Variabile d'ambiente che contiene il numero di immagini associate al documento corrente.

Descrizione variabile dell'ambiente Highway Application Server disponibile a seguito del caricamento di un documento tramite %BLOADDOC%, che consente di rilevare il numero delle immagini allegate ad un documento.
Questa istruzione rileva le immagini che sono state allegate ad un determinato documento mediante l'uso di Eikon in applicazioni native (ambiente Highway).
La gestione delle immagini allegate mediante l'uso di Highway Imaging Control consente di determinare il numero delle immagini allegate ad un determinato documento mediante chiamata alla funzione %ATTROWS% per l'attributo dedicato a contenerne i riferimenti.

Valore restituito valore numerico
Torna il numero delle immagini associate al documento.
Torna 0 se non vi sono immagini associate al documento.
Non viene compilato in caso di errore generico.

Vedere anche %IMAGEPATH%, %IMAGEURL%, %THUMB%, %THUMBURL%

Esempio
%IF%(%IMAGES%)
 %REPEAT% (1,%IMAGES%)
  <IMG SRC="%IMAGEURL% (%INDEX%)">Immagine nr. %INDEX%<BR>
 %ENDREPEAT%
%ELSE%
 nessuna immagine presente<BR>
%ENDIF%

Program output
Immagine nr. 1
Immagine nr. 2

STRING %IMAGEURL%
Scopo Variabile ambientale alfanumerica contenente l'URL della immagine allegata.

Descrizione Permette di recuperare la URL dell'immagine individuata da %INDEX%, prelevandola dalla lista delle immagini associate al documento, precedentemente caricato tramite la %BLOADDOC%.

Valore restituito valore alfanumerico
Torna una stringa con la URL dell'immagine indicata.
Torna una stringa vuota in caso di errore generico.

Vedere anche %THUMBURL%

Esempio
(vedi %IMAGES%)

STRING %IMAGEPATH%
Scopo Variabile ambientale alfanumerica contenente il percorso DOS della immagine allegata.

Descrizione Permette di recuperare il percorso DOS dell'immagine individuata da %INDEX%, prelevandola dalla lista delle immagini associate al documento corrente.
Chiaramente il percorso sarà relativo alla locazione nella quale il server memorizza i file-immagine.

Valore restituito valore alfanumerico
Torna una stringa contenente un percorso + nomefile + estensione in caso di esito positivo;
Torna stringa vuota in caso di errore generico.

Vedere anche %IMAGEURL%

DIRECTIVE %INCLUDE%
Scopo Processa ed include il file specificato

Descrizione usato per processare ed includere all'interno della form corrente il file specificato. nomefile rappresenta un identificativo di file dichiarato nella sezione [CGI] nel file <nomearchivio>.ini oppure nella sezione [GENERICO] di hicgi.ini.

Valore restituito nessuno

NUMBER[*] %INDEX%
Scopo variabile ambientale numerica contenente l'indice di una lista di elementi dello stesso tipo.

Descrizione variabile ambientale numerica che rappresenta l'indice di riferimento di una lista di elementi.
Usata nei loop (%REPEAT%...%ENDREPEAT%);
il parametro opzionale va usato per referenziare indici di loop più esterni: 1 indica il loop corrente (default che non necessita di essere indicato), 2 quello immediatamente più esterno e così via.

Valore restituito valore numerico
Torna il valore dell'elemento richiesto all'interno di un ciclo loop.

Vedere anche Cicli

Esempio
%REPEAT%(1, %TOTSEL%)
 %INVALIDATEDOC%
 %IF%(%BLOADDOC%(%CURDOC% + %INDEX%))
  %IF%(%IMAGES%)
   %REPEAT%(1, %IMAGES%)
    <IMG src="%THUMBURL%(%INDEX%)" alt="%DOCTITLE%(%CURDOC%+%INDEX%(2))"></A>
   %ENDREPEAT%
  %ENDIF%
 %ENDIF%
%ENDREPEAT%

VOID %INVALIDATEDOC%
Scopo forza il caricamento del documento alla prossima richiesta.

Descrizione Indica ad Highway Application Server che alla prossima chiamata della %LOADDOC% o %BLOADDOC%, il documento deve essere caricato direttamente dal database e non dall'eventuale precedente cache.
Consente quindi di essere certi che i dati che saranno disponibili sono quelli che in quel momento sono memorizzati nella base dati, e non quelli precaricati da una precedente lettura dello stesso documento.

Valore restituito nessuno

Vedere anche %LOADDOC%, %BLOADDOC%

VOID %INVALIDATEARC%
Scopo forza l'apertura dell'archivio alla prossima richiesta.

Descrizione Come per la %INVALIDATEDOC%, indica ad Highway Application Server che la prossima richiesta di accesso all'archivio corrente dovrà ricaricare il relativo archivio.
Permette di essere certi dell'attualità dei dati e della struttura dell'archivio a cui si intende accedere.

Valore restituito nessuno

Vedere anche %OPENARC%, %CLOSEARC%

NUMBER %INVREL%
Scopo torna il progressivo della relazione inversa dell'elemento indicato.

Descrizione torna il progressivo, in base 1, nell'elenco delle relazioni di thesaurus associato alla relazione reciproca della relazione individuata da pos.

Valore restituito valore numerico
Torna un valore numerico maggiore di 0;
Torna -1 se la relazione non ha reciprocità.

Vedere anche %REL%, %RELSINT%, %RELPOS%, %RELDESCR%

STRING %ITOA%
Scopo converte un valore numerico in una stringa.

Descrizione Dato un valore numerico, consente di ottenerne la rappresentazione in formato stringa.
base rappresenta la base numerica verso la quale eseguire la conversione (p.e. ottale, decimale, esadecimale ...)
Su piattaforma UNIX non sono gestiti valori di base diversi da 8,10 o 16.

Valore restituito valore alfanumerico
Torna 0 in caso di errore generico.

Vedere anche %ATOI%

Esempio
%NUMBER%(n1, 16)
%WRITE%(%ITOA%(n1, 8))<br>
%WRITE%(%ITOA%(n1, 10))<br>
%WRITE%(%ITOA%(n1, 16))<br>

Program output
20
16
10

STRING %ITOM%
Scopo torna la rappresentazione binaria di un numero intero.

Descrizione Utilizzata per ottenere la rappresentazione binaria di un numero intero n.
Ad esempio su piattaforma Intel 32 %ITOM%(3) torna i quattro byte: 03 00 00 00.
Il tipo %STRING% è idoneo anche alla rappresentazione di dati binari.
La funzione strlen() in questo caso torna la dimensione dell'area di memoria occupata e non viene disturbata dalla presenza di zeri.

Valore restituito valore alfanumerico
Torna una stringa che rappresenta il valore convertito; Non viene compilata l'istruzione in caso di errore generico.

Vedere anche %MTOI%, %BIN2HEX%, %HEX2BIN%

Esempio
%NUMBER%(n, 3)
%WRITE%(%ITOM%(n))

Program output
03 00 00 00

STRING %JD2DATE%
Scopo converte una data dal formato numerico di calcolo al formato Highway: "aaaammgg".

Descrizione Utilizzata per la riconversione di una data codificata con %DATE2JD% in formato numerico idoneo per il calcolo fra date, nel formato data di Highway.

Valore restituito valore alfanumerico
Torna una stringa che rappresenta la conversione dell'argomento ricevuto.

Vedere anche %DATE12JD%, %DATE%, %DATE$%, %DATE2ATTR%, %CURDATE%

Esempio
%NUMBER%(ndate, %DATE2JD%("20001128"))
%WRITE%(%ITOA%(ndate))<br>
%JD2DATE%(ndate)

Program output
2451876
20001128

VOID %KEYCHR%
Scopo imposta il carattere usato nella delimitazione delle istruzioni del linguaggio di script.

Descrizione consente di modificare il carattere utilizzato per delimitare le parole chiave del linguaggio di script Highway Language;
La modifica del carattere separatore delle parole chiave avrà effetto immediatamente dopo l'istruzione %KEYCHR% e terminerà la sua efficacia al termine dello script nel quale è stata inserita (l'effetto si ripercuote anche sugli script inclusi).

Valore restituito nessuno

Esempio
%STRING%(var, "")
%KEYCHR%("")
STRCPY(var,"prova")
...
KEYCHR("_")
_STRCAT_(var,"prova2")

STRING %KEYSEPAR%
Scopo torna i separatori per l'attributo specificato.

Descrizione Richiede ad Highway Application Server i caratteri separatori previsti per l'attributo indicato in attributo.
Sono previsti caratteri separatori solo per gli attributi dichiarati Multivalore.

Valore restituito valore alfanumerico
Torna una stringa che contiene i caratteri separatori oppure una stringa vuota;
Non viene compilata in caso di errore generico.

Vedere anche %ATTRINFO%, %ATTRTYPE%

Esempio
%STRING%(separatori, "")
%NUMBER%(idtab, %NUMTABELLA%("TABELLA1"))
%NUMBER%(idattr, %NUMATTR%(idtab, "ATTRIBUTO1"))
%NUMBER%(infoattr, %ATTRINFO%(idtab, idattr))
%IF%(infoattr & 0x00000800)
 %STRCPY%(separatori, %KEYSEPAR%("ATTRIBUTO1"))
 ...
%ENDIF%

STRING [*] %KEYVAL%
Scopo recupera il valore di una coppia chiave-valore.

Descrizione Consente di richiedere il valore di una determinata coppia chiave-valore, cioè di una variabile dichiarata in riga di comando del browser o di un link

Valore restituito valore alfanumerico
Torna una stringa con il valore assegnato alla chiave;
In caso di chiave ripetuta, torna il valore assegnato alla prima istanza della chiave;
Torna una stringa vuota in caso di errore generico o chiave vuota o non presente.

Vedere anche %KEYNAME%, %TUPLEKEY%, %TUPLEVAL%

Esempio
data una riga di comando del tipo:
http;//www.miocomputer.it/h3/h3.exe/anomearchivio?coppia1=valore1;coppia2=valore2
%KEYVAL%("coppia1")
%KEYVAL%("coppia2")
%KEYVAL%("coppia3")

Program output
valore1
valore2

NUMBER %KEYFILE%
Scopo torna la dimensione dei dati associati ad un <input type="file">

Descrizione Consente di verificare il contenuto della coppia chiave-valore originata da un tag di tipo <INPUT type="file"> sulla pagina html del client purchè nel tag <form> della pagina stessa sia stato dichiarato ENCTYPE="multipart/text-data".
In base al valore ritornato dalla %KEYFILE% si potrà determinare l'esistenza di un file allegato.
Utilizzata per inviare al server web una quantità di dati non consentita in riga di camando oppure per la gestione di file allegati senza l'ausilio di Highway Imaging Control.

Valore restituito valore numerico
Torna la dimensione in bytes del file allegato;
Torna 0 in caso di errore generico o di nessun file associato alla coppia chiave-valore.

Vedere anche %KEYWRITE%, %KEYAPPEND%

Esempio
%IF%(%KEYFILE%("file"))
 %STRING%(nomefilesuhost, "")
 %STRING%(nomefilesuclient, %KEYVAL%("file"))
 %NUMBER%(pos, %STRSTR%(nomefilesuclient, ".") + 1)
 %GETTEMPFILENAME%(nomefilesuhost, %MID%(nomefilesuclient, pos, -1))
 %KEYWRITE%("file", nomefilesuhost)
%ENDIF%

NUMBER %KEYWRITE%
Scopo scrive il contenuto del file ricevuto su un file locale, svuotandolo se già valorizzato.

Descrizione Consente di salvare in un file, sul web server, il contenuto di un file ricevuto dal client.
Highway Application Server scrive il contenuto del file rilevato dalla coppia chiave-valore indicata in chiave nel file indicato in nomefile; se nomefile non è vuoto, sarà sovrascritto con il nuovo valore.
Per l'invio di file da parte del client, deve essere dichiarato un tag <FORM> con la proprieta ENCTYPE="multipart/form-data" ed un tag <INPUT> con type="file"

Valore restituito valore numerico
Torna il numero di bytes scritti se l'operazione è andata a buon fine;
Torna -1 in caso di errore.

Vedere anche %KEYFILE%, %KEYAPPEND%

Esempio
(vedi vedi %KEYFILE%)

NUMBER %KEYAPPEND%
Scopo scrive in coda ad un file esistente il contenuto del file ricevuto.

Descrizione Consente di salvare in coda ad un file esistente, sul web server, il contenuto di un file ricevuto dal client.
Highway Application Server apre un file esistente con il nome indicato in nomefile in modalità "append" e vi scrive il contenuto del file rilevato dalla coppia chiave-valore indicata in chiave.
Per l'invio di file da parte del client, deve essere dichiarato un tag <FORM> con la proprieta ENCTYPE="multipart/form-data" ed un tag <INPUT> con type="file"

Valore restituito valore numerico
Torna il numero di bytes scritti se l'operazione è andata a buon fine;
Torna -1 in caso di errore.

Vedere anche %KEYFILE%, %KEYWRITE%

Esempio
%STRING%(nomefilesuhost, "")
%IF%(%KEYFILE%("file"))
 %IF%(%STRLEN%(nomefilesuhost))
  %IF%(%PROFILE%(nomefilesuhost, "file4file", "Generico")==0)
   %IF%(%GETTEMPFILENAME%(nomefilesuhost, ".txt"))==0)
    %INCLUDE%("ErrOnSaveData")
   %ENDIF%
  %ENDIF%
 %ENDIF%
 %IF%(%STRLEN%(nomefilesuhost))
  %KEYAPPEND%("file", nomefilesuhost)
 %ENDIF%
%ENDIF%

NUMBER[*] %LASTERRORNUMBER%
Scopo recupera il codice numerico associato all'ultimo errore

Sintassi %LASTERRORNUMBER%

Descrizione Consente di rilevare il codice identificativo dell'ultimo errore rilevato.

Valore restituito valore numerico
Torna l'identificativo numerico dell'ultimo errore rilevato.
Torna 0 in caso di errore generico.

Vedere anche %LASTERRORSTRING%

STRING %LASTERRORSTRING%
Scopo recupera la descrizione dell'ultimo errore rilevato.

Sintassi %LASTERRORSTRING%

Descrizione variabile di sola lettura che consente di recuperare il messaggio associato all'ultimo errore rilevato relativamente ad una richiesta verso Highway Server identificata da %LASTERRORNUMBER%.

Valore restituito valore alfanumerico
Torna il messaggio associato all'ultimo errore rilevato.
Torna una stringa vuota in caso di errore generico.

Vedere anche %LASTERRORNUMBER%

STRING %LASTUPDATE%
Scopo stringa con data e ora dello script corrente nel formato gg/mm/aaaa hh:mm:ss.

Descrizione COnsente di accedere ad informazioni sui file relativamente agli script in esecuzione.
%LASTUPDATE% consente di rilevare la data e l'ora in cui sono stati aggiornati gli script in esecuzione.

Valore restituito valore alfanumerico
Torna data e ora in formato dell'ultima modifica eseguita sul file-script in esecuzione.
Torna stringa vuota in caso di errore generico.

Vedere anche %FILEDATE%, %FILESIZE%, %FILEATTR%

STRING %LEFTTRIM%
Scopo Processa la stinga specificata rimuovendo spazi, tabulazioni, carriage return e new line iniziali.

Descrizione usato per rimuovere spazi, TAB, CR ed LF in testa ad una stringa specificata.

Valore restituito valore alfanumerico
Torna una stringa dalla quale sono stati rimossi spazi, tabulazioni, carriage return e new line nella parte iniziale;
Torna una stringa vuota in caso di errore generico.

Vedere anche %RIGHTTRIM%, %MID%

Esempio
%STRING%(testa, "Highway")
%STRING%(coda, " Application Server")
%WRITE%(testa)%WRITE%(coda)<br>
%WRITE%(testa)%WRITE%(%LEFTTRIM%(coda))

Program output
Highway     Application Server
HighwayApplication Server

VOID %LOADDOC%
Scopo rende disponibili i dati del documento specificato

Descrizione Esegue il caricamento del documento corrente valorizzando le relative variabili ambientali come %CURDOC% e rendendo disponibili i contenuti degli attributi.
A differenza di %BLOADDOC%, questa funzione non ritorna nessuna conferma sul corretto caricamento del corrente.

Valore restituito nessuno.

Vedere anche %BLOADDOC%

NUMBER %LOCK%
Scopo blocca l'archivio corrente.

Descrizione Blocca l'archivio corrente, impedendo l'accesso a qualsiasi istanza di Highway Application Server fino alla successiva chiamata di %UNLOCK% o fino a che non vengono terminate tutte le sue istanze.
L'esecuzione di %LOCK% quando l'archivio è già bloccato, genera un valore di ritorno che indica errore proprio perchè l'archivio è già bloccato.

Valore restituito valore numerico
Torna 1 se l'operazione è andata a buon fine;
Torna 0 in caso di errore generico o di archivio già bloccato.

Vedere anche %UNLOCK%, %DBLOCK%, %DBUNLOCK%

NUMBER %LOCKFILE%
Scopo imposta o rimuove un blocco sul file identificato.

Descrizione blocca l'accesso al file identificato da fileid fino alla successiva chiamata a %LOCKFILE% con mode=2.
mode assume i seguenti valori:

valore	descrizione
0	richiede il blocco del file restando in attesa fino al completamento dell'operazione (fino a 10 secondi su piattaforma NT)
1	non attende se l'operazione non viene completata al primo tentativo
2	sblocca il file

count su alcune piattaforme UNIX viene ignorato;
su piattaforma NT specifica il numero di bytes da bloccare a partire dalla posizione corrente;
se omesso il blocco viene esteso a tutto il file.

Valore restituito valore numerico
Torna 0 in caso di operazione eseguita con successo;
Torna -1 in caso di errore generico.

VOID %LOGWRITE%
Scopo scrive lo specificato messaggio sul file di log indicato.

Descrizione Consente di spedire un messaggio al file di log redatto da Highway Application Server.
messaggio contiene il messaggio da scrivere sul file di log;
mode indica su quale file deve essere scritto messaggio e può assumere i seguenti valori:

valore	descrizione
1	scrive sul file di log dell'applicazione
2	non scrive sulla finestra di console
4	scrive sul file di log di sistema

Valore restituito nessuno

Vedere anche %KEYWRITE%, %WRITE%, %OUTPUTTO%

Esempio
%logwrite%("scrivi su hicgi.log", 1)
%logwrite%("non scrivere sulla finestra di console", 2)
%logwrite%("scrivi sul file di log di sistema, se esiste e se viene redatto", 4)

STRING %MASK%
Scopo Codifica di caratteri

Sintassi %MASK%(%STRING% data, %STRING% seed, %NUMBER% mode)

Descrizione Torna la codifica di data secondo il seme seed.
mode può assumere i seguentoi valori:

• mode = 0
  garantisce la stampabilità dei dati se in ingresso sono stampabili;
  versioni di Highway Application Server >= 3.2.5.3 producono risultati diversi dalle versioni precedenti per stringhe conteneti caratteri al di sopra di 127;
• mode = 1
  non garantisce la stampabilità dei dati in uscita.

Valore restituito valore alfanumerico
Torna stringa vuota in caso di errore generico.

Vedere anche %UNMASK%

Esempio
%STRING%(msg2cript, "Importo base dell'appalto: £ 130.000.000")
%STRING%(keycode, "3D Informatica")
%STRING%(msgcoded, "")
%NUMBER%(mode, 1)
%STRCPY%(msgcoded, %MASK%(msg2cript, keycode, mode))
%WRITE%(msgcoded)<br>
<!-- chi conosce la chiave di decodifica 'keycode' può leggere il valore criptato -->
%STRCPY%(msg2cript, %MASK%(msgcoded, keycode, mode))
%WRITE%(msgcoded)<br>

Program output
I\Qv[InVxZuUnWD Li MVY(hH eOVvxNyQD'Xe`xqVZD^I Ywo+8T I£O ^(N)`.q4p1k5f5E. 3w9.,
Importo base dell'appalto: £ 130.000.000

NUMBER %MAXBITEMS%
Scopo numero massimo di voci visualizzate per pagina di browse gerarchico.

Descrizione Variabile dell'ambiente Highway che rappresenta il numero massimo di elementi visualizzabili in una pagina di BrowseGerarchico.
Tipicamente utlizzata con l'istruzione %REPEAT% per eseguire il loop sugli elementi da visualizzare in uno script hl.
E' previsto un valore di default = 12, di norma indicato in hicgi.ini

Valore restituito valore numerico
Torna il numero degli elementi visualizzabili oppure il valore di default.

Vedere anche %MAXTHUMBS%, %MAXVITEMS%, %MAXTHUMBS%, compilazione di nomerachivio.ini

Esempio
%IF%(%5CALL%("BrowseGerarchico", stato, "", %NUMDOC%, 7, "Max Righe Browse"))
 %REPEAT%(1, %MAXBITEMS%)
  ...
 %ENDREPEAT%
%ENDIF%

NUMBER %MAXTHUMBS%
Scopo Variabile numerica di ambiente contenente il numero massimo di thumbnails (dispositive) visualizzabili all'interno di una pagina di indici.

Descrizione contiene il numero massimo di thumbnails (dispositive) visualizzabili all'interno di una pagina di indici.

Valore restituito valore numerico
Torna il numero degli elementi visualizzabili oppure il valore di default.

Vedere anche %MAXVITEMS%, %MAXBITEMS%, compilazione di nomerachivio.ini

NUMBER %MAXVITEMS%
Scopo Variabile numerica di ambiente contenente il numero massimo di voci visualizzabili all'interno di una pagina di vocabolario.

Descrizione contiene il numero massimo di elementi visualizzabili all'interno di una pagina di vocabolario.
E' previsto un valore di default = 12, di norma indicato in hicgi.ini

Valore restituito valore numerico
Torna il numero degli elementi visualizzabili oppure il valore di default.

Vedere anche %MAXTHUMBS%, %MAXBITEMS%, compilazione di nomerachivio.ini

VOID %MEMCPY%
Scopo Copia il contenuto di una variabile all'interno di un'altra variabile, a partire dalla posizione specificata

Descrizione Copia il contenuto di s2 all'interno di s1 , partendo da una posizione from (base 0) relativa a s1.
s1 viene sovrascritta a partire da from e se necessario, viene ampliata la porzione di memoria occupata.

Valore restituito nessuno

Vedere anche %MEMSET%, %STRCPY%, %STRCAT%

Esempio
%STRING%(var1, "Highway Protocol")
%STRING%(var2, "Application Server")
%MEMCPY%(var1, var2, 7)
%WRITE%(var1)

Program output
Highway Application Server

NUMBER %MEMCMP%
Scopo esegue il confronto di un indicato numero di caratteri in modo case sensitive fra due stringhe indicate.

Descrizione Confronta, in modo case sensistive, il contenuto di s1 con s2 dei primi n caratteri.

Valore restituito valore numerico
Torna: s1<s2 -> <0, s1==s2 -> 0, s1>s2 -> >0.

Vedere anche %MEMICMP%, %STRCMP%, %STRICMP%

Esempio
%ITOA%(%MEMCMP%("Highway","Language", 7))
%ITOA%(%MEMCMP%("Language","Highway", 7))
%ITOA%(%MEMCMP%("Language","language", 8))

Program output
-1
1
-1

NUMBER %MEMICMP%
Scopo esegue il confronto di un indicato numero di caratteri in modo case insensitive fra due stringhe indicate.

Descrizione Confronta, in modo case insensistive, il contenuto di s1 con s2 dei primi n caratteri.

Valore restituito valore numerico
Torna: s1<s2 -> <0, s1==s2 -> 0, s1>s2 -> >0.

Vedere anche %MEMCMP%, %STRCMP%, %STRICMP%

Esempio
%ITOA%(%MEMCMP%("Highway","Language", 7))
%ITOA%(%MEMCMP%("Language","Highway", 7))
%ITOA%(%MEMCMP%("Language","language", 8))

Program output
-1
1
0

VOID %MEMSET%
Scopo Esegue la copia di un carattere, per un numero di volte impostato, su un altra stringa, partendo dalla posizione indicata.

Descrizione Consente di eseguire copiare s1 in s2 per un numero di volte espresso da count (base 1), partendo dalla posizione indicata da from (base 0) .
Se s1 contiene più di un carattere, verrà replicato il primo carattere di s1.

Valore restituito nessuno.

Vedere anche %STRCHG%, %CLASSCOPY%

Esempio
%STRING%(p, "prova")
%MEMSET%(p, "cz", 2, 10)

Program output
prcccccccccc

STRING %MID%
Scopo Estrae una sottostringa di un numero di caratteri indicato partendo da una determinata posizione.

Descrizione usata per estrarre da una stringa di partenza s un certo numero di caratteri count (base 1) a partire da una certa posizione start (base 0).
Se count viene posto a -1, viene estratta una sottostringa a partire da start fino a fine s

Valore restituito valore alfanumerico
Torna una sottostringa;
Non viene compilata in caso di errore generico.

Vedere anche %MEMCPY%

Esempio
%STRING%(h, "Highway Language")
%STRING%(h2, "")
%STRCPY%(h2, %MID%(h, 8, 8))
%WRITE%(h2)<br>
%STRCPY%(h2, %MID%(h, 8, -1))
%WRITE%(h2)

Program output
Language
Language

NUMBER %MKINDEX%
Scopo rigenera l'indice dell'archivio corrente.

Descrizione mediante questo comando è possibile rigenerare il vocabolario verticale.
Di norma si rende necessario ricostruire il vocabolario verticale di un database a seguito di cancellazione di documenti, per eliminare gli elementi con ricorrenza uguale a zero; oppure a seguito di malfunzionamenti nella visualizzazione o nella ricerca.
Prima di eseguire una rigenerazione del vocabolario verticale, è consigliato un blocco completo del database oppure si consiglia di creare un agent da scatenare in momenti di inattività.

Valore restituito valore numerico
Torna 1 in caso di esito positivo;
Torna 0 in caso di errore generico.

Vedere anche %ADMIN%, %DBLOCK%, %LOCK%, %MKTITLES%

Esempio
%STRING%(head, "")
%STRING%(body, "")
%STRING%(enddoc, "</body></html>")

%STRCAT%(head, "<html><head>")
%STRCAT%(head, "<title>Aggiornamento indici</title>")
%STRCAT%(head, "<head>")
%STRCAT%(body, ""<body>")
%WRITE%(head)
%WRITE%(body)
%IF%(%OPENARC%("<aliasarchivio>") == 0)
 %IF%(%DBLOCK%("<aliasarchivio>", 0))
  %IF%(%MKINDEX%)
   %WRITE%("Aggiornamento eseguito con successo")
  %ELSE%
   %WRITE%("Errori in aggiornamento.")
  %ENDIF%
  %IF%(%DBUNLOCK%("<aliasarchivio>") == 0)
   %WRITE%("Fallito sblocco del database")
  %ENDIF%
 %ELSE%
  %WRITE%("Fallito apertura esclusiva database")
 %ENDIF%
 %IF%(%CLOSEARC%("<aliasarchivio>") == 0)
  %WRITE%("Errore in fase di chiusura archivio")
 %ENDIF%
%ELSE%
 %WRITE%("Errore in fase di apertura archivio")
%ENDIF%
%WRITE%(enddoc)

NUMBER %MKTITLES%
Scopo Esegue la rigenerazione dei titoli dell'archivio corrente.

Descrizione Consente la rigerazione della stringhe del titolo del database corrente.
L'uso delle stringhe dei titoli (memorizzate in <nomearchivio>.tit e <nomearchivio>.tip) consente, soprattutto in applicazione con elevato numero di documenti, di velocizzare le operazioni di ritorno della ricerca.
Highway Server, dopo aver eseguito una ricerca, anzichè aprire tutti i documenti selezionati per estrarre e costruire run-time le stringhe dei titoli, esegue un posizionamento nei suddetti file ed estrae le stringhe dei titoli da questi, accedendo al database solo al momento della richiesta di visualizzazione del documento.
Per operazioni di questo tipo è consigliato applicare il blocco totale del database o la generazione di un agent da scatenare in momenti di inattività.

Valore restituito valore numerico
Torna 1 in caso di esito positivo;
Torna 0 in caso di errore generico.

Vedere anche %MKINDEX%

Esempio
vedi %MKINDEX% sostituendo %MKINDEX% con %MKTITLES%

NUMBER %MOD%
Scopo Individua il resto di una divisione fra numeri interi.

Descrizione Esegue la divisione fra due numeri interi e torna il resto.
Utile per individuare se il dividendo a è esattamente divisibile per il divisore b, o per sapere se il divisore b è un multiplo esatto del dividendo a

Valore restituito valore numerico
Torna un numero intero resto della divisione;
Non viene compilato in caso di errore generico.

Vedere anche %EVAL%

NUMBER %MTOI%
Scopo converte una rappresentazione binaria

Descrizione Dato un valore in formato binario rappresentato da *s, si ottiene il corrispettivo valore numerico, tornato in un buffer %STRING%;
offset rappresenta la posizione sul buffer dalla quale iniziare a leggere il valore da convertire.

Valore restituito valore alfanumerico
Torna il valore convertito.
In caso di errore, la riga di codice non verrà compilata

Vedere anche %HEX2BIN%, %BIN2hEX%

Esempio
%MTOI%("\x03\x00\x00\x00")s

Program output
3

NUMBER %NEWDOC%
Scopo Crea il buffer e la struttura per l'inserimento di un nuovo documento

Descrizione usato per inserire un nuovo documento all'interno di una tabella (nometabella) specificata nell'archivio corrente.
In realtà viene allocato lo spazio fisico su disco, preparata la struttura e inizializzati i valori seriali (se non richiesto esplicitamente con seriali = 0) per il successivo inserimento di un nuovo documento sul database.
L'inserimento vero e proprio avviene solo all'atto del salvataggio del buffer generato con questa funzione.

Valore restituito valore numerico
Torna 1 in caso di esito positivo;
Torna 0 in caso di errore generico.

Vedere anche %SAVEDOC%, %FILLATTR%, %FILLBINATTR%

Esempio
%IF%(%NEWDOC%(%KEYVAL%("TIPOREC"), 1) == 0 )
 %ECHOON%%INCLUDE%(ERR_NEWDOC.HL")%ECHOOFF%
 %RETURN%
%ELSE%
 %REPEAT%(1,%NUMTUPLES%)
  %IF%( %FILLATTR%(%TUPLEKEY%, %TUPLEVAL%) == 0 )
   %ECHOON%%INCLUDE%("ERR_SAVEATTR.HL")%ECHOOFF%
   %RETURN%
  %ENDIF%
 %ENDREPEAT%
%ENDIF%
%IF%(%SAVEDOC% <= 0)
 %ECHOON%%INCLUDE%("NO_SAVED.HL")%ECHOOFF%
%ELSE%
 %ECHOON%%INCLUDE%(QBE.HL")
%ENDIF%

NUMBER %NEXTLINE%
Scopo legge una nuova riga sul file indicato

Descrizione Legge dal file identificato da fileid la successiva riga non vuota rispetto alla corrente posizione del descrittore attivo e la scrive in buffer.

Valore restituito valore numerico
Torna il numero dei bytes letti in caso di esito positivo;
Torna 0 in caso di errore generico o fine file.

Vedere anche %READFILE%, %OPENFILE%, %CLOSEFILE%, %WRITEFILE%

Esempio
%STRING%(buffer, "")
%NUMBER%(fileid, 0)
%NUMCPY%(fileid, %OPENFILE%("<nomecompletofile>"))
%IF%(fileid != 0)
 <SELECT name="tipo_info">
  <OPTION value=""></OPTION>
  %LOOP%
   %IF%(%NEXTLINE%(buffer, fileid) > 0)
    <OPTION value="%WRITE%(buffer)">%WRITE%(buffer)</OPTION>
   %ELSE%
    %BREAK%
   %ENDIF%
  %ENDLOOP%
 </SELECT>
%ENDIF%
%CLOSEFILE%(fileid)

Program output
prima nextline seconda nextline .... ultima nextline

NUMBER %NUMATTR%
Scopo torna l'identificativo numerico associato all'attributo e alla tabella specificati.

Descrizione Consente di recuperare il numero identificativo individuato da indicetabella e da nomeattributo.
La struttura dei database Highway è racchiusa in un array bidimensionale nel quale il primo indice (base 0) identifica la tabella di provenienza ed il secondo (base 1) è associato agli attributi che ne fanno parte.
Nell'indice 0 del secondo elemento è memorizzato l'indice identificativo della tabella di apprtenenza.
Per maggiori chiarimenti vedere l'esempio allegato.

Valore restituito valore numerico
Torna l'indice numerico di riferimento;
Torna -1 in caso di errore generico.

Vedere anche %NUMTABELLA%

Esempio
%NUMBER%(idtab, 0)
%NUMBER%(idattr, 0)
%REPEAT% (0, %TOTTAB% - 1)
 %NUMCPY%(idtab, %INDEX%)
 Tabella : %TABNAME%(idtab);
 Indice : %WRITE%(%ITOA%(%NUMTABELLA%(%TABNAME%(idtab))))<br>
 %REPEAT%(0, %TOTATTR%(idtab) - 1)
  %NUMCPY%(idattr, %INDEX%)
  Attributo : %ATTRNAME%(idtab, idattr);
  Indice : %WRITE%(%ITOA%(%NUMATTR%(idtab, %ATTRNAME%(idtab, idattr))))
 %ENDREPEAT%
%ENDREPEAT%

Program output

Tabella : TAB1	Indice : 0
Attributo : TIPOREC	Indice : 0
Attributo : TITOLO	Indice : 1
Attributo : NRECORD	Indice : 2
Attributo : ALLEGATI	Indice : 3
Attributo : ATTR4	Indice : 4
Attributo : ATTR_MI	Indice : 5
Attributo : ATTR_MF	Indice : 6

DECLARATION %NUMBER%
Scopo dichiarare una variabile di tipo numerico e inizializzarla con un determinato valore.

Descrizione Consente di dichiarare una variabile di tipo numerico inizializzandola con un determinato valore.
Una variabile può essere dichiarata ovunque ma non come argomento di una funzione (predefinita e non) o di una istruzione di controllo del flusso. La visibilità di una variabile cessa all'uscita del contesto nel quale è stata dichiarata sia esso il corpo di una funzione o la regione delimitata da una istruzione di controllo del flusso ad eccezione di %IFSYM% ed %IFNSYM%.

Esempio
%NUMBER% (totale,0)
%NUMBER% (parziale,totale)
%NUMBER% (centinaia,totale/100)

VOID %NUMCPY%
Scopo Assegna un valore numerico intero ad una variabile numerica di tipo intero.

Descrizione consente di assegnare un valore di tipo numerico intero ad una variabile dichiarata dall'utente dello stesso tipo.

Valore restituito nessuno.

Vedere anche %NUMBER%, %EVAL%, %STRCPY%

Esempio
%NUMBER%(contatore,0)
%WRITE%(%ITOA%(contatore))
%NUMCPY%(contatore, 10)
%WRITE%(%ITOA%(contatore))

Program output
0
10

NUMBER %NUMDOC%
Scopo Restituisce l'identificativo numerico del documento corrente

Descrizione Richiede ad Highway Server il numero fisico del documento corrente.
I documenti delle base dati Highway sono contrassegnati in modo univico dal valore seriale che assume l'attributo NRECORD; ma siccome questo attributo, pur essendo fortemente consigliato, non è obbligatorio che faccia parte di un database, l'identificazione, in modo univoco, di un documento all'interno di un database avviene attraverso un numero fisico progressivo che rappresenta anche l'ordine di inserimento dei documenti sulla base dati, nonchè il valore di ordinamento in caso di selezioni non ordinate per alcun valore.
Nell'ambito della modalità inserimento, il valore del numero fisico, cioè il valore di ritorno della %NUMDOC%, corrisponde a zero.

Valore restituito valore numerico
Torna il numero fisico del documento in caso di operazione eseguita correttamente.

Vedere anche %NUMDOCS%, %DELETENUMDOC%, %BLOADDOC%, %LOADDOC%

NUMBER %NUMDOCS%
Scopo ottenere il numero di documenti referenziati da una specifica chiave sull'attributo corrente

Sintassi %NUMDOCS%(%STRING% k)

Descrizione Data una specifica chiave k di vocabolario, consente di interrogare Highway Application Server sul numero di documenti referenziati.
L'interrogazione avviene in riferimento all'attributo corrente %CURDOC%.

Valore restituito valore numerico
Torna 0 in caso di errore generico o attributo non chiave.

Vedere anche %FREQ%

Esempio

NUMBER %NUMROWS%
Scopo Restituisce il numero di righe dell'attributo specificato.

Descrizione usato per conoscere il numero di righe di un attributo ("Multiriga" o "Multistanza").

Valore restituito valore numerico
Torna il numero di CR-LF + 1.

Vedere anche %ATTROWS%, %CHKROWS%

Esempio
%ATTRIB%(AUTORI)<br>
%NUMROWS%(AUTORI)<br>

Program output
Gianni Bianchi
Giulio Rossi
Mario Verdi
3

Esempio
%ATTRIB%(AUTORI)<BR>
%NUMROWS%(AUTORI)<BR>

Program output

Gianni Bianchi
Giulio Rossi
3

NUMBER %NUMTABELLA%
Scopo Determinare l'identificativo numerico della tabella specificata.

Descrizione usato per determinare l'identificativo numerico della tabella specificata calcolato in base 0.

Valore restituito valore numerico
Torna un valore > = 0 in caso di esito positivo;
Torna un valore < 0 in caso di errore.

Vedere anche %TOTTAB%, %TABLES%, %TABNAME%

NUMBER[*] %NUMTUPLES%
Scopo variabile numerica d'ambiente contenente il numero totale delle coppie chiave/valore ricevute dallo script corrente.

Descrizione variabile numerica dell'ambiente Highway Application Server contenente il numero totale delle coppie chiave/valore passate allo script corrente a seguito di una richiesta ricevuta da una form o da riga di comando

Valore restituito valore numerico
Torna un valore numerico intero in caso di esito positivo;
in caso di errore generico viene generato un errore di compilazione.

Vedere anche %TUPLEKEY%, %TUPLEVAL%

Esempio
%NUMTUPLES%<BR>
%REPEAT%(1,%NUMTUPLES%)
<B>CHIAVE:</B>'%TUPLEKEY%(%INDEX%)',<B>VALORE:</B>'%TUPLEVAL%(%INDEX%)'<BR>
%ENDREPEAT%

Program output
4
CHIAVE:CHIAVE1,VALORE:VALORE1
CHIAVE:CHIAVE2,VALORE:VALORE2
CHIAVE:CHIAVE3,VALORE:VALORE3
CHIAVE:CHIAVE4,VALORE:VALORE4

STRING %OEM2ANSI%
Scopo converte una stringa dal formato OEM (DOS) verso il formato ANSI (WINDOWS).

Descrizione consente di convertire una stringa in formato OEM (tipicamente DOS) nel formato utilizzato dai sistemi Windows.
Consente d convertire caratteri come 'à', 'è' ecc... nella loro forma normale; certi caratteri vengono elaborati dal sistema operativo in valori a 8 bit che consente di visualizzare caratteri codificati in valori inferiori a 127; le lettere accentate ed altri caratteri particolari sono memorizzate in formato ANSI che consente codifiche con valori fino a 255.

Valore restituito valore alfanumerico
Torna una stringa valorizzata in caso di conversione avvenuta correttamente.

NUMBER %OPENARC%
Scopo apre l'archivio specificato.

Descrizione apre l'archivio specificato in nomearchivio che deve indicare il percorso completo dei <file>.sts che rappresenta l'archivio Highway che si intende aprire.

Valore restituito valore numerico
Torna 1 in caso di operazione eseguita correttamente;
Torna 0 in caso di errore generico.

NUMBER %OPENDIR%
Scopo cerca all'interno di un direttorio i file e i direttori che soddisfano il percorso specificato.

Descrizione Utilizzata per leggere il direttorio indicato con percorso, che assume il valore del nome (di file o direttorio) che si intende ritrovare completo di path DOS/UNIX.
E' consentito l'uso di caratteri jolly ('*' o '?') con le stesse valenze dell'ambiente DOS/UNIX.
Se il valore in percorso, oppure se la valorizzazione della variabile stessa, avviene in chiaro, le barre separatrici in formato DOS ('\') devono essere convertite in caratteri di escape ('\\').
nomefile viene valorizzato con il nome del primo file/direttorio, se presente, che soddisfa i criteri impostati.
Il ritorno in nomefile rappresenta un percorso relativo a quanto indicato in percorso.
attributi non è attualmente implementato su tutte le piattaforme, e quindi se ne rimanda l'utilizzo ad una futura release.

Valore restituito valore numerico
Torna un identificativo da usarsi nelle successive richieste con %READDIR%() e infine con %CLOSEDIR%().
Torna 0 se non è stato trovato nessun file o direttorio idoneo.

Vedere anche %READDIR%, %CLOSEDIR%

Esempio
<!-- loop che legge i file presenti nel direttorio c:\temp -->
%STRING%(path, "c:\\temp\\*")
%STRING%(file, "")
%NUMBER%(ret, 0)
%NUMBER%(rett, 0)
%NUMCPY%(ret, %OPENDIR%(path, file))
%IF%(ret == 0)
 <!-- direttorio/file non individuato -->
%ELSE%
 %LOOP%
  %STRCPY%(file, "")
  %NUMCPY%(rett, %READDIR%(ret, file))
  %IF%(rett)
   <!-- elaborazione -->
  %ELSE%
   %BREAK%
  %ENDIF%
 %ENDLOOP%
%ENDIF%

Program output
.
..
highway.log
d6h3a.temp
d6h4f.temp
d6h61.temp
d6h6a.temp ...

NUMBER %OPENFILE%
Scopo apre un determinato file e ritorna un identificativo.

Sintassi %OPENFILE%(%STRING% nomefile [, %STRING% modo])

Descrizione utilizzata per aprire, o creare se il parametro 'modo' lo comporta, il file specificato in nomefile e per ottenere un identificativo da utilizzarsi nelle funzioni che ne fanno richiesta e per la %CLOSEFILE% al termine delle operazioni.
nomefile può essere un percorso completo o una voce dichiarata nella sezione [CGI] di <nomearchivio.ini> o nella sezione [Generico] di hicgi.ini.
Per il significato di modo consultare la documentazione relativa alla funzione fopen() della libreria C della piattaforma in uso.
modo, su piattaforma Windows, può assumere i seguenti valori:

"r"	Apre in letture. Se il file non esiste o non viene trovato, la %OPENFILE% fallisce
"w"	Apre un file vuoto in scrittura. Se il file esiste, il suo contenuto sarà distrutto
"a"	Apre in scrittura in accodamento. Non viene eliminato il carattere di EOF fino al momento in cui viene scritto qualcosa nel file. Se il file non esiste, viene creato un nuovo file.
"r+"	Apre in lettura/scrittura. Il file deve esistere.
"w+"	Apre un file vuoto in lettura/scrittura. Se il file esiste, il suo contennuto andrà distrutto.
"a+"	Apre in lettura e in scrittura in accodamento. La scrittura nel file rimuove il carattere di EOF, che viene ripristinato al salvataggio delle operazioni. Se il file non esiste, ne viene creato uno nuovo.

Se nomefile non viene risolto, Highway Application Server esegue un tentativo di risoluzione cercando all'interno del file di profilo.
Se anche questo non risolve nomefile, Highway Application Server verifica il primo carattere: se è "/" (oppure "\" in NT e non è indicata la lettera di drive) allora viene eseguito un ulteriore tentativo di risoluzione rispetto al direttorio dello script corrente.

Valore restituito valore numerico
Trona un identificativo numerico se operazione eseguita con successo;
Torna 0 in caso di errore generico.

Vedere anche %CLOSEDIR%, %CLOSEFILE%, %CREATEFILE%, %DELEFILE%, %FILEDATE%, %FILESIZE%, %GETPROFILE%, %GETTEMPFILENAME%, %LOCKFILE%, %NEXTLINE%, %OPENDIR%, %PROFILE%, %READDIR%, %READFILE%, %RENFILE%, %TEMPDIR%, %WRITE%, %WRITEFILE%, %WRITELINE%, %WRITEPROFILE%

VOID %OUTPUTTO%
Scopo redirige l'uscita di %WRITE% sul file identificato da filehandle.

Descrizione Consente di utilizzare un file come canale di output nell'utilizzo della %WRITE%.
Di norma %WRITE% scrive la risposta che verrà trasmessa dal server HTTP al chiamante (anche se l'ECHO e stato inibito con %ECHOOFF%).
Se l'argomento di questa funzione è un handle di file valido (avuto con %OPENFILE% o %CREATEFILE%), %WRITE% scrive sul file in questione e produce lo stesso effetto di %WRITEFILE% su filehandle.
La chiusura (%CLOSEFILE%) del file o una chiamata ad %OUTPUTTO% con argomento 0 ripristina il normale comportamento di %WRITE%.

Valore restituito nessuno.

Vedere anche %WRITE%

Esempio
%STRING%(filename, "")
%IF%(%GETTEMPFILENAME%(filename, ".txt"))
 %NUMBER%(filehandle, %OPENFILE%(filename, "a"))
 %OUTPUTTO%(filehandle)
 %WRITE%("Scrive su un file di log.")
 %CLOSEFILE%(filehandle)
%ENDIF%
%WRITE%("Scrive sulla pagina html in composizione")

STRING %PARSE%
Scopo interpreta il valore alfanumerco passato come parametro.

Descrizione Highway Application Server interpreta stringa risolvendo le eventuali istruzioni memorizzate nel parametro;
keychr è un parametro opzionale che indica il carattere separatore delle eventuali parti da interpretare.
Se non indicato s'intende il carattere separatore di default ('%').

Valore restituito valore alfanumerico
Torna una stringa con il contenuto dell'interpretazione eseguita in caso di operazione eseguita correttamente;
Torna un errore di compilazione in caso di errore generico.

Vedere anche %QSTRING%, %STR2HTML%, %MASK%

Esempio
%PARSE%("L'Attributo %ATTRNAME%(0,4) contiene %ATTRIB%(%ATTRNAME%(0,4))")

Program output
L'Attributo ATTR1 contiene VALORE1

STRING %PARENT%
Scopo primo termine di una relazione gerarchica in una pagina di Thesaurus.

Descrizione usato per determinare il primo termine di una relazione gerarchica in una pagina di Thesaurus.
riga indica il termine di riferimento per il quale si intende risalire fino al termine padre della catena gerarchica.

Valore restituito valore alfanumerico
Torna il termine padre della gerarchia di riferimento;
Torna stringa vuota in caso di errore generico.

Vedere anche %CHILD%

NUMBER %PCLOSE%
Scopo Attende che il ritorno del processo generato con %POPEN% termini per chiudere il flusso dei valori di ritorno.

Descrizione Dopo l'esecuzione di un comando che prevede la scrittura sullo standard output (come ad esempio potrebbe essere un DIR) tramite la %POPEN%, %PCLOSE% chiude il flusso di dati che la suddetta operazione ha generato.

Valore restituito valore numerico
Torna 1 in caso di operazione eseguita correttamente;
Torna -1 in caso di errore generico.

Vedere anche %POPEN%

NUMBER %PERGROUP%
Scopo Variabile numerica di ambiente contenente il numero di immagini facenti parte del gruppo specificato.

Descrizione utilizzato per determinare il numero di immagini che fanno parte del gruppo indicato in numerogruppo relativamente al documento corrente.

Valore restituito valore numerico
Torna un valore numerico intero in caso di operazione eseguita correttemante.

Vedere anche %GROUPS%, %CURGRP%

NUMBER %PERPAGE%
Scopo Variabile numerica di ambiente che contiene il numero massimo di documenti rappresentabili all'interno di una pagina di titoli.

Descrizione utilizzato per determinare quale è il numero massimo di titoli rappresentabili all'interno di una pagina.
Questo valore è di norma indicato nella sezione [CGI] del <nomearchivio>.ini (per personalizzazioni che riguradano i singoli archivi) oppure nella sezione [Generico] di Hicgi.ini (per impostazioni a livello di server).

Valore restituito valore numerico
Torna un valore numerico intero superiore a zero in caso di operazione eseguita correttamente.

Vedere anche %MAXBITEMS%, %MAXTHUMBS%, %MAXvITEMS%

Esempio
%REPEAT%(1, %PERPAGE%)
 %DOCTITLE%(%INDEX%)
%ENDREPEAT%

NUMBER %PID%
Scopo variabile numerica di ambiente che rappresenta l'identificativo univoco del processo Highway Application Server in corso.

Descrizione Richiede ad Highway Application Server il numero identificativo del processo nel quale è eseguito.

Valore restituito valore numerico
Torna un valore numerico intero in caso di successo;
Torna -1 in caso di errore generico.