Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция htImport

htImport - Импорт данных из внешнего файла в таблицу HyTech

Назначение

Функция предназначена для выполнения операции переноса данных из внешнего файла в таблицу HyTech. Описатель таблицы HyTech должен быть построен до вызова этой функции (например, при помощи вызова htImportTitle() ).

Прототип

long HTAPI htImport(
  IMPMODE  	nMode,        	/* Тип импорта */
  char far 	*fpDstTabName,	/* Имя таблицы, образуемой при импорте */
  char far 	*fpReadPswd,  	/* Пароль доступа на чтение */
  char far 	*fpWritePswd, 	/* Пароль доступа на запись */
  int      	nOpenMode,    	/* Режим открытия образуемой таблицы */
  char far 	*fpSrcName,   	/* Имя исходного файла */
  char far 	*fpSrcTabName,	/* Имя таблицы для исходного ASCII файла */
  LPFORMAT 	fpFmt,        	/* Описатель форматов */
  int      	bLogFile,     	/* !=0 вести журнал импорта */
  int      	bToConst      	/* !=0 вывод в постоянную часть таблицы */
);

Параметры

nMode
задает тип импорта (IMPMODE)
fpDstTabName
задает имя таблицы HyTech, в которую будет выполнен перенос данных из внешнего файла. Таблица должна быть закрыта
fpReadPswd
задает строку, используемую в качестве пароля для доступа к таблице на чтение. Если пароля нет, можно задать NULL или пустую строку "".
fpWritePswd
задает строку, используемую в качестве пароля для доступа к таблице на запись. Если пароля нет, можно задать NULL или пустую строку "".
nOpenMode
задает режим открытия таблицы. Этот параметр нужен во избежание конфликтов в сети. Другие абоненты могут использовать таблицу для своих целей. Если выходная таблица в кодировке ANSI и режим открытия содержит флаг TAB_ANSI, то данные будут перекодироваться

из OEM в ANSI. Если этот флаг не установлен, данные перекодироваться не будут

fpSrcName
задает имя исходного файла с данными. Имя должно иметь соответствующее расширение.
fpSrcTabName
нужен только при импорте из текстового файла и задает имя таблицы HyTech, описывающей его структуру. Для файлов других форматов этот параметр следует задать как NULL.

Следует иметь в виду, что все данные в ASCII файле должны содержаться в символьном виде и длина каждой записи должна быть фиксированной. Каждая запись должна завершаться парой символов "\r\n", которая не считается телом записи

fpFmt
определяет форматы преобразования цифровых данных в символьные. Если параметр не задан (NULL), принимаются значения по умолчанию.
bLogFile
определяет необходимость ведения журнала импорта. Если он отличен от 0, будет вестись журнал импорта. Все отвергнутые в процессе импорта записи будут выведены в таблицу с именем PROBLEMi - журнал импорта
bToConst
задает режим выполнения импорта. Если параметр отличен от 0 и импортируемая таблица еще не содержит данных, внешние данные будут сразу перенесены в постоянную часть таблицы

Результат:

В качестве кода завершения функция возвращает длинное целое со знаком.

меньше 0L код ошибки
положительное число счетчик отвергнутых записей
0 отвергнутых записей не обнаружено