1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
.\" Modified Sat Jul 24 19:00:59 1993 by Rik Faith (faith@cs.unc.edu)
.\" Clarification concerning realloc, iwj10@cus.cam.ac.uk (Ian Jackson), 950701
.\" Translated to German Sat Jun 01 21:14:00 1996 by Patrick Rother <krd@gulu.net>
.\"
.TH MALLOC 3 "1. Juni 1996" "GNU" "Bibliotheksfunktionen"
.SH BEZEICHNUNG
calloc, malloc, free, realloc \- belegen und freigeben von dynamischem Speicher
.SH BERSICHT
.nf
.B #include <stdlib.h>
.sp
.BI "void *calloc(size_t " "nmemb" ", size_t " "size" ");"
.nl
.BI "void *malloc(size_t " "size" ");"
.nl
.BI "void free(void " "*ptr" ");"
.nl
.BI "void *realloc(void " "*ptr" ", size_t " "size" ");"
.fi
.SH BESCHREIBUNG
.B calloc()
belegt Speicher fr ein Array von
.I nmemb
Elementen von jeweils
.I size
Byte und gibt einen Zeiger auf den belegten Speicherbereich zurck.
Der Speicher wird auf Null gesetzt.
.PP
.B malloc()
belegt
.I size
Byte und gibt einen Zeiger auf den belegten Speicherbereich zurck.
Der Speicher wird nicht mit Nullen beschrieben.
.PP
.B free()
gibt den Speicher frei, auf den
.IR ptr
zeigt, welcher von einem frheren Aufruf von
.BR malloc() ,
.B calloc()
oder
.BR realloc()
zurckgegeben worden sein mu.
Wenn
.I ptr
.BR NULL
ist, wird keine Operation ausgefhrt.
.PP
.B realloc()
ndert die Gre des Speicherblocks, auf den
.I ptr
zeigt, auf
.I size
Byte.
Der Inhalt bleibt unverndert bis zum Minimum von alter und neuer Gre;
neu angeforderter Speicher bleibt uninitialisiert.
Wenn
.I ptr
.BR NULL
ist,
ist der Aufruf quivalent zu
.BR malloc(size) ;
wenn die Gre Null ist ist der Aufruf equivalent zu
.BI "free(" "ptr" ) \fR.
Wenn
.I ptr
nicht
.BR NULL
ist, mu er von einem frheren Aufruf von
.BR malloc() ,
.BR calloc()
oder
.BR realloc()
zurckgegeben worden sein.
.SH "RCKGABEWERTE"
Bei
.BR calloc() " und " malloc()
ist der zurckgegebene Wert ein Zeiger auf den belegten Speicher, welcher
passend ausgerichtet ist fr alle Arten von Variablen, oder
.B NULL
falls die Anforderung scheitert.
.PP
.B free()
gibt keinen Wert zurck.
.PP
.B realloc()
gibt einen Pointer auf den neu belegten Speicher zurck, welcher passend
ausgerichtet ist fr alle Arten von Variablen und welcher sich von
.IR ptr
unterscheiden kann, oder
.B NULL
falls die Anforderung scheitert oder falls die Gre Null war. Wenn
.B realloc()
scheitert bleibt der ursprngliche Block unverndert - er wird nicht
freigegeben oder verndert.
.SH "KONFORM ZU"
ANSI-C
.SH "SIEHE AUCH"
.BR brk (2).
|
