S2Util

S2Util è una libreria REXX richiamabile di funzioni generali.

Le funzioni sono:

• S2WordSplit: Analizza una stringa e la separa in parole in base agli spazi vuoti ma contando le stringhe come singole parole. Le parole sono inserite negli elementi radice di un array tipico REXX (STEM.0 immagazzina il numero delle parole mentre le variabili da STEM.1 a STEM.n immagazzinano le parole).
• S2ParseArgs: Analizza una stringa argomento. Oltre all'analisi e all'individuazione delle parole, gli argomenti sono preceduti da un dash o da uno slash e consistono di tutto ciò che risulta fino alla successiva parola con un dash o uno slash. Il valore "value" dell'argomento è qualcosa dopo uno spazio, due punti o un segno uguale. Gli argomenti, oltre ad essere listati nell'array sono associati nella stessa radice come STEM.arg=argvalue (es. per l'argomento /FOO=BAR, STEM.FOO avrà il valore "value" BAR). Notare che se viene passato un'argomento numerico diverso da zero (es. /1=2), sarà impostato il valore "value" (es. STEM.1=2), ma se viene passato come argomento 0 (es. /0=asd), il conteggio "count" verrà sovrascritto. STEM.0 riporterà sempre il numero degli argomenti.
• S2Version: Nuova nella v2.0, questa funzione (che in realtà avrebbe dovuto essere già presente) ritorna una stringa con il numero di versione, uno spazio vuoto e i contatti dettagliati dell'autore (nome, indirizzo email, url del sito web).
• S2GetHAB: Nuova nella v2.0, questa funzione consente ad un programma del Presentation Manager di trovare l'Anchor Block Handle (HAB) quando viene fornito un Window Handle (HWND; a parte il nome potenzialmente fuorviante, tutti gli oggetti PM hanno un HWND). Un HAB può essere usato con S2GetResStr ed anche con le funzioni clipboard, ShutdownSystem e simili, comunque, S2GetResStr è la sola funzione disponibile per ora.
• S2GetResStr: Ritorna una stringa da una risorsa. Si passa come argomento un HAB, un HMODULE (modulo handle; 0 per accedere direttamente all'EXE), ed un identificativo numerico ID (come specificato nel file .RC) e viene restituita la stringa. La lunghezza massima è di 255 caratteri.
• S2MakeClipboardViewer: Passando un HWND a questa funzione, l'oggetto verrà inserito nella Clipboard. Questo significa semplicemente che OS/2 avviserà quell'oggetto ogni volta che cambia la clipboard.