64 lines
1.3 KiB
Groff
64 lines
1.3 KiB
Groff
.\" $Id: autallocblock.3,v 1.1 2002/03/21 13:17:23 ludo Exp $
|
|
.\" @(#)autallocblock.2 2.7 96/07/02 ; Labo masi cao-vlsi; Author : Jacomme Ludovic
|
|
.TH AUTALLOCBLOCK 3 "October 1, 1997" "ASIM/LIP6" "AUT FUNCTIONS"
|
|
.SH NAME
|
|
autallocblock \- memory allocator
|
|
.so man1/alc_origin.1
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
#include "aut101.h"
|
|
char *autallocblock( Size )
|
|
unsigned int Size;
|
|
.ft R
|
|
.fi
|
|
.SH PARAMETERS
|
|
.TP 20
|
|
\fISize\fP
|
|
Number of memory bytes to be contiguously allocated
|
|
.TP
|
|
.SH DESCRIPTION
|
|
\fBautallocblock\fP returns a block of \fISize\fP bytes length.
|
|
The memory block is set to zero.
|
|
.br
|
|
.SH RETURN VALUE
|
|
\fBautallocblock\fP returns a pointer to a \fISize\fP bytes long block.
|
|
.SH ERRORS
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
"autalloc: alloc error, can't continue !"
|
|
.ft R
|
|
.RS
|
|
System break can't be moved anymore, no more memory can be retrieved from the system.
|
|
.SH EXAMPLE
|
|
.ta 3n 6n 9n 12n 15n 18n 21n
|
|
.nf
|
|
.if n \{\
|
|
.ft B \}
|
|
.if t \{\
|
|
.ft CR \}
|
|
#include "aut101.h"
|
|
char \(**dup_str(s)
|
|
char \(** s;
|
|
{
|
|
char \(**t = (char \(**)autalocblock(strlen(s) + (unsigned int)1);
|
|
strcpy(t, s); return t;
|
|
}
|
|
.ft R
|
|
.fi
|
|
.SH SEE ALSO
|
|
.BR aut (1),
|
|
.BR autresizeblock(3),
|
|
.BR autallocheap(3),
|
|
.BR autfreeblock(3),
|
|
.BR autfreeheap(3).
|
|
|
|
|
|
.so man1/alc_bug_report.1
|
|
|