Oxygen Basic

Programming => Bugs & Feature Requests => Topic started by: Nicola on December 25, 2020, 01:22:35 AM

Title: Info
Post by: Nicola on December 25, 2020, 01:22:35 AM

Hi,
Where can I find explanations on the various .inc files present in the Includes?
And explanations relating to the three projects?
Thanks.
  :)

Title: Re: Info
Post by: Charles Pegge on January 06, 2021, 11:46:07 AM

Hi Nicola,

ProjectsA: O2 frameworks, complex examples

ProjectsB: External libraries and user contributions

ProjectsC: Languages

Title: Re: Info
Post by: Nicola on January 06, 2021, 01:15:58 PM

Thanks Charles  :)


I was looking at the o2 help and I have not found information about some things.
Under classes are missing link to
...
objects,
oop,
pure.

Title: Re: Info
Post by: Charles Pegge on January 07, 2021, 03:56:24 AM

Hi Nicola,

These are not specific to O2 but in brief:

objects: variables  which have a class type

oop: Object Oriented Programming: variables have both members  and functions.

pure: C++ term for functions in a virtual interface

Title: Re: Info
Post by: Nicola on January 07, 2021, 01:24:23 PM

thanks. :)

Also for these other items there are no references in help.

string2
gstr_
global

Title: Re: Info
Post by: JRS on January 07, 2021, 06:18:54 PM

I highly recommend expanding on Jose Roca's O2 documentation effort.

I will have the files in the sandbox when Charles releases source for self compile. I would be happy to update them with member contributions to the documentation effort.

Title: Re: Info
Post by: Charles Pegge on January 09, 2021, 03:34:49 AM

Thanks Nicola,

I'll edit these in the manual database: inf/o2keyw.dat. this is used to construct oxygen_help.chm

string2: replaced by wstring
gstr_: internal use
global: shared variables, now deprecated

Title: Re: Info
Post by: Nicola on January 11, 2021, 07:56:24 AM

Thanks Charles.
 :)

Title: Re: Info
Post by: Nicola on January 13, 2021, 12:31:40 AM

Hi Charles,
I have other requests.
ALIAS is too sparse as documentation.
LINK, AT, PURE, OOP, OBJECTS, are not documented.
(please write a full explanation  :))
Thanks

Title: Re: Info
Post by: Charles Pegge on January 15, 2021, 01:31:15 AM

Hi Nicola,

Alias and Link are secondary keywords which only make sense in the context of declaring external library functions. Similarly At, Pure and Objects. So I need to gather all the secondary words and deal with them under each principal topic in the manual. It will take some time.

Title: Re: Info
Post by: Nicola on January 15, 2021, 07:34:19 AM

Ok Charles,
if you want and can, you could start with ALIAS. Maybe you could add a small example with the line-by-line comments of the commands / functions you use.

I am working on cherrytree.
I attach the file that I am filling taking the data from your help ... and if you give me other information I will go to add them ...

Hello ;)


I am using this program
https://portableapps.com/apps/office/cherrytree-portable

Updated February 9, 2021

Title: Re: Info
Post by: Charles Pegge on January 15, 2021, 09:13:23 AM

ALIAS is not a required keyword in O2, but it is understood:

some useful links:

http://manmrk.net/tutorials/basic/PowerBASIC/pbcc/declare_statement.htm

https://docs.microsoft.com/en-us/dotnet/visual-basic/language-reference/statements/alias-clause

BTW
ProjectsA\ManualGenerator\ManualCreate.o2bas generates HTML pages for the o2 manual.

Title: Re: Info
Post by: JRS on January 15, 2021, 06:27:19 PM

Quote

I am working on cherrytree.

Do you have a UI for this SQLite DB?

Title: Re: Info
Post by: Nicola on January 16, 2021, 09:25:34 AM

Yes,
I am using this program
https://portableapps.com/apps/office/cherrytree-portable

What do you think?

Title: Re: Info
Post by: Nicola on February 09, 2021, 01:35:44 AM

Hi,
Charles, I wanted to ask you, is there any difference between zstring, char, bstr, bstring, cstr_, string and asciiz?
Also, is there any difference between wbstring, wchar, wstring and wzstring?
Thank you

Title: Re: Info
Post by: Charles Pegge on February 09, 2021, 04:27:11 AM

Hi Nicola,

char and zstring are both null-terminated strings with 8bit characters. wchar and wzstring are null-terminated strings with 16bit characters. They are the same as the char types used in Windows.

bstring and wbstring are likewise windows OLE/BSTR strings.

string and wstring are oxygen-native strings based on the above. But they have automatic garbage collection.

You can use strings as char* parameters in Windows API calls. The compiler will sort it :)

Title: Re: Info
Post by: Nicola on February 09, 2021, 05:02:27 AM

Thanks Charles.

(I'm Nicola) :D

Title: Re: Info
Post by: Charles Pegge on February 09, 2021, 05:15:52 AM

Apologies!  :-[

We have 2 women here, a considerable rarity for a Basic forum.

Title: Re: Info
Post by: Nicola on February 10, 2021, 12:57:03 AM

My wife hates the PC because she sees it as a competitor to my relationship with her.
 ;D ;D

Title: Re: Info
Post by: Nicola on February 10, 2021, 01:44:38 AM

Hi Charles.
To sum up on strings, is it okay as I reported in this picture?

Also could you tell me the use of WIDE?

ANY can be used for both numbers and strings?

Title: Re: Info
Post by: Charles Pegge on February 11, 2021, 03:03:24 AM

Hi Nicola,

Wide chars are for Unicode. There are some demos in examples\WideChars\

Any* does the same as void* in C, passing the address of any type (by reference)