Short:    shared GUI lib 
Author:   lorylombus@gmail.com (Lorence Lombardo)
Uploader: lorylombus@gmail.com (Lorence Lombardo)
Type:     dev/gui
Version:  2.0
Architecture: m68k-amigaos

rc  Saturday 16-Dec-23 05:02:42

Standard disclaimer:-  

If you decide to use this library you do so at your own risk.


"ragmcc.library"  (c) 2023  Lorence Lombardo.

The ragmcc library is my attempt to make some MUI more accessible
using the ReadArgs syntax supported by the "Readargsgroup.mcc".
The docu-examples have been divided into 2 main components, ragui
and str_tst. "ragui" is not only just an example but a useful script
tool, a tool to assist in the design of inbuilt gui's and a significant
update to "ReadArgsGUI" with 3 more CLI arguments. It is suggested that
you place "ragui" to somewhere pathed such as your c: assign.
Of coarse the library should be placed in your libs: assign.

"ragui" comes with 2 real functional script examples for the
executable file packer "bgpk" in the scripts directory.

Library functions:-

Gadwin(temp,tit,scr,rarg,darg)
   This function is MUI and `Readargsgroup.mcc' all wrapped into one.
   The return codes are explained in "ragui".
   Arguments:-
   temp - The ReadArgs like template with gadget prefix's.
   tit  - The window title.
   scr  - The screen address.
   rarg - The result argument string after your selection.
   darg - The default argument settings to the template.

Numargs(ptr)
   This function was intended for processing the result argument string.
   It obtains the number of up to 128 arguments in a string and stores
   them into an array. If the pointer is zero then arguments will be
   gathered from CLI. A -1 return is given for an unquoted question with
   no other arguments. This function is explained in "str_tst".

Sarg(n)
   Obtains the argument number as a string from the above array.

Varg(n)
   Obtains the argument number as a value from the above array.

Trimlead(src,chn)
   removes all leading occurrences of the ASCII chn # in src
   Returns the number of characters removed.

Trimtrail(src,chn)
   removes all trailing occurrences of the ASCII chn # in src
   Returns the new length.

Trimargs(ptr)
   removes all gadget prefix's from the result argument string.
   This function can be regarded as "Numargs" and much more.
   _FN_'s are now more usable in DOS scripts because of
   this function. In v2 additional underscores are also trimmed
   and the initial number of arguments is returned. The arguments
   stored in the array remain unchanged.

Pubfront(name)
   Fronts a public screen by name and returns its address.

Reps(src,find,rep)
   Replaces occurrences of find with rep in src.
   The new length will be returned.

Isqn()
   Returns 1 if there was an unquoted question in the last Numargs.


Currently example usage is provided for E, Blitz, C, HB2, PB4, ACE
and DOS scripts.


related URL's:-
http://aminet.net/package/dev/mui/MCC_Readargsgr
http://aminet.net/package/util/libs/mui38usr
http://geocities.ws/lorylomb/bgpk.txt
http://geocities.ws/lorylomb/bgpk.lha
http://geocities.ws/lorylomb/bgpk_news.txt
http://geocities.ws/lorylomb/