Sandman at 12:46, 29 April 2008

2008-04-29T12:46:33Z

←Older revision		Revision as of 12:46, 29 April 2008
Line 69:		Line 69:
	End		End
	</pre>		</pre>
-	Used in example: [[alloc]](), [[memset]](), [[memsetw]](), [[sizeof]](), [[say]](), [[pointer]]	+	Used in example: [[alloc]](), [[memset]](), [[memsetw]](), [[sizeof]](), [[say]](), [[free]](), [[pointer]]
		+
		+	{{Funcbox
		+	\| category = Memory
		+	}}

Sandman at 15:29, 28 April 2007

2007-04-28T15:29:57Z

New page

[[Category:functions]]
[[Category:memory]]

==Definition==
'''INT''' free ( <'''VOID POINTER''' data> )

Frees a block of memory.

The pointer used must be a pointer to a previously allocated block of memory, else the behavior of free() is undefined.

== Parameters ==
{|
| '''VOID POINTER''' data || - Pointer to the block of memory to be freed.
|}

== Returns ==
'''INT''' : [[true]]

== Example ==
<pre>
Program example;
Private
byte pointer pbyte;
word pointer pword;
int pointer pint;
int elements = 10;
int i;
Begin

// Allocate memory
pbyte = alloc(elements);
pword = alloc(elements*sizeof(word));
pint = alloc(elements*sizeof(int));

// Reset memory to 0's
memset (pbyte,0,elements);
memsetw(pword,0,elements); // same as memset(pword,0,elements*sizeof(word));
// because value-parameter is 0.
memset (pint ,0,elements*sizeof(int)); // There isn't a "memseti()", so we need to
// set the individual bytes to 0. To change
// ints to nonzero values, memset() can't be
// used easily

// Write numbers to bytes and ints
for(i=0; i<elements; i++)
pbyte[i] = 133; // pbyte[i] is the same as *(pbyte+i)
*(pint+i) = 4555; // pint[i] is the same as *(pint+i)
end

// Write numbers to words
memsetw(pword,345,elements);

// Show numbers
for(i=0; i<elements; i++)
say("byte["+i+"] = " + *(pbyte+i));
say("word["+i+"] = " + pword[i]);
say("int ["+i+"] = " + pint[i]);
end

Repeat
frame;
Until(key(_esc))

// Free the used memory
free(pbyte);
free(pword);
free(pint);

End
</pre>
Used in example: [[alloc]](), [[memset]](), [[memsetw]](), [[sizeof]](), [[say]](), [[pointer]]

Free - Revision history

Sandman at 12:46, 29 April 2008

Sandman at 15:29, 28 April 2007