

	UDAECHO.EXE 1.1.00 - By UDA'Software Copyright 1999, Inc
Attenzione, sintassi errata ! E' necessario passare almeno un parametro.

 Per utilizzare qusto programma e' necessario rispettare la seguente sintassi:

	 udaecho <stringa> [-n#] [-s]

 <stringa> puo' contenere una delle seguenti "Parole Chiave" (case-sensitive):

   _riga_vuota$    -> Aggiunge una Riga Vuota
   _user_input$    -> Aggiunge una Stringa introdotta dall'utente (runtime)
   _user_word$     -> Aggiunge una Parola introdotta dall'utente (runtime)
   _udaecho_path$  -> Aggiunge il Percorso di udaecho

 -n# - Numero di ripetizioni dell'output; ex: -n5

 -s  - Dirige l'output alla shell dei comandi anziche' lo stdout

 Sostituendo il carattere finale  $  delle Parole Chiave con  !  e' possibile
stampare se stesse (ex: _riga_vuota! diventa _riga_vuota$).


******************************************************************************

 UDAEcho serve per stampare una Stringa Alfanumerica sullo Standard Output
(che, normalmente, e' lo Schermo).

 Il primo parametro deve essere necessariamente la Stringa Alfanumerica che si
vuole stampare, la quale, puo' anche contenere una delle Parole Chiave citate
sopra.

 Tramite l'opzione -n e' possibile specificare quante volte la Stringa
Alfanumerica deve essere stampata ripetutamente mentre, aggiungendo l'opzione
-s, si dirige l'output del programma alla Shell dei Comandi anziche' lo
Standard Output.

 Anche se per default il programma emette l'output sullo schermo, l'utilita'
piu' evidente del programma e' data dalla possibilita', tramite il meccanismo
di redirezione offerto dal Sistema Operativo (sia esso DOS o Linux), di
inviarlo ad un file.

 Il programma e' case-sensitive quindi e' necessario introdurre le Parole
Chiave, qualora ce ne sia bisogno, in minuscolo.

 Per default il programma ritorna un ERRORLEVEL = 0 se tutto e' andato a buon
fine, altrimenti, 1 se ha fallito l'esecuzione; nel caso si specifichi
l'opzione -s verra' ritornato l'ERRORLEVEL del comando eseguito nella shell.


******************************************************************************

 Per facilitare la comprensione delle potenzialita' del programma si possono
prendere in esame i seguenti esempi:

______________________________________________________________________________
(1) Si supponga di dover elaborare un certo numero di files contenuti in una
determinata directory tramite un opportuno software di
nome: mioprogramma.exe .
 Si supponga anche che questo programma (mioprogramma.exe, appunto), una volta
lanciato, attenda 2 input e precisamente:

   a) Il nome di un file (ad esempio: miofile.dat)
   b) L'immissione di un numero corrispondente ad una scelta del menu offerto
     dal programma stesso (ad esempio: 4 - Stampa su file) che permetta di
     Stampare in qualche modo il file indicato in precedenza.

 Per fare questo si potrebbe inserire in un file cio' che l'utente dovrebbe
digitare sulla tastiera e, tramite un'operazione di pipe (opportunita' offerta
dai Sistemi Operativi a "riga di comando" - DOS, Linux, UNIX, ecc... - che
permette l'Invio dell'Output di un programma nell'Input di un altro), inviarlo
al programma di elaborazione (che in questo caso e' mioprogramma.exe) con
una sintassi simile alla seguente:

   type miofileparametri.par | mioprogramma.exe

oppure

   mioprogramma < miofileparametri.par

 Il file 'miofileparametri.par' dovrebbe contenere le seguenti righe:

  miofile.dat

  4


 NB: Gli spazi tra una riga e l'altra vengono interpretati dal programma
ricevente come la pressione del tasto Invio.

 Per evitare di dover creare 'miofileparametri.par' e' possibile utilizzare
udaecho tramite la seguente sintassi:

  udaecho "mioprogramma.exe<miofile.dat_riga_vuota$4_riga_vuota$" -s

che in un ipotetico file batch (o Script) che "generalizzi" l'esecuzione del
comando puo' diventare:

  udaecho "%1<%2_riga_vuota$%3_riga_vuota$" -s

se si tratta di un file .BAT del DOS, oppure:

  udaecho "$1<$2_riga_vuota$$3_riga_vuota$" -s

se si tratta di un file Script Linux (o UNIX).

______________________________________________________________________________
(2) Si supponga di dover lanciare un file batch (o script) che ha il compito
di creare una nuova directory in quella corrente e che sia l'utente a dover
stabilire il nome di quest'ultima; una possibile soluzione puo' essere questa:

  udaecho "mkdir _udaecho_path$\_user_input$" -s

______________________________________________________________________________
(3) Si supponga di dover creare un File Script (si tratta di un file contenete
una serie di Istruzioni e/o Comandi (uno per ogni riga) che possono essere
eseguiti da quei programmi che offrono questa possibilita', come ad esempio, i
sistemi CAD) contenente le seguenti righe:
____________________________
open c:\miadirectory\miofile
print

format
A4

plot

____________________________

 Si potrebbe quindi utilizzare udaecho in questo modo all'interno di un file
batch (miobatch.bat):

  udaecho "open %1_riga_vuota$print_riga_vuota$_riga_vuota$format_riga_vuota$A
  4_riga_vuota$_riga_vuota$plot_riga_vuota$">mioscript.scr
______________________________________________________________________________
(4) Si supponga di volere creare un file contenente una Stringa Alfanumerica
immessa dall'utente:

  udaecho _user_input$>miofile.txt

 Nel caso si utilizzi la parola chiave '_user_word$' l'input dell'utente
verra' troncato alla prima parola (il carattere spazio delimita le parole).

******************************************************************************

 Il programma e' distribuito con il Sorgente (udaecho.cc) in modo tale che
chiunque possa modificarlo adattandolo alle proprie esigenze.

 Per qualsiasi problema riguardante udaecho si invita a contattare tramite
E-mail la UDA'Software al seguente indirizzo:

  uda@uda.itgo.com
  uda@freemail.it


UDA'Software 7 Aprile 1999
http://uda.itgo.com
http://www.GeoCities.com/SiliconValley/Bay/2165
