[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] | Reference for unit 'sysutils' (#rtl)

# StrBufSize

Return the size of a null-terminated string allocated on the heap.

## Declaration

Source position: syspchh.inc line 42

`function StrBufSize(`
`Str: PChar`
`):Cardinal; function StrBufSize(`
`str: pwidechar`
`):Cardinal;`

## Description

StrBufSize returns the memory allocated for Str. This function ONLY gives the correct result if Str was allocated using StrAlloc.

## Errors

If no more memory is available, a runtime error occurs.

## See also

StrAlloc |  | Allocate a null-terminated string on the heap.
StrDispose |  | Dispose of a null-terminated string on the heap.

## Example

    Program Example46;

    { This program demonstrates the StrBufSize function }
    {$H+}

    Uses sysutils;

    Const S  = 'Some nice string';

    Var P : Pchar;

    Begin
       P:=StrAlloc(Length(S)+1);
       StrPCopy(P,S);
       Write (P, ' has length ',length(S));
       Writeln (' and  buffer size ',StrBufSize(P));
       StrDispose(P);
    End.