Release date: 
Sunday, 10 February, 2002




Authors/Port authors:

S2Util is a REXX callable library of general functions.

The functions are:

  • S2WordSplit: Parse a string and split it into words on blank spaces, but counting quoted strings as single words. Words are put into elements of a REXX array-like stem (STEM.0 has the number of words, and STEM.1-STEM.n have the words).
  • S2ParseArgs: Parse an argument string. As well as parsing words and noticing quotes, arguments are preceded by a dash or slash, and consist of everything up to the next word with a dash or slash. The "value" of the argument is anything after a space, colon, or equals sign. Arguments, as well as being listed in the array, are hashed into the same stem as STEM.arg=argvalue (eg for the argument /FOO=BAR, STEM.FOO will have the value BAR). Note that if a nonzero numeric argument is passed (eg /1=2), then the "value" will be set (eg STEM.1=2), but if the argument 0 is passed (eg /0=asd), the "count" will override. STEM.0 will always hold the number of arguments.
  • S2Version: New in v2.0, this function (which really should have been there from the start) returns a string with the version number, a blank space, and then author's contact details (name, email address, web site url).
  • S2GetHAB: New in v2.0, this function allows a Presentation Manager program to find out the Anchor Block Handle (HAB) when given a Window Handle (HWND; despite the potentially misleading name, all PM objects have HWNDs). A HAB can be used with S2GetResStr and also clipboard functions, ShutdownSystem, and similar, although S2GetResStr is the only one available now.
  • S2GetResStr: Get a string from a resource. Pass a HAB, a HMODULE (module handle; 0 to access own EXE), and a numeric ID (as specified in the .RC file), and the string is returned. Maximum length 255 characters - not sure how to overcome this.
  • S2MakeClipboardViewer: Pass this function a HWND and it makes that object into a Clipboard Viewer. This means, simply, that OS/2 will notify that object every time the clipboard is changed.
This software is distributed as compressed package. You have to download and manually install it; if prerequisites are required, you will have to manually install them too.

Manual installation

Program is distributed as ZIP package: download to temporary directory and unpack to destination folder. See below for download link(s).

Following ones are the download links for manual installation:

Record updated last time on: 16/07/2022 - 11:05

Translate to...

Add new comment