===== AB_READSTRING =====


==== синтаксис ====

<code c>int AB_READSTRING(AB_STR_ITEM *,int rec_num, int field_ID);</code>


==== описание ====

Функция получает определенную строку от конкретной записи


==== параметры ====

   * **AB_STR_ITEM** - указатель на структуру AB_STR_ITEM. В нее будет записан результат.
   * **rec_num** - номер записи от которой нужно прочитать строку. Необходимо получать через функцию [[GetABRecNum]].
   * **field_ID** - ID поля, от которого необходимо прочитать строку. Получение ID см. в примере.


==== возвращаемое значение ====

   * **0** - в случае ошибки
   * **1** - в случае успешного выполнения

==== пример ====

<code c>
AB_STR_ITEM * st = new AB_STR_ITEM;
AB_GET_STRUCT abs;
int i = 0;

short* abd = (short*)get_AB_ITEMS_DESC();

//Ищем нужный ITEM_DESC
while(i!=AB_ITEM_FPI)
{
  if ( abd[ AB_ITEM_DESC_NUM_DISPLACE/sizeof(short) ] == AB_ITEM_FIELD_NAME )
    break;
  abd += AB_ITEM_DESC_SIZE/sizeof(short);
  i++;
}

abs.unk_02 = 2;
abs.rec_num = 1;
int num = GetABRecNum(&abs);

AB_READSTRING( st, num, abd[ AB_ITEM_DESC_ID_DISPLACE/sizeof(short) ] );
TEXTID name = AB_NAME_ITEM2TextID(st);  //получаем TEXTID с именем контакта
</code>

==== см. также ====

[[AB_NAME_ITEM2TextID]], [[get_AB_ITEMS_DESC]]