Watch, Follow, &
Connect with Us

Welcome, Guest
Guest Settings
Help

Thread: C++ VCL documenttaion



Permlink Replies: 2 - Last Post: Mar 14, 2016 10:12 AM Last Post By: Remy Lebeau (Te... Threads: [ Previous | Next ]
Dan Ambrose

Posts: 87
Registered: 12/11/03
C++ VCL documenttaion
Click to report abuse...   Click to reply to this thread Reply
  Posted: Mar 13, 2016 9:58 AM
I'm a C++ programmer. I'm using Borland C++ XE5. I've been using Borland C/C++ products since the 1980s. I don't use Delphi and I'm not fluent in Delphi.

I'm trying not to post stupid questions on the forums - If I can find the answer in the documentation.

I'm having allot trouble finding the documentation for C++ items. The problem is often search results return Delphi info. Not C++.

Is there some way to hide the Delphi documentation ?

I have allot of experience with the C/C++ language. My productivity bottleneck is finding out the C++ API for VCL and many other C runtime routines.

Here is an example. I'm trying to learn about UnicodeString so I can use it. I want to look at its member functions and then all the base class functions -

(If UnicodeString is not part of the VCL then please excuse my parlance )

When I use the F1 help for UnicodeString I get 4 results -

Enabling applications for Unicode
String types (Delphi)
Unicode in Radstudio
System..Unicode

None of these tell me the member functions and inheritance hierarchy - Wait ... I might not be using the parlance ... methods, properties.
And that is another issue .. When you do find C++ documentation its always Delphi parlance ...methods, properties.

I know the VCL is written in Delphi. But is there any documentation for C++ that will show me the C++ api in terms used by C++ ?

Is all the C++ documentation for the VCL made to use Delphi parlance because it is written in Delphi ?

Here is another example. The STD container class library. Like list. That has been in Borland products for 20 years. Where is the C++ documentation for it?

Dan
St Louis, MO

Alex Belo

Posts: 497
Registered: 10/8/06
Re: C++ VCL documenttaion
Click to report abuse...   Click to reply to this thread Reply
  Posted: Mar 13, 2016 10:14 AM   in response to: Dan Ambrose in response to: Dan Ambrose
Dan Ambrose wrote:

The STD container class library. Like list.
...
Where is the C++ documentation for it?

I recommend

http://www.cplusplus.com/reference/list/list/

1) the very best descriptions
2) very illustrative examples
3) online compiler+evaluator of examples

--
Alex
Remy Lebeau (Te...


Posts: 8,201
Registered: 12/23/01
Re: C++ VCL documenttaion
Click to report abuse...   Click to reply to this thread Reply
  Posted: Mar 14, 2016 10:12 AM   in response to: Dan Ambrose in response to: Dan Ambrose
Dan wrote:

Is there some way to hide the Delphi documentation ?

No.

I have allot of experience with the C/C++ language. My productivity
bottleneck is finding out the C++ API for VCL and many other C runtime
routines.

The RTL/VCL is exactly the same for Delphi and C++.

For things related to the C/C++ language itself, or the STL, you are better
off with third-party documentation, such as http://www.cppreference.com.

Here is an example. I'm trying to learn about UnicodeString so I can
use it. I want to look at its member functions and then all the base
class functions -

Have you tried simply typing UnicodeString into the documentation search
box? Or placing the cursor on a UnicodeString variable and pressing F1?

If UnicodeString is not part of the VCL then please excuse my
parlance

Yes, it is. Well, the RTL anyway, since UnicodeString is not specific to
VCL, as it is also used by FireMonkey.

And that is another issue .. When you do find C++ documentation its
always Delphi parlance ...methods, properties.

They apply to both Delphi and C++, since both languages share a common RTL.
In the case of C++, certain types that are built-in to the Delphi language,
like UnicodeString, are exposed in C++ as classes instead.

I know the VCL is written in Delphi. But is there any documentation
for C++ that will show me the C++ api in terms used by C++ ?

Typically, most RTL items in the documentation provide both Delphi and C++
references.

Is all the C++ documentation for the VCL made to use Delphi parlance
because it is written in Delphi ?

Primarily, yes. But there are C++ considerations as well.

Here is another example. The STD container class library. Like list.
That has been in Borland products for 20 years. Where is the C++
documentation for it?

The STL is not part of Embarcadero's RTL. It is, and always has been, a
third-party bundled item. First, it was provided by RogueWave, then later
by STLPort, and more recently by Dinkumware. You need to refer to third-party
documentation for STL references. Since the STL is standardized by the C++
specification, generic sites like http://www.cplusplus.com and http://www.cppreference.com
offer adequate documentation. Or, you can refer to the specific vendors'
own documentations.

--
Remy Lebeau (TeamB)
Legend
Helpful Answer (5 pts)
Correct Answer (10 pts)

Server Response from: ETNAJIVE02