참조서

FFI 내장 함수

• DTWF_APPEND

• DTWF_CLOSE

• DTWF_DELETE

• DTWF_INSERT

• DTWF_OPEN

• DTWF_READ

• DTWF_REMOVE

• DTWF_SEARCH

• DTWF_UPDATE

• DTWF_WRITE

DTWF_APPEND

목적

Net.Data 테이블의 내용을 텍스트 파일의 끝에 기록합니다.

형식

@DTWF_APPEND(filename, transform, delimiter, table, retry, rows)

@DTWF_APPEND(filename, transform, delimiter, table, retry)

@DTWF_APPEND(filename, transform, delimiter, table)

매개변수

표 167. DTWF_APPEND 매개변수

리턴 코드

표 168. DTWF_APPEND 리턴 코드

사용법 메모

파일의 현재 내용은 DTWF_APPEND 사용시의 결과에 영향을 주며 특히, 마지막 행의 마지막 컬럼의 내용에 영향을 줍니다. 개행 문자가 파일의 마지막 행의 마지막 컬럼 값에 후속되는 경우, 추가된 자료는 새로운 행에 놓입니다. 그렇지 않은 경우 추가된 자료는 파일의 마지막 행의 일부가 됩니다.

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "DELIMITED", " ;", myTable)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable)

예 3:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_APPEND(myFile, "ASCIITEXT", " ;", myTable, "0", "10")

DTWF_CLOSE

목적

DTWF_OPEN로 열린 파일을 닫습니다.

형식

@DTWF_CLOSE(filename, retry)

@DTWF_CLOSE(filename)

매개변수

표 169. DTWF_CLOSE 매개변수

리턴 코드

표 170. DTWF_CLOSE 리턴 코드

예

예 1:

@DTWF_CLOSE(myFile, "5")

DTWF_DELETE

목적

텍스트 파일에서 행을 삭제합니다.

형식

@DTWF_DELETE(filename, transform, delimiter, retry, rows, startrow)

@DTWF_DELETE(filename, transform, delimiter, retry, rows)

@DTWF_DELETE(filename, transform, delimiter, retry)

@DTWF_DELETE(filename, transform, delimiter)

매개변수

표 171. DTW_DELETE 매개변수

리턴 코드

표 172. DTWF_DELETE 리턴 코드

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "5000"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Delimited", "|", myWait, myRows)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_DELETE(myFile, "Asciitext", "|", "0", myRows, myStart)

DTWF_INSERT

목적

행을 텍스트 파일에 삽입합니다.

형식

@DTWF_INSERT(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_INSERT(filename, transform, delimiter, table, retry, rows)

@DTWF_INSERT(filename, transform, delimiter, table, retry)

@DTWF_INSERT(filename, transform, delimiter, table)

매개변수

표 173. DTWF_INSERT 매개변수

리턴 코드

표 174. DTWF_INSERT 리턴 코드

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "3000"
%}
@DTWF_INSERT(myFile, "Delimited", "|", myTable, myWait)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_INSERT(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_OPEN

목적

텍스트 파일을 엽니다.

형식

@DTWF_OPEN(filename, mode, retry)

@DTWF_OPEN(filename, mode)

매개변수

표 175. DTWF_OPEN 매개변수

리턴 코드

표 176. DTWF_OPEN 리턴 코드

사용법 메모

1. 파일이 존재하지 않으면, 파일명에 대한 절대 경로를 지정해야 하고 파일이 작성될 디렉토리는 FFI_PATH에 지정된 디렉토리와 일치해야 합니다. 절대 경로가 사용되지 않는 경우, 파일은 현재의 작업 디렉토리에서 열립니다.

2. DTWF_OPEN은 파일을 열어둡니다. 그렇지 않은 경우 각 플랫 파일 조작 후 파일이 닫힙니다.

3. DTWF_OPEN을 사용하여 파일이 열리는 횟수를 줄입니다. DTWF_OPEN을 사용하지 않으면, 각각의 플랫 파일 조작 후 파일이 닫힙니다. 파일은 DTWF_CLOSE를 사용하여 닫거나 매크로 처리가 종료될 때까지 열려 있습니다.

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myMode = "r+"
%}
@DTWF_OPEN(myFile, myMode, "1000")

DTWF_READ

목적

텍스트 파일의 행을 Net.Data 테이블에 읽어들입니다.

형식

@DTWF_READ(filename, transform, delimiter, table, retry, rows, startrow, columns)

@DTWF_READ(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_READ(filename, transform, delimiter, table, retry, rows)

@DTWF_READ(filename, transform, delimiter, table, retry)

@DTWF_READ(filename, transform, delimiter, table)

매개변수

표 177. DTWF_READ 매개변수

리턴 코드

표 178. DTWF_READ 리턴 코드

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
  myColumns = ""
%}
@DTWF_READ(myFile, "DELIMITED", ";", myTable, myWait, myRows,
             myStartrow, myColumns)

예 3:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_READ(myFile, "ASCIITEXT", ";", myTable)
@DTW_TB_TABLE(myTable,"BORDER","")

DTWF_REMOVE

목적

전체 파일을 삭제합니다.

형식

@DTWF_REMOVE(filename, retry)

@DTWF_REMOVE(filename)

매개변수

표 179. DTW_REMOVE 매개변수

리턴 코드

표 180. DTWF_REMOVE 리턴 코드

예

예 1:

%DEFINE myFile = "c:/private/myfile"
@DTWF_REMOVE(myFile)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myWait = "2000"
%}
@DTWF_REMOVE(myFile, myWait)

DTWF_SEARCH

목적

텍스트 파일에서 문자열을 탐색하여, 결과를 Net.Data 테이블에 리턴합니다.

형식

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry, rows, startrow)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry, rows)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor, retry)

@DTWF_SEARCH(filename, transform, delimiter, table, searchFor)

매개변수

표 181. DTWF_SEARCH 매개변수

리턴 코드

표 182. DTWF_SEARCH 리턴 코드

사용법 메모

1. DTWF_SEARCH 함수의 수행 결과 리턴되는 테이블에는 세 개의 컬럼이 있습니다. 처음 두 컬럼에는 일치하는 것이 발견된 행과 컬럼의 번호가 들어 있습니다. 마지막 컬럼에는 SearchFor 매개변수에 지정된 문자가 들어 있는 컬럼 값이 들어 있습니다. 예를 들어, 파일의 네 번째 행에서 컬럼 3에 일치하는 문자가 들어 있는 경우, 리턴된 테이블에는 첫번째 컬럼에 숫자 4를 갖는 행이 있어서 출처가 되는 파일의 행을 나타냅니다. 리턴된 테이블의 두 번째 컬럼에는 숫자 3이 있어서 일치하는 문자가 들어 있는 파일의 컬럼을 나타냅니다. 세 번째 컬럼에는 완전한 컬럼 값이 들어 있습니다.

2. SearchFor 매개변수는 delimiter 매개변수의 내용을 포함할 수 없습니다.

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  myWait = "1000"
  mySearch = "0123456789abcdef"
@DTWF_SEARCH(myFile, "DELIMITED", ";",
               myTable, mySearch, myWait)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
  mySearch = "answer:"
  myWait = "0"
  myRows = "0"
  myStartrow = "1"
%}
@DTWF_SEARCH(myFile, "DELIMITED", ";", myTable,
               mySearch, myWait, myRows, myStartrow)

DTWF_UPDATE

목적

텍스트 파일을 행을 Net.Data 테이블의 자료로 갱신합니다.

형식

@DTWF_UPDATE(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_UPDATE(filename, transform, delimiter, table, retry, rows)

@DTWF_UPDATE(filename, transform, delimiter, table, retry)

@DTWF_UPDATE(filename, transform, delimiter, table)

매개변수

표 183. DTWF_UPDATE 매개변수

리턴 코드

표 184. DTWF_UPDATE 리턴 코드

사용법 메모

파일이 존재하지 않으면, 파일명에 대한 절대 경로를 지정해야 하고 파일이 작성될 디렉토리는 FFI_PATH에 지정된 디렉토리와 일치해야 합니다. 절대 경로가 사용되지 않는 경우, 파일은 현재의 작업 디렉토리에서 열립니다.

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myWait = "1500"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Delimited", "|", myTable, myWait, myRows)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
   myStart = "1"
   myRows = "2"
%}
@DTWF_UPDATE(myFile, "Asciitext", "|", myTable, "0", myRows, myStart)

DTWF_WRITE

목적

Net.Data 테이블의 내용을 텍스트 파일에 기록합니다.

형식

@DTWF_WRITE(filename, transform, delimiter, table, retry, rows, startrow)

@DTWF_WRITE(filename, transform, delimiter, table, retry, rows)

@DTWF_WRITE(filename, transform, delimiter, table, retry)

@DTWF_WRITE(filename, transform, delimiter, table)

매개변수

표 185. DTWF_WRITE 매개변수

리턴 코드

표 186. DTWF_WRITE 리턴 코드

사용법 메모

파일이 존재하지 않으면, 파일명에 대한 절대 경로를 지정해야 하고 파일이 작성될 디렉토리는 FFI_PATH에 지정된 디렉토리와 일치해야 합니다. 절대 경로가 사용되지 않는 경우, 파일은 현재의 작업 디렉토리에서 열립니다.

예

예 1:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "DELIMITED", ";", myTable)

예 2:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000")

예 3:

%DEFINE {
  myFile = "c:/private/myfile"
  myTable = %TABLE
%}
@DTWF_WRITE(myFile, "ASCIITEXT", ";", myTable, "5000", "10", "50")