Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(095) 932-9212, 932-9213, 939-0783
E-mail: info@citforum.ru
Сервер содержит море(!) аналитической информации CIT Forum CD-ROM

LDLREAD(3X)

НАЗВАНИЕ
ldlread, ldlinit, ldlitem - работа с таблицей номеров строк, хранящейся в объектном файле обычного формата

СИНТАКСИС

	#include <stdio.h>
	#include <filehdr.h>
	#include <linenum.h>
	#include <ldfcn.h>
	
	int ldlread (ldptr, fcnindx, linenum, linent)
	LDFILE *ldptr;
	long fcnindx;
	unsigned short linenum;
	LINENO *linent;
	
	int ldlinit (ldptr, fcnindx)
	LDFILE *ldptr;
	long fcnindx;
	
	int ldlitem (ldptr, linenum, linent)
	LDFILE *ldptr;
	unsigned short linenum;
	LINENO *linent;

ОПИСАНИЕ
Функция ldlread предназначена для поиска информации в таблице номеров строк, хранящейся в объектном файле, указанном аргументом ldptr. Поиск начинается с информа- ции о первой строке некоторой функции и ограничивается данными, относящимися к этой функции. Функция задается аргументом fcnindx - индексом имени функции в таблице имен объектного файла. Ldlread читает информацию о пер- вой из строк, номер которой не меньше linenum, в об- ласть памяти с адресом linent.

Функции ldlinit и ldlitem совместно делают то же, что и ldlread. Вызов ldlinit (или ldlread) инициализирует по- иск, после чего ldlitem используется для извлечения последовательности элементов таблицы номеров строк, от- носящихся к одной функции. Ldlinit определяет, где на- ходятся данные о строках, принадлежащих функции fcnindx. Ldlitem ищет и читает информацию о первой из строк, номер которой не меньше linenum, в область памя- ти с адресом linent.

Все три функции возвращают значения SUCCESS или FAILURE. Ldlread возвращает FAILURE, если:

  1. В объектном файле нет таблицы номеров строк.
  2. Аргумент fcnindx не является индексом функции в таблице имен.
  3. В таблице номеров строк нет элемента с номером, не меньшим linenum.
Функция ldlinit возвращает FAILURE, если:
  1. В объектном файле нет таблицы номеров строк.
  2. Аргумент fcnindx не является индексом функции в таблице имен.
Функция ldlitem возвращает FAILURE, если:
  1. В таблице номеров строк нет элемента с номером, не меньшим linenum.
При редактировании связей вызывающей программы следует подключить библиотеку программ доступа к объектным фай- лам libld.a.

СМ. ТАКЖЕ
ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4).

Comments: info@citmgu.ru
Designed by Andrey Novikov
Copyright © CIT
Обновлено: 13.03.2015