Using realloc() Function in C

By: Charles Emailed: 1606 times Printed: 2075 times    

Latest comments
By: rohit kumar - how this program is work
By: Kirti - Hi..thx for the hadoop in
By: Spijker - I have altered the code a
By: ali mohammed - why we use the java in ne
By: ali mohammed - why we use the java in ne
By: mizhelle - when I exported the data
By: raul - no output as well, i'm ge
By: Rajesh - thanx very much...
By: Suindu De - Suppose we are executing

The realloc() function changes the size of a block of memory that was previously allocated with malloc() or calloc(). The function prototype is

void *realloc(void *ptr, size_t size);

The ptr argument is a pointer to the original block of memory. The new size, in bytes, is specified by size. There are several possible outcomes with realloc():

  • If sufficient space exists to expand the memory block pointed to by ptr, the additional memory is allocated and the function returns ptr.
  • If sufficient space does not exist to expand the current block in its current location, a new block of the size for size is allocated, and existing data is copied from the old block to the beginning of the new block. The old block is freed, and the function returns a pointer to the new block.
  • If the ptr argument is NULL, the function acts like malloc(), allocating a block of size bytes and returning a pointer to it.
  • If the argument size is 0, the memory that ptr points to is freed, and the function returns NULL.
  • If memory is insufficient for the reallocation (either expanding the old block or allocating a new one), the function returns NULL, and the original block is unchanged.

Listing below demonstrates the use of realloc().

Using realloc() to increase the size of a block of dynamically allocated memory.

1: /* Using realloc() to change memory allocation. */
3: #include <stdio.h>
4: #include <stdlib.h>
5: #include <string.h>
7: main()
8: {
9:     char buf[80], *message;
11:     /* Input a string. */
13:     puts("Enter a line of text.");
14:     gets(buf);
16:     /* Allocate the initial block and copy the string to it. */
18:     message = realloc(NULL, strlen(buf)+1);
19:     strcpy(message, buf);
21:     /* Display the message. */
23:     puts(message);
25:     /* Get another string from the user. */
27:     puts("Enter another line of text.");
28:     gets(buf);
30:     /* Increase the allocation, then concatenate the string to it. */
32:     message = realloc(message,(strlen(message) + strlen(buf)+1));
33:     strcat(message, buf);
35:     /* Display the new message. */
36:     puts(message);
37:     return(0);
38: }
Enter a line of text.
This is the first line of text.
This is the first line of text.
Enter another line of text.
This is the second line of text.
This is the first line of text.This is the second line of text.

ANALYSIS: This program gets an input string on line 14, reading it into an array of characters called buf. The string is then copied into a memory location pointed to by message (line 19). message was allocated using realloc() on line 18. realloc() was called even though there was no previous allocation. By passing NULL as the first parameter, realloc() knows that this is a first allocation.

Line 28 gets a second string in the buf buffer. This string is concatenated to the string already held in message. Because message is just big enough to hold the first string, it needs to be reallocated to make room to hold both the first and second strings. This is exactly what line 32 does. The program concludes by printing the final concatenated string.

C Home | All C Tutorials | Latest C Tutorials

Sponsored Links

If this tutorial doesn't answer your question, or you have a specific question, just ask an expert here. Post your question to get a direct answer.

Bookmark and Share


1. View Comment

Very good

View Tutorial          By: take at 2010-03-29 07:47:01
2. View Comment

good explanation

View Tutorial          By: Naresh Kumar at 2010-10-25 00:28:18
3. View Comment

This is a bad example, it does not check if the allocation of memory worked. Also, you'd normally use malloc for the first allocation.

View Tutorial          By: Erik at 2011-02-12 07:16:20
4. View Comment

Looks good, but don't use gets(). gets() is responsible for the world's problems. Use fgets() and specify the buffer. Otherwise, some nasty fellow will be inclined to overstep the bounds of your array.

View Tutorial          By: Luke at 2011-11-21 09:03:38
5. View Comment

Really clear and lucid explanation abt realloc .... thnx a bunch!!!!!!!!

View Tutorial          By: metarus208 at 2012-01-01 14:25:25
6. View Comment


View Tutorial          By: Caterpillar at 2012-04-23 13:22:42
7. View Comment

Shouldn't you call free() on the allocated memory block?
Yes, you should !!!
The example of this articles leads to a memory leak.

View Tutorial          By: Ritchie at 2012-05-09 14:14:49
8. View Comment

Never use gets for taking inputs from users. Your program is prone to Buffer Overflows.

View Tutorial          By: Aneesh Dogra at 2012-07-20 04:08:32

Your name (required):

Your email(required, will not be shown to the public):

Your sites URL (optional):

Your comments:

More Tutorials by Charles
arraycopy example in Java
Action listeners in JSF
Automatically Including Preludes and Codas in JSP
Using realloc() Function in C
Handling multiple buttons in HTML Form in Struts
Fopen and Getc implementation program in C
Pointers to Structures example program in C
Pointers vs. Multi-dimensional Arrays in C
getch and ungetch in C
Bitwise Operators in C
Variables and Arithmetic Expressions in C
Differences between JavaServer Faces technology and Struts
assert() example program in C++
'double buffering' Sample program in J2ME
Converting Default Function Arguments in C++ to Java

More Tutorials in C
Sum of the elements of an array in C
Printing a simple histogram in C
Sorting an integer array in C
Find square and square root for a given number in C
Simple arithmetic calculations in C
Command-line arguments in C
Calculator in C
Passing double value to a function in C
Passing pointer to a function in C
Infix to Prefix And Postfix in C
while, do while and for loops in C
Unicode and UTF-8 in C
Formatting with printf in C
if, if...else and switch statements in C with samples
Statements in C

More Latest News
Most Viewed Articles (in C )
Using memset(), memcpy(), and memmove() in C
Listing Files and Directories sample program in C
perror() Function - example program in C
Open, Creat, Close, Unlink system calls sample program in C
UNIX read and write system calls sample program in C
Using free() Function in C
assert() Function Example program in C
scanf and sscanf sample program in C
Sum of the elements of an array in C
Printing a simple histogram in C
lseek() sample program in C
Sorting an integer array in C
Find square and square root for a given number in C
Functions in C
goto and labels in C
Most Emailed Articles (in C)
Address Arithmetic and pointers in C
Macro Substitution using #define in C
Pointers to Structures example program in C
Getting Started with C
Variables and Arithmetic Expressions in C
register Variables in C
Trigonometric, Hyperbolic, Exponential and Logarithmic Functions in C
Printing a simple histogram in C
Symbolic Constants using #define in C
Arguments - Call by Value in C
Conditional Expressions in C
Functions returning non-integer values in C
Recursion in C
Tutorial on Complicated Declarations in C
Standard Input and Output in C