Alloc - Revision history

Sandman at 12:46, 29 April 2008

2008-04-29T12:46:14Z

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

Sandman at 14:57, 28 April 2007

2007-04-28T14:57:50Z

←Older revision		Revision as of 14:57, 28 April 2007
Line 61:		Line 61:
	end		end

-	~~Loop~~	+	Repeat
	frame;		frame;
-	~~End~~	+	Until(key(_esc))
		+
		+	// Free the used memory
		+	free(pbyte);
		+	free(pword);
		+	free(pint);

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

Sandman at 00:37, 28 April 2007

2007-04-28T00:37:05Z

←Older revision		Revision as of 00:37, 28 April 2007
Line 3:		Line 3:

	==Definition==		==Definition==
-	'''~~BYTE~~ POINTER''' ~~Alloc~~ ( <'''INT''' size> )	+	'''VOID POINTER''' alloc ( <'''INT''' size> )

-	Allocates a block of memory of a certain size.	+	Allocates a [[memoryblock\|block of memory]] of a certain size.

	== Parameters ==		== Parameters ==
	{\|		{\|
-	\| '''INT''' size \|\| - The size of the to be allocated memory.	+	\| '''INT''' size \|\| - The size of the to be allocated memory in [[byte]]s.
	\|}		\|}

	== Returns ==		== Returns ==
-	'''~~BYTE~~ POINTER''' : Pointer to the first element of the allocated memory block.	+	'''VOID POINTER''' : Pointer to the first element of the allocated memory block.

-	== ~~Throws~~ ==	+	== Errors ==
	{\|		{\|
	\| Insufficient memory \|\| - There is insufficient memory available. This error doesn't occur often.		\| Insufficient memory \|\| - There is insufficient memory available. This error doesn't occur often.

Sandman at 23:00, 27 April 2007

2007-04-27T23:00:32Z

←Older revision		Revision as of 23:00, 27 April 2007
Line 13:		Line 13:

	== Returns ==		== Returns ==
-	'''BYTE POINTER''' : ~~A pointer~~ to the first element of the allocated memory block.	+	'''BYTE POINTER''' : Pointer to the first element of the allocated memory block.
		+
		+	== Throws ==
		+	{\|
		+	\| Insufficient memory \|\| - There is insufficient memory available. This error doesn't occur often.
		+	\|}

	== Example ==		== Example ==
Line 20:		Line 25:
	Private		Private
	byte pointer pbyte;		byte pointer pbyte;
		+	word pointer pword;
	int pointer pint;		int pointer pint;
	int elements = 10;		int elements = 10;
Line 27:		Line 33:
	// Allocate memory		// Allocate memory
	pbyte = alloc(elements);		pbyte = alloc(elements);
		+	pword = alloc(elements*sizeof(word));
	pint = alloc(elements*sizeof(int));		pint = alloc(elements*sizeof(int));

	// Reset memory to 0's		// Reset memory to 0's
-	memset(pbyte,0,elements);	+	memset (pbyte,0,elements);
-	memset(pint ,0,elements*sizeof(int));	+	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 ~~memory~~	+	// Write numbers to bytes and ints
	for(i=0; i<elements; i++)		for(i=0; i<elements; i++)
-	pbyte[i] = 133;	+	pbyte[i] = 133; // pbyte[i] is the same as *(pbyte+i)
-	*(pint+i) = 4555;	+	(pint+i) = 4555; // pint[i] is the same as (pint+i)
	end		end
		+
		+	// Write numbers to words
		+	memsetw(pword,345,elements);

	// Show numbers		// Show numbers
	for(i=0; i<elements; i++)		for(i=0; i<elements; i++)
	say("byte["+i+"] = " + *(pbyte+i));		say("byte["+i+"] = " + *(pbyte+i));
		+	say("word["+i+"] = " + pword[i]);
	say("int ["+i+"] = " + pint[i]);		say("int ["+i+"] = " + pint[i]);
	end		end
Line 48:		Line 64:
	frame;		frame;
	End		End
		+
	End		End
	</pre>		</pre>
-	Used in example: [[memset]](), [[~~pointer~~]], [[say]]()	+	Used in example: [[memset]](), [[memsetw]](), [[sizeof]](), [[say]](), [[pointer]]

Sandman: category

2007-04-19T14:27:33Z

Sandman at 14:27, 19 April 2007

2007-04-19T14:27:12Z

New page

[[Category:functions]]
[[Category:processinteraction]]

==Definition==
'''BYTE POINTER''' Alloc ( <'''INT''' size> )

Allocates a block of memory of a certain size.

== Parameters ==
{|
| '''INT''' size || - The size of the to be allocated memory.
|}

== Returns ==
'''BYTE POINTER''' : A pointer to the first element of the allocated memory block.

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

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

// Reset memory to 0's
memset(pbyte,0,elements);
memset(pint ,0,elements*sizeof(int));

// Write numbers to memory
for(i=0; i<elements; i++)
pbyte[i] = 133;
*(pint+i) = 4555;
end

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

Loop
frame;
End
End
</pre>
Used in example: [[memset]](), [[pointer]], [[say]]()

←Older revision		Revision as of 14:27, 19 April 2007
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
-	[[Category:~~processinteraction~~]]	+	[[Category:memory]]

	==Definition==		==Definition==