Pierwsze tradycyjne "Hello world!" - Revision history

Krashan: Crosslink to English version.

2011-04-04T12:42:22Z

Crosslink to English version.

Krashan: Finished

2011-04-04T12:40:47Z

Finished

Krashan: Translation in progress.

2011-04-04T11:28:10Z

Translation in progress.

Krashan: Created, copied English text.

2011-04-04T10:54:15Z

Created, copied English text.

New page

''Grzegorz Kraszewski''

=="Hello World!" With the Standard C Library==

With the standard C library, one can use the "Hello World!" example exactly as found in a C handbook. It is given below, just for completeness:

<tt>#include <stdio.h> 
int main(void) 
{ 
  printf("Hello World!\n"); 
  return 0; 
} </tt>

This source may be copied to a text editor and saved as ''helloworld.c''. To compile it, one opens a shell window (from the Ambient menu, or using the ''rcommand + n'' key combo) and changes current directory to the one, where the C source is located. The compiler is run as follows:

<tt>gcc -o helloworld helloworld.c</tt>

The compiler produces a ''helloworld'' executable, which is 10 340 bytes on my system. Note that MorphOS pays little attention to filename extensions, so ending the executable name with ''.exe'' is not needed, however, it can be done. Traditionally MorphOS executables are named without any extensions. The '''−o''' compiler option specifies a desired executable name. If this option is not given, the executable will be named ''a.out'' (for some historical reasons).

As stated in the [[Installation_of_Software_Development_Kit_and_its_basic_usage#Standard_C_and_C++_Libraries|SDK section]], the standard C library will be provided by ''ixemul.library''. It can be easily confirmed by tracing the disk activity of ''helloworld'' using the ''Snoopium'' tool.

[[File:snoopium_ixemul.png]]

It can also be seen that many other libraries are also opened including ones related to TCP/IP networking. It looks like overkill for such a small program. This happens, because ''ixemul.library'' creates a complete unixlike environment for the application, which is not needed in this simple case. That is why the ''libnix'' alternative is recommended for use of the standard library. To use it, a '''−noixemul''' option has to be added, so the compiler is called as follows:

<tt>gcc -noixemul -o helloworld helloworld.c</tt>

The generated executable is much larger (30 964 bytes here), which just confirms the fact, that ''libnix'', which is now in use, is a statically linked library. Size of functions used adds to the size of the executable. Every C handbook states, that ''printf()'' is the most expensive function of standard I/O, which has just been proven experimentally... On the other hand program activity, as traced with ''Snoopium'', is reduced to three entries. No external resources are opened.

=="Hello World!" With the MorphOS Native API==

The MorphOS API (''Application Programmer Interface'') provides complete file and console input/output. In fact, functions in C and C++ standard libraries are, more or less, complex wrappers around MorphOS native calls. Using the native API has the following advantages:

* Programs are much shorter.
* Programs are faster, thanks to stripping some layers of abstraction.
* Programs are less resource hungry.
* Native API gives full access to MorphOS specific features.

These advantages come at a price:

* Programs using the native API are not portable (except for porting to AmigaOS and AROS to some degree).
* Native ''printf()''-like functions do not support floating point numbers.

The "Hello World!" example using the native API is as follows:

<tt>#include <proto/dos.h> 
int main(void) 
{ 
  Printf("Hello World!\n"); 
  return 0; 
}</tt>

The included header includes all things needed to use the ''dos.library'', where the ''Printf()'' function is located. The function itself works the same as the standard library ''printf()'', with some minor differences. The code is compiled with this command:

<tt>gcc -noixemul -o helloworld helloworld.c</tt>

The command is the same as that used for the program using ''libnix'' and the standard library ''printf()'', however, the standard C function is not used, so it is not linked. Now the executable size reduces to 13 500 bytes.

Why is ''libnix'' still needed in spite of the standard library calls not being used? Can't one just compile with '''−nostdlib'''? Other than the standard C library, ''libnix'' also provides application startup code. A program without this startup code can still work when launched from the shell, but will crash when started from Ambient. The startup code also provides an automatic MorphOS library opening and closing feature. So, excluding ''libnix'' completely is possible, but requires [[writing your own startup code]] and [[MorphOS_API_and_Its_Organization#Manual_Library_Opening_and_Closing|handling library opening and closing manually]].

Note: excluding ''libnix'' is usually done for MorphOS components other than applications, like shared libraries or Reggae and MUI public classes. It can also be done for ordinary programs just to make them shorter, especially if a program is small. For bigger projects bytes saved by writing custom startup code are not usually worth the effort.

← Older revision		Revision as of 12:42, 4 April 2011
Line 1:		Line 1:
	''Grzegorz Kraszewski''		''Grzegorz Kraszewski''
		+	----
		+	<small>Ta strona w innych językach: [[The First Traditional "Hello world!"\|angielski]]</small>

@@ Line 27: / Line 27: @@
-It can also be seen that many other libraries are also opened including ones related to TCP/IP networking. It looks like overkill for such a small program. This happens, because ''ixemul.library'' creates a complete unixlike environment for the application, which is not needed in this simple case. That is why the ''libnix'' alternative is recommended for use of the standard library. To use it, a '''&minus;noixemul''' option has to be added, so the compiler is called as follows:
+Jak widać, program otwiera również inne biblioteki, nawet związane z komunikacją sieciową i stosem TCP/IP. Wygląda to na lekką przesadę, jak na taki prosty program. Dzieje się tak dlatego, że biblioteka ''ixemul.library'' tworzy programowi kompletne środowisko uniksopodobne, które w tym przypadku do niczego w gruncie rzeczy nie jest potrzebne. Dlatego zaleca się używanie statycznie linkowanej biblioteki ''libnix'' zamiast ''ixemul.library''. W tym celu dodajemy do wywołania kompilatora opcję '''&minus;noixemul''', będzie ono teraz wyglądało następująco:
-<tt>gcc -noixemul -o helloworld helloworld.c</tt>
+Wygenerowany plik wykonywalny jest teraz znacznie większy (na moim systemie 30 964 bajty), co potwierdza fakt, że tym razem użyte funkcje biblioteki standardowej zostały pobrane z ''libnix''-a i statycznie zlinkowane z programem, zwiększając tym samym jego rozmiar. Każdy podręcznik języka C mówi o tym, że ''printf()'' jest jedną z najkosztowniejszych (w sensie rozmiaru kodu) funkcji standardowego wejścia/wyjścia, co właśnie potwierdziliśmy eksperymentalnie... Z drugiej strony aktywność dyskowa programu została zredukowana do trzech linijek w ''Snoopium'', nasz program nie ładuje żadnych dodatkowych zasobów.
-The generated executable is much larger (30 964 bytes here), which just confirms the fact, that ''libnix'', which is now in use, is a statically linked library. Size of functions used adds to the size of the executable. Every C handbook states, that ''printf()'' is the most expensive function of standard I/O, which has just been proven experimentally... On the other hand program activity, as traced with ''Snoopium'', is reduced to three entries. No external resources are opened.
+=="Hello World!" z użyciem natywnego API systemu==
-=="Hello World!" With the MorphOS Native API==
+* Programy są znacznie krótsze.
-* Programs are much shorter.
+Ceną jaką za to płacimy jest utracenie przenośności kodu (z wyjątkiem &ndash; do pewnego stopnia &ndash; portów dla AmigaOS i AROS-a).
-These advantages come at a price:
+Przykład "Hello World!" z użyciem natywnego API MorphOS-a wygląda jak następuje:
-* Programs using the native API are not portable (except for porting to AmigaOS and AROS to some degree).
+ #include <proto/dos.h>
-* Native ''printf()''-like functions do not support floating point numbers.
-The "Hello World!" example using the native API is as follows:
+ gcc -noixemul -o helloworld helloworld.c
+<small>Uwaga: całkowita eliminacja biblioteki standardowej jest często wykonywana przy budowaniu komponentów systemu: bibliotek współdzielonych, czy klas publicznych MUI i Reggae. Można to zrobić również dla zwykłego programu aby uczynić go krótszym, szczególnie, jeśli program jest mały. Dla większych projektów zysk na rozmiarze pliku wykonywalnego uzyskany przez napisanie własnego kodu startowego jest zazwyczaj niewart włożonej dodatkowej pracy.</small>

@@ Line 2: / Line 2: @@
-=="Hello World!" With the Standard C Library==
+=="Hello World!" z użyciem biblioteki standardowej C==
-With the standard C library, one can use the "Hello World!" example exactly as found in a C handbook. It is given below, just for completeness:
+Używając biblioteki standardowej C, przykładowy program "Hello World!" możemy po prostu przepisać z podręcznika. Oto kod, dla przypomnienia:
-<tt>#include <stdio.h><br><br>
+Kod źródłowy można skopiować do edytora tekstowego i zapisać jako ''helloworld.c''. Aby go skompilować, otwieramy okno konsoli (z menu Ambienta, albo używając skrótu klawiszowego ''rcommand + n'') i zmieniamy katalog bieżący na ten zawierający kod źródłowy. Uruchamiamy kompilator:
-This source may be copied to a text editor and saved as ''helloworld.c''. To compile it, one opens a shell window (from the Ambient menu, or using the ''rcommand + n'' key combo) and changes current directory to the one, where the C source is located. The compiler is run as follows:
+Kompilator stworzy plik wykonywalny ''helloworld'', na moim systemie posiada on długość 10 340 bajtów. Warto zauważyć, że w MorphOS-ie rozszerzenia pilków nie są istotne więc dodanie ''.exe'' na końcu nazwy nie jest konieczne, chociaż możliwe. Tradycyjnie pliki wykonywalne w MorphOS-ie nie mają żadnego rozszerzenia nazwy. Opcja kompilatora '''&minus;o''' specyfikuje nazwę tworzonego pliku wykonywalnego. Jeżeli opcja ta nie zostanie użyta, plik wynikowy zostanie nazwany ''a.out'' (z powodów historycznych).
-<tt>gcc -o helloworld helloworld.c</tt>
+Jak to opisano w [[Instalacja SDK (Software Development Kit) i podstawy jego używania#Standardowe biblioteki C i C++|rozdziale o SDK]], biblioteka standardowa C jest dostarczana przez ''ixemul.library''. Można to łatwo sprawdzić, śledząc aktywność dyskową programu za pomocą narzędzia ''Snoopium'':