C++Introduction to C++Language FeatureLearn C++

Quickly Learn To Use Variables Between Units In C++ Builder

In C++ Builder, we can create many Units to run different modules with different Form designs in Windows. A unit is a separately compiled module of C++ Builder code. Every form has its unit, and most components (or groups of related components) have their units as well. A Unit shaped with two files,

  • Header file (<unit name>.hpp) , it is used to define classes, components, variables and to define some function definitions.
  • Implementation file (<unit name>.cpp) It is used to define sub-functions, a main program with a header.

We can use properties of components as a variable that they are defined in units. Here we explained well about Using Variables in C++ Programming Language (link will be added later). We can define global variables or local variables in each unit. We can define private, public or __published variables in classes too.

In this post, we will learn how to interact with variables in two units. To learn this;

1. Let’s create a new C++ Builder VCL Application and save all project and unit.
2. Add a Button and an Edit box by dragging from the Palette. Now let’s examine what happened in our auto-generated codes. Cpp File (Implementation File) is like this,

cpp file will have <vcl.h> library included and “Unit1.h”. It will have a TForm1 procedure which is used on form generation.

If we look at Unit1.h file we will see our Button1 and Edit1 components are defined as pointers automatically in __published: section of TForm1 class;

This means we can use these components like Form1->Edit1 or Form1->Button1. In Classes,
__published: this section is used to define variables which are auto generated by IDE
private: this section is used for private user declarations, these can not be used by other units,, classes or functions, something like a local variable defined in a class
public: this section is used for general user declarations, these can be used by other units,, classes or functions, it is something like a global variable defined in a class

2. If we double click to Button1 you will see that our cpp will have new OnClick() event, modify inside it as below to see text in Edit1.

and you will see this Buttoon1Click() procedure definition is also declared in __published: section of Form1. Here we can use Edit1->Text in our Button1Click() too;

Because, If you look at to Unit.h header, Button1Click() is defined as a part of Form1 class, and Edit1 is also part of Form1 class,

3. Now let’s create a new Unit. Select File-> New-> VCL Form — C++ Builder menu to create a new Unit, it will automatically have Unit2 name

4. Add an Edit box and a Button to Form2, Double click to Button1 and

At this point, note that now we have two Units ( Unit1 and Unit2 ) and each Unit has Button1 and Edit1 components. Now, how we can see Text of Edit1 of Unit2 from the Unit1? To interact between units you must add their header files. Both cpp files of Units should have both Units, please add missing headers to cpp files of modules as below,

Unit1.cpp should have,

Unit2.cpp should have,

Now both units has both headers, so we can interact with them. For example, we can show Text of Edit1 from Form2 in Form1 as shown Unit1.cpp below,

We can do same on the Unit2.cpp as below;

As you see both Units has both headers and and we just add Form1-> or Form2-> to see it’s members.

How do I use Global Variables between Units?

We can also use Global Variables, let’s define a global mytext in the Unit1.cpp like this

To use this global in Unit2.cpp we should use extern command as below

As you see, in this example mytext is defined as a global in Unit1 and we obtain it in Unit2 by using extern command. Note that this is same on FMX applications too. In general, using variables in Classes is much more safe about memory management. So avoid to use global variables or be careful when using them, do not forget to free them if they have been allocated in the memory.

Oh hi there 👋
It’s nice to meet you.

Sign up to receive awesome C++ content in your inbox, every day.

We don’t spam! Read our privacy policy for more info.


Reduce development time and get to market faster with RAD Studio, Delphi, or C++Builder.
Design. Code. Compile. Deploy.
Start Free Trial

Free C++Builder Community Edition

About author

Dr. Yilmaz Yoru has 35+ years of coding with more than 30+ programming languages, mostly C++ on Windows, Android, Mac-OS, iOS, Linux, and some other operating systems. He graduated and received his MSc and PhD degrees from the Department of Mechanical Engineering of Eskisehir Osmangazi University. He is the founder and CEO of ESENJA LLC Company. His interests are Programming, Thermodynamics, Fluid Mechanics, Artificial Intelligence, 2D & 3D Designs, and high-end innovations.
Related posts
C++C++11C++14C++17C++20Introduction to C++Learn C++

Learn Copy Constructors in C++ Classes

C++C++11C++14C++17Introduction to C++Learn C++Syntax

Learn How To Use Types Of Destructors In C++?

C++C++11C++14Learn C++Syntax

How To Convert u32string To A wstring In C++

C++C++11C++14C++17C++20Introduction to C++Learn C++

How To Learn The Move Constructors In Modern C++?