Funzioni di libreria: funzioni di sistema

Le funzioni di questa categoria comprendono alcune funzioni per interfacciarsi con l'ambiente esterno al programma Proteus.

Le funzioni sono:

GETENV(cLabel)

restituisce la stringa associata a cLabel nell'ambiente, una stringa vuota se cLabel non è definita nell'ambiente

PUTENV(cLabel, cVal)

aggiorna la stringa associata a cLabel con cVal; ritorna 0 se lo spazio ambiente è esaurito, 1 altrimenti.
N.B. Questa funzione, se chiamata ripetutamente, causa la perdita di memoria a causa dell'implementazione a basso livello della funzione della libreria C putenv; ciò vale sotto Unix™ - il problema non sussiste, tuttavia, nella versione Windows™/Ms-Dos™

ARGV(n)

restituisce l'n-esimo parametro sulla linea di comando:

DATE()

ritorna la data corrente di sistema, formattata in base a DATE_TYPE

TIME()

ritorna l'ora corrente di sistema, formattata in base a TIME_TYPE

ISTIME(c)

ritorna 1 se c è nel formato "hh:mm:ssx", dove mm e ss vanno da 0 a 59, hh va da 1 a 12 (se x è 'p' o 'a') oppure da 0 a 23 (se x è uno spazio); ritorna 0 altrimenti

TIMETOSEC(c)

ritorna il numero di secondi nell'ora c; si veda ISTIME per il formato dell'ora accettato; se l'ora non è valida ritorna -1

TIMEFROMSEC(nSeconds)

ritorna l'ora corrispondente a nSeconds, formattata in base a TIME_TYPE; nSeconds può anche eccedere il numero di secondi in un giorno; ritorna una stringa vuota se nSeconds è negativo

CLOCK()

numero di secondi trascorsi dall'inizio dell'esecuzione dell'interprete Proteus

SLEEP(nfSeconds)

sospende l'esecuzione dello script per nfSeconds secondi; ritorna il numero di secondi trascorsi (al termine della chiamata) dall'avvio dell'interprete Proteus. La funzione accetta anche valori in virgola mobile; es. SLEEP(0.5) sospende l'esecuzione per mezzo secondo

SYSTEM(cCommand)

esegue cCommand e ritorna il livello di errore all'uscita; utilizzare:

SYSTEM("COMMAND /C comando")

oppure

SYSTEM("cmd /C comando")

per eseguire comandi interni di Ms-Dos™/Windows™; nota: eventuali parametri relativi a nomi di file contenuti all'interno di cCommand non sono alterati dal parametro sulla linea di comando -k

CAPTURE(cCommand, cStdout[, cStderr[, cStdin]])

esegue cCommand e ritorna il livello di errore all'uscita, come SYSTEM; permette, tuttavia, di indicare due variabili destinazione per l'input e l'output standard del programma eseguito ed una stringa di caratteri  da utilizzare come ingresso standard; cStdout e cStderr sono modificate per riferimento (quindi devono essere due variabili); cStdin può essere una variabile o una costante

EXEC(cCommand)

esegue cCommand e termina il programma Proteus; utilizzare:

EXEC("COMMAND /C comando")

oppure

EXEC("cmd /C comando")

per eseguire comandi interni di Ms-Dos™/Windows™; nota: eventuali parametri relativi a nomi di file contenuti all'interno di cCommand non sono alterati dal parametro sulla linea di comando -k

Inizio pagina Prossimo argomento Argomento precedente Indice per argomenti Indice analitico