What do you get with a Packt Subscription?

Free for first 7 days. $15.99 p/m after that. Cancel any time!

Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!

50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.

Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.

Thousands of reference materials covering every tech concept you need to stay up to date.

Subscribe now

View plans & pricing

haXe 2 Beginner's Guide

Chapter 1. Getting to know haXe

Entering the haXe World.

In this chapter you will discover haXe's world and enter it. You'll install haXe and write your first program.

This is our first chapter and you will soon be taking your first steps with haXe. However, before you get into action, let's introduce you to haXe and set up your working environment.

In this chapter, you will:

Install haXe
Choose a code editor based on our requirements
Write and run your first program
Write a program interacting with the user

Seems like a long list? Don't be afraid, you will make it!

Installing haXe

Enough talking, let's install haXe! You will see how easy it is.

Two ways to install: The installer and sources compilation

You should know that there are two ways to install haXe, which are as follows:

Using the installer: An executable that will automatically install haXe for you.
Compiling from sources using the code repository located at the following URL:
http://code.google.com/p/haxe

One important thing to note is that haXe can be installed on on Windows, Linux, and MacOSX. This way, you don't have to worry about your operating system and can continue working in your environment.

Installing on Windows

Installing haXe on Windows is pretty easy, but there are some caveats that we should avoid.

So, carry out the following steps:

Go to http://www.haxe.org.
Click on the Download link.
There, you will find a link to download the Windows version of the installer. It comes as an executable file.
Run the executable.

Note that if you're working on Windows Vista or Windows 7, you will need to run the executable as Administrator. You can do so by right-clicking on the installer while holding the Shift key down and then clicking on Run as Administrator.

Installing on MacOSX

Installing haXe on MacOSX is very straightforward. Carry out the following steps:

Go to http://www.haxe.org.
Click on the Download link.
There, locate and click on the link to download the OSX Universal Installer.
The installer comes as a DMG image, if it's not automatically mounted; mount it by double-clicking on it.
Go to where the DMG image is mounted and run the installer.

That's it! You have haXe installed on MacOSX!

Installing on Linux

Some distributions have haXe in their repositories, so you may install it from your distribution's repository if it's available.

Alternatively, you can use the Linux Installer to install haXe; it does work on many distributions. Carry out the following steps to install haXe on Linux:

Go to http://www.haxe.org.
Click on the Downloads link.
Find the link to download the Linux version of the installer.
Uncompress the file by using the tar –zxf hxinst-linux.tgz command.
Add execution rights on the installer by using the chmod +x hxinst-linux command.
Run the installer with administration rights either by using the sudo –s command or the su – command, and then running ./hxinst-linux.

Now, you should have haXe installed on your Linux machine.

Installing nightly builds

If you need features that are not in the latest release, you can use the nightly builds to easily have access to binaries of what is in the repository without the need of compiling it on your own.

You will be able to find them on the haXe website's Download page for your operating system.

Note that the nightly builds do not come with an installer and therefore, you are advised to first install using the installer, so that it sets up all environment variables and then replaces installed files by the ones from the nightly builds archive.

On MacOSX and Linux machines, you should find them in /usr/lib/haxe, while on Windows, they should be in c:\haxe.

Verifying your installation

You can verify that haXe is correctly installed by opening a terminal and running the haxe command; if haXe is correctly installed, then you should get the help message.

You can also test that Neko is correctly installed by running the neko command. You should again get the help message.

Time for action – Interacting with the user

Now, we're going to create an application that takes your name as a parameter, greets you, and displays the number of characters in your name.

Copy the following code in a file named Main.hx

class Main
{
  public function new()
  {
  
  }

  public static function main()
  {
   var name = neko.Sys.args()[0];
   trace("Hello " + name);
   trace("Your name is " + Std.string(name.length) + " characters long.");
  }
}

Open a terminal; go to the directory where you saved Main.hx and type the haxe –main Main -neko characterCounter.n command.
Type the command (this is an example with my first name):
neko characterCounter.n Benjamin
You will see the following output:
Main.hx:12: Hello Benjamin
Main.hx:13: Your name is 8 characters long.

What just happened?

The program read your name from the command line, greeted you by appending your name to "Hello", and displayed the number of characters that make up your name.

The code: You already know the basics about the class and the main function. What is interesting to see here is how we get the arguments. When targeting neko, we can use the args function of neko.Sys. This function takes no parameters and returns an Array of String.
As you can see, we can access an array's item by its index using the square-brackets notation. Here we are accessing the item at index 0 (arrays are 0-based, that means that the first item is always at index 0).
Then, we use the trace function that you've already seen to display "Hello" followed by the name of the user. As you can see here, string concatenation is done by using the + operator. It is still quite important to note that there are classes such as StringBuf that can be used to achieve the same behavior, if you are focused on performances.
You'll also notice that String has a variable named length that allows you to retrieve the number of characters in it.
By the way, haXe is typed, and here we are using Std.string to convert the length of the string from Int to String. Std.string can be used to convert any value to a String. This is not mandatory here, as when using the + operator, if one of the two values is not an Int nor a Float, the operator will return a String. In this case, all operands will be considered as String.
The compilation: Well, as you can see, there's absolutely nothing new in the compilation process. The only thing we've changed is the output file's name.
Running the neko code: In the third step, we invoke the neko VM and tell it to execute the characterCounter.n file by passing it an argument: Benjamin.
Possible improvements: Our program is quite simple, but if you've some experience with programming, you may have noticed one point where our program may encounter an exception: we are relying on the fact that the user will give us at least one argument, and we access it directly without verifying that it's really there. So, if the user gives us no argument, we will encounter an exception. There are two ways to handle that: either we verify how many arguments the user has given, or we can also try to catch exceptions. This is something that we will explain later.

Pop quiz – basic knowledge

It is possible to install haXe on:
1. Windows
2. MacOSX
3. Linux
4. Android
5. iOS
What major version do we use nowadays?
1. haXe 1
2. haXe 2
3. haXe 3
4. haXe 4
The main function of a program has to be:
1. static and named main
2. public and named first
3. public and static, and named first
The debugging function that prints some text is named:
1. println
2. print
3. trace
4. debug

What do you get with a Packt Subscription?

Free for first 7 days. $15.99 p/m after that. Cancel any time!

Unlimited ad-free access to the largest independent learning library in tech. Access this title and thousands more!

50+ new titles added per month, including many first-to-market concepts and exclusive early access to books as they are being written.

Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.

Thousands of reference materials covering every tech concept you need to stay up to date.

Subscribe now

View plans & pricing

haXe 2 Beginner's Guide: Develop exciting applications with this multi-platform programming language

What do you get with a Packt Subscription?

Product Details

haXe 2 Beginner's Guide

Chapter 1. Getting to know haXe

Installing haXe

Two ways to install: The installer and sources compilation

Installing on Windows

Installing on MacOSX

Installing on Linux

Installing nightly builds

Verifying your installation

Choosing an editor

FlashDevelop 3

The TextMate bundle

VIM

Writing your first program

Time for action – Writing a Hello World

Tip

What just happened?

A program with some interaction

Time for action – Interacting with the user

What just happened?

Pop quiz – basic knowledge

Summary

Page 1 of 8

Key benefits

What you will learn

What do you get with a Packt Subscription?

Product Details

Table of Contents

Recommendations for you

Customer reviews

Filter reviews by

People who bought this also bought

Authors (2)

FAQs

haXe 2 Beginner's Guide: Develop exciting applications with this multi-platform programming language

What do you get with a Packt Subscription?

Product Details

Key benefits

What you will learn

What do you get with a Packt Subscription?

Product Details

Packt Subscriptions

Table of Contents

Recommendations for you

Customer reviews

Filter reviews by

People who bought this also bought

Authors (2)

FAQs