farcalloc

farcalloc

Функция            Выделяет блок памяти в глобальной динамической
                   области памяти.

Синтаксис          #include<alloc.h>
                   void far * farcalloc(unsigned long nunits,
                                       unsigned long unitsz);

Файл, содержащий   alloc.h
прототип

Описание
                   Функция farcalloc  распределяет память в глобальной
                   динамической области памяти под  массив,  состоящий
                   из  nunits элементов,  причем каждый элемент длиной
                   unitsz байтов.

                   При распределении памяти в глобальной  динамической
                   области памяти помните следующее:

                   - Может  быть  выделена  вся  память с произвольной
                     выборкой (ЗУПВ).

                   - Могут быть выделены блоки, размером более 64К.

                   - Для  доступа  к  выделяемым  блокам  используются
                     "дальние" указатели (с атрибутом "far").

                   В моделях   памяти:  компактных,  больших  и  сверх
                   больших,  farcalloc соответствует calloc, однако не
                   идентична.   Она   использует  параметр  типа  long
                   unsigned, в то время, как обычные функции (например
                   malloc) используют параметры типа unsigned.

                   В модели   памяти  tiny  эту  функцию  использовать
                   нельзя.

Возвращаемое       Функция farcalloc возвращает указатель
значение           на новый блок, или NULL, если для размещения нового
                   блока не хватило памяти.

Переносимость      Функция уникальна для системы DOS.

Смотрите также     calloc, farcoreleft, farfree, farmalloc, malloc.

Пример:

#include<stdio.h>
#include<alloc.h>
#include<string.h>
#include<dos.h>

int main(void)
{
   char far *fptr;
   char *str = "Hello";
                   
   /* выделить память */
   fptr = farcalloc(10,sizeof(char));
   if(fptr)
   {
      /* скопировать строку "Hello" в выделенный блок памяти. */
      /* Замечание. Используется функция movedata, поскольку вы
                    можете работать в малой (small) модели памяти,
                    в которой нельзя использовать функции копирова-
                    ния строки, которые подразумевают, что пара-
                    метры имеют тип near */
      movedata(FP_SEG(str),FP_OFF(str),FP_SEG(fptr),FP_OFF(fptr),
               strlen(str));
      /* вывести строку. Обратите внимание на модификатор F*/
      printf(" Строка с указателем far: %Fs\n",fptr);
      /* освободить память */
      farfree(fptr);
   }
   return 0;
}