Intel® oneAPI DPC++/C++ Compiler Developer Guide and Reference

ID 767253
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

Create a Simple Eclipse Project

The sections below show you how to create a simple project using Eclipse.

Create a New Eclipse Project

To create an Eclipse project:

  1. Select File > New > Project... The New Project wizard opens.
  2. Expand the C/C++ Project tab and select the appropriate project type. Click Next to continue.
  3. For Project name, enter hello_world. Deselect the Use default location to specify a directory for the new project.
  4. In the Project Type list, expand the Executable project type and select Hello World C++ Project for C++ or Hello World DPC++ Project for DPC++.
  5. In the Toolchains list, select Intel C++ Compiler for a C++ project, or Intel(R) oneAPI DPC++ Compiler for a DPC++ project. Click Next.

    NOTE:
    • If you need to see the toolchains for the compilers that are not locally installed, uncheck Show project types and toolchains only if they are supported on the platform. You are only able to view and configure these toolchains if the proper compilers are installed.
    • If you have multiple versions of the compiler installed, they appear in the project’s properties under C/C++ Build > Settings on the Intel(R) oneAPI DPC++ Compiler tab for a DPC++ project, or the Intel C++ Compiler tab for a C++ project.

  6. The Basic Settings page allows specifying template information, including Author and Copyright notice, which appear as a comment at the top of the generated source file. After entering desired fields, click Next.
  7. The Select Configurations page allows specifying deployment platforms and configurations. By default, a Debug and Release configuration is created for the selected toolchain. Select no (Deselect all), multiple, or all (Select all) configurations. To edit project properties, click the Advanced settings button. Click Finish to create the hello_world project. Configurations can be created after the project is created by selecting Project > Properties.
  8. If the view is not the C/C++ Development Perspective (default), an Open Associated Perspective dialog box opens. In the C/C++ Perspective, click Yes to proceed.

An entry for your hello_world project appears in the Project Explorer view.

Add a C Source File

To add a source file to the hello_world project:

  1. Select the hello_world project in the Project Explorer view.
  2. Select File > New > Source File. The New Source File dialog box opens. The dialog box automatically populates the source folder for the source file to be created. You can change this by entering a new location or selecting Browse.
  3. Enter new_source_file.c in the Source File field.
  4. Select a Template from the drop-down list or Configure a new template.
  5. Click Finish to add the file to the hello_world project.
  6. In the Editor view, add your code for new_source_file.c.
  7. When your code is complete, Save your file.

Set Options for a Project or File

You can specify compiler, linker, and archiver options at the project and source file level. Follow these steps to set options for a project or file:

  1. Right-click a project or source file in the Project Explorer.
  2. Select Properties. The property pages dialog box opens.
  3. Select C/C++ Build > Settings.
  4. Select the Tool Settings tab and click an option category for Intel C Compiler, Intel C++ Compiler, or Intel C++ Linker for a C++ project, or select Intel® oneAPI DPC++ Compiler or Intel® oneAPI DPC++ Linker for a DPC+++ project.
  5. Set the options to apply to the project or file.
    NOTE:
    • Some properties use check boxes, drop-down boxes, or dialog boxes to specify compiler options. For a description on options properties, hover over the option to display a tooltip. After setting the desired options in command line syntax, select Apply.
    • To specify an option that is not available from the Properties dialog, use C/C++ Build Settings > Settings > <Compiler> > Command Line. Enter the command line options in the Additional Options field using command-line syntax and select Apply.
    • You can specify option settings for one or more configurations by using the Configuration drop-down menu.
  6. Click Apply and Close.

The compiler applies the selected options, using the selected configurations, when building. To restore default settings to all properties for the selected configuration, click the Restore Defaults button on any property page.

Exclude Source Files from a Build

To exclude a source file from a build:

  1. Right-click a file or folder in the Project Explorer.
  2. Select Resource Configurations > Exclude from build. The Exclude from build dialog box opens.
  3. Select one or more build configurations to exclude the file or folder from.
  4. Click OK.

The compiler excludes that file or folder when it builds using the selected project configuration.

Build a Project

To build your project:

  1. Select the hello_world project in the Project Explorer view.
  2. Select Project > Build Project.

See the Build results in the Console view.

For a C/C++ project:

**** Build of configuration Debug for project hello_world ****
make all 
Building file: ../src/hello_world.cpp
Invoking: Intel C++ Compiler
icpx -g -O0 -MMD -MP -MF"src/hello_world.d" -MT"src/hello_world.d" -c -o "src/hello_world.o" "../src/hello_world.cpp"
Finished building: ../src/hello_world.cpp
 
Building target: hello_world
Invoking: Intel C++ Linker
icpx -O0 -o "hello_world"  ./src/hello_world.o   
Finished building target: hello_world
 
Build Finished. 0 errors, 0 warnings.

For a DPC++ project, use:

**** Build of configuration Debug for project DPCPPhelloworld ****
make all 
Building file: ../main.cpp
Invoking: Intel(R) oneAPI DPC++ Compiler
icpx -fsycl -g -Wall -O0 -I/home/sys_idebuilder/eclipse-workspace/DPCPPhelloworld -MMD -MP -c -o "main.o" "../main.cpp"
Finished building: ../main.cpp
 
Building target: DPCPPhelloworld
Invoking: Linker
icpx -fsycl  -o "DPCPPhelloworld"  ./main.o   -lsycl -lOpenCL
Finished building target: DPCPPhelloworld

Build Finished. 0 errors, 0 warnings.

Detailed descriptions of errors, warnings, and other output can be viewed by selecting the Problems tab.

Run a Project

After building a project, you can run your project by following these steps:

  1. Select the hello_world project in the Project Explorer view.
  2. Select Run As > Local C/C++ Application.

When the executable runs, the output appears in the Console view.

Error Parser

The Error Parser (selected by default) lets you track compile-time errors in Eclipse. To confirm that the Error Parser is active:

  1. Select the hello_world project in the Project Explorer view.
  2. Select Project > Properties.
  3. In the Properties dialog box, select C/C++ Build > Settings.
  4. Click the Error Parsers tab. Make sure that Intel C++ Error Parser is checked, and CDT Visual C Error Parser or Microsoft Visual C Error Parser are not checked.
  5. Click OK to update your choices, if you have changed any settings.

Use the Error Parser

The Error Parser automatically detects and manages the diagnostics generated by the compiler.

If an error occurring in the hello_world.c program is compiled, for example, #include <xstdio.h>, the error is reported in the Problems view next to an error marker.

You can double-click each error in the Problems view to highlight the source line, which causes the error in the Editor view.

Correct the error, then rebuild your project.