Multiple Input

Bundle 'auto' Mode

In addition to the standard info from Program.Info, these items were added :

Key	Description	example
PkgName	The app's android Package Name	e.g "com.rfo.hbasic"
SysPathC	The full canonical path of app's private directory in internal storage. This area was mainly for internal use only, although the app has (almost) full access here. This is Primary Internal Private Storage.	e.g "/data/data/com.rfo.hasic"
BasePath	The app's base path in External Storage. This is where most commands can operate with full access and is where hBasic is scoped. This is Primary External Private Storage In the standard app, this can be changed via the Editor menu: Preferences > Base Drive.	(Also known as the Base Drive) e.g "/storage/emulated/0/Android/data/ com.rfo.hbasic"
App_Path	The main app directory after BasePath. It is the directory above source, data and databases. Historically it is mis-named as a 'path', when in fact it is just the app's main directory name.	e.g "rfo-basic"
LibPath	The full canonical path to where android puts native libraries. Since api 29, this is the only area where you are allowed to execute libraries or native executables.	e.g /data/app/<something>/lib/arm

Some of these added info keys will return absolute paths.
Basic FILE commands were orginally designed for relative paths (from data/),
since v4.38, FILE commands will also accept absolute file paths beginning with a '/'.
But be aware that threre are many areas where your app will not have permission to access.

The above additions are mostly for advanced operations such as using the SYSTEM shell, special areas and/or native libraries access.

This code prints the app's package name.
e.g

PROGRAM.INFO b
BUNDLE.GET b , "PkgName", name$
PRINT name$

com.rfo.hbasic

 Note that FILE.root is the combination of BasePath, App_Path and "/data".

DEBUG.DUMP.FN {level_nexp}

Prints the function name from the function stack.
where

level is the optional maximum level (default is 1)

1 - print only the last level (current function)
2 - print two levels (last + previous caller)
..etc...
0 - print all levels

INPUT {prompt_sexp}, result_nvar {,{default_exp}{,canceled_nvar}}{,extraFlags_nexp}

An optional extraFlags at the end of INPUT was added.
If this flag is 1, input is constrained to a single line.

Default is 0 = off.

Due to privacy issues, the clipboard has not been working since Android 10 so the code was upgraded (v4.60+).

Note that your app needs to be in focus in order to access the clipboard.

Even so, the clipboard is still unreliable for some devices / brands of phone.
It is recommended to insert a pause before getting from the clipboard;
e.g

PAUSE 100
CLIPBOARD.GET s$                    % get data from clipboard

print "input>";s$
r$=replace$(s$,"Hello","Goodbye")   % change it
print "output>";r$

if r$<>"" then CLIPBOARD.PUT r$     % put it back

NOTIFY.STATUS  <last_status_nvar>
NOTIFY.CANCEL

If the NOTIFY command is used with a 'wait' flag   e.g NOTIFY t$, s$, a$,1
the program waits until the notification is tapped, dismissed or system continued  (e.g backKey).

NOTIFY.STATUS will return the status of the last notification.
where last_status_nvar will be filled with;

0 = no wait (last NOTIFY was not waiting)
1 = system continued (e.g backkey)   notification not removed.
2 = tapped (user tapped notification)
3 = dismissed (user slides notification)
4 = cancelled (by NOTIFY.CANCEL)

NOTIFY.CANCEL will remove the notification.

e.g

NOTIFY "Title", "subTitle", "alert msg",1

NOTIFY.STATUS last_status
IF last_status = 2 THEN informed = 1    % tapped
IF last_status = 1 THEN NOTIFY.CANCEL   % continued

Note that notifications are always removed on program exit.
This command requires the permission POST_NOTIFICATIONS or else it will not display.
NOTIFY sub commands are used in the sample program h08_notify.bas.