179

How can I compile/run C or C++ code in a Unix console or a Mac terminal?

1
  • Associated error messages are often "command not found", "a.out: command not found", or "/a.out: No such file or directory" Commented May 8, 2022 at 13:49

19 Answers 19

239

If it is a simple single-source program,

make foo

where the source file is foo.c, foo.cpp, etc., you don’t even need a makefile. Make has enough built-in rules to build your source file into an executable of the same name, minus the extension.

Running the executable just built is the same as running any program - but you will most often need to specify the path to the executable as the shell will only search what is in $PATH to find executables, and most often that does not include the current directory (.).

So to run the built executable foo:

./foo
Sign up to request clarification or add additional context in comments.

5 Comments

I didn't realize the builtin rules propagated to targets specified when invoking make. Learned something new today =)
"-bash: make: command not found" <-- You have to have the developer tool and the extra components downloaded.
It's not make main.cpp, but make main.
What does the ./ do in ./foo?
@FabianAmran It refers to the current directory. The shell will look only in the directories listed in the $PATH environment variable for programs to execute unless a path is specified when running the program. . (current directory) is often not in $PATH for security reasons.
135
gcc main.cpp -o main.out
./main.out

5 Comments

as a noob i had so much grief for not including the "./" when executing
I used "gcc main.cpp -o main.out", and get this error, Undefined symbols for architecture x86_64: "std::__1::locale::use_facet(std::__1::locale::id&) const", ... turns out the reason is, gcc default-links is libc. while using g++ will link with libstdc++. So use "g++ main.cpp -o main.out" may be better.
About Undefined symbols for architecture x86_64 issue, I modify the command as follows: gcc -lstdc++ main.cpp -o main.out, and that works on my Mac. via link:stackoverflow.com/questions/11852568/…
g++ instead of gcc may be required if it is using std::cout (e.g., a Hello, World! program).
As noted here.
81

This is the command that works on all Unix machines... I use it on Linux/Ubuntu, but it works in OS X as well. Type the following command in Terminal.app.

g++ -o lab21 iterative.cpp

-o is the letter O, not zero

lab21 will be your executable file

iterative.cpp is your C++ file

After you run that command, type the following in the terminal to run your program:

./lab21

Comments

37

Two steps for me:

First:

make foo

Then:

./foo

1 Comment

I am sorry I am an absolute noob. What is foo here?
15

All application execution in a Unix (Linux, Mac OS X, AIX, etc.) environment depends on the executable search path.

You can display this path in the terminal with this command:

echo $PATH

On Mac OS X (by default) this will display the following colon separated search path:

/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin

So any executable in the listed directories can by run just by typing in their name. For example:

cat mytextfile.txt

This runs /bin/cat and displays mytextfile.txt to the terminal.

To run any other command that is not in the executable search path requires that you qualify the path to the executable. So say I had an executable called MyProgram in my home directory on Mac OS X I can fully qualify it like so:

/Users/oliver/MyProgram

If you are in a location that is near the program you wished to execute you can qualify the name with a partial path. For example, if MyProgram was in the directory /Users/oliver/MyProject I and I was in my home directory I can qualify the executable name like this, and have it execute:

MyProject/MyProgram

Or say I was in the directory /Users/oliver/MyProject2 and I wanted to execute /Users/oliver/MyProject/MyProgram I can use a relative path like this, to execute it:

../MyProject/MyProgram

Similarly if I am in the same directory as MyProgram I need to use a "current directory" relative path. The current directory you are in is the period character followed by a slash. For example:

./MyProgram

To determine which directory you are currently in use the pwd command.

If you are commonly putting programs in a place on your hard disk that you wish to run without having to qualify their names. For example, if you have a "bin" directory in your home directory for regularly used shell scripts of other programs it may be wise to alter your executable search path.

This can be does easily by either creating or editing the existing .bash_profile file in your home directory and adding the lines:

#!/bin/sh
export PATH=$PATH:~/bin

Here the tilde (~) character is being used as a shortcut for /Users/oliver. Also note that the hash bang (#!) line needs to be the first line of the file (if it doesn't already exist). Note also that this technique requires that your login shell be bash (the default on Mac OS X and most Linux distributions). Also note that if you want your programs installed in ~/bin to be used in preference to system executables your should reorder the export statement as follows:

export PATH=~/bin:$PATH

3 Comments

looks like a great idea EDIT: nvm me being ironic. just all the $PATH stuff remind me of Windows "environment variables" which you're not supposed to mess around with too much
Untangled: "It looks like a great idea. EDIT: never mind - it was me being ironic. Just all the $PATH stuff remind me of Windows "environment variables" which you're not supposed to mess around with too much."
macOS changed the default shell to Z shell in macOS v10.15 (Catalina). Does it work for that?
11

Do all of this in "Terminal".

To use the G++ compiler, you need to do this:

  1. Navigate to the directory in which you stored the *.cpp file.

    cd ~/programs/myprograms/ (the ~ is a shortcut for your home, i.e. /Users/Ryan/programs/myprograms/, replace with the location you actually used.)

  2. Compile it

    g++ input.cpp -o output.bin (output.bin can be anything with any extension, really. Extension .bin is just common on Unix.)

    There should be nothing returned if it was successful, and that is okay. Generally you get returns on failures.

    However, if you type ls, you will see the list of files in the same directory. For example, you would see the other folders, input.cpp and output.bin

  3. From inside the directory, now execute it with ./outbut.bin

5 Comments

Thanks this worked. Would you happen to know of any tutorials that would explain these things? Like what exactly G++ means, what the 'o' switch is and anything else that might come up?
add a comment about make wont work because there is no makefile.
Ryan, you can type "man g++" in the terminal to get the "man pages" (i.e. manuals, which I would guess Apple has embedded). I haven't seen any great tutorials though. Although, the man page on g++ may get pretty in depth with CFLAGS and all sorts of advanced compiling options.
Nitpick: "There should be NOTHING [printed] if it was successful, and that is okay. Generally you get [output] on failures." There will always be a return value, 0 on success, non-0 on failure.
Merged from stackoverflow.com/questions/13714436/… (trying to consolidate some basic instructions for this)
11

To compile C or C++ programs, there is a common command:

  1. make filename

  2. ./filename

make will build your source file into an executable file with the same name. But if you want to use the standard way, You could use the gcc compiler to build C programs and g++ for C++.

For C:

gcc filename.c

./a.out

For C++:

g++ filename.cpp

./a.out

Comments

10

A compact way to go about doing that could be:

make foo && ./$_

It is nice to have a one-liner so you can just rerun your executable again easily.

Comments

8

Assuming the current directory is not in the path, the syntax is ./[name of the program].

For example ./a.out

1 Comment

Good for you! The dot and slash are there because on many systems, the current directory ("." in Unix terms) is not part of the path searched by the shell. Thus, adding it makes it explicit which program you want to run.
7

Add the following to get the best warnings, and you will not regret it. If you can, compile using WISE (warning is error).

- Wall -pedantic -Weffc++ -Werror

1 Comment

Why the space between "-" and "Wall"? Isn't it -Wall?
6

Step 1 - create a cpp file using the command

touch test.cpp

Step 2 - Run this command

g++ test.cpp

Step 3 - Run your cpp file

./a.out

Comments

5

I am on a new MacBook Pro with the Apple M1 Pro chip. I have my Xcode installed - both IDE and command line tools. This is how it worked for me:

g++ one.cpp -o one

./one

Comments

3

Just enter in the directory in which your .c/.cpp file is.

For compiling and running C code.

gcc filename.c
./a.out filename.c

For compiling and running C++ code.

g++ filename.cpp
./a.out filename.cpp

Comments

2

Use a makefile. Even for very small (= one-file) projects, the effort is probably worth it because you can have several sets of compiler settings to test things. Debugging and deployment works much easier this way.

Read the make manual. It seems quite long at first glance, but most sections you can just skim over. All in all, it took me a few hours and made me much more productive.

Comments

2

I found this link with directions:

http://www.wesg.ca/2007/11/how-to-write-and-compile-c-programs-on-mac-os-x/

Basically you do:

gcc hello.c
./a.out (or with the output file of the first command)

2 Comments

Any chance you mean gcc hello.c -o a.out? Which does the same as gcc hello.c.
The link is broken (404).
2

In order to compile and run C++ source code from a Mac terminal, one needs to do the following:

  1. If the path of .cpp file is somePath/fileName.cpp, first go the directory with path somePath
  2. To compile fileName.cpp, type c++ fileName.cpp -o fileName
  3. To run the program, type ./fileName

1 Comment

c++ is actually an executable (at least on Ubuntu MATE 20.04) (Focal Fossa), in the default configuration). It is /usr/bin/c++ -> /etc/alternatives/c++ on that system. Perhaps elaborate a little bit in your answer, e.g. linking to official documentation (as it hasn't been covered in other answers - they use g++)? (But without "Edit:", "Update:", or similar - the answer should appear as if it was written today.)
2

For running C++ files, run the below command, assuming the file name is "main.cpp".

  1. Compile to make an object file from C++ file.

    g++ -c main.cpp -o main.o
    
  2. Since #include <conio.h> is not supported on macOS, we should use its alternative which is supported on Mac. That is #include <curses.h>. Now the object file needs to be converted to an executable file. To use file curses.h, we have to use library -lcurses.

    g++ -o main main.o -lcurses
    
  3. Now run the executable.

    ./main
    

Comments

1

Running a .C file using the terminal is a two-step process. The first step is to type gcc in the terminal and drop the .C file to the terminal, and then press Enter:

gcc /Desktop/test.c

In the second step, run the following command:

~/a.out

Comments

0

You need to go into the folder where you have saved your file. To compile the code: gcc fileName You can also use the g++ fileName This will compile your code and create a binary. Now look for the binary in the same folder and run it.

1 Comment

What is the difference between gcc and g++? Perhaps elaborate in your answer? (But without "Edit:", "Update:", or similar - the answer should appear as if it was written today.)

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.