Interstage Data Effector ユーザーズガイド

C.4.3 AsisExecuteSort

■機能

入力ファイルよりソート式で指定した項目ごとにデータをソート、結果をファイルに出力します。

■記述形式

#include "libAsis.h"                /* 公開ヘッダ                         */



int AsisExecuteSort(

    ASISHANDLE      AHandle,         /* ハンドル                           */

    char            *CharacterCode,  /* 文字コード                         */

    char            *InFileType,     /* 入力ファイルタイプ                 */

    char            *InFile,         /* 入力ファイル                       */

    char            *OutFile,        /* 出力ファイル                       */

    char            *Ocondition,     /* ソート式                           */

    char            *Rcondition,     /* リターン式                         */

    char            *Reserve1,       /* リザーブ(NULL)                     */

    char            *Reserve2)       /* リザーブ(NULL)                     */

■パラメタ

データ型	パラメタ	用途	説明
ASISHANDLE	AHandle	入力	ハンドルを指定します。
char*	CharacterCode	入力	文字コードを指定します。 本パラメタを省略した場合(NULL指定時)、UTF-8が指定されたとみなします。
char*	InFileType	入力	入力ファイルタイプを指定します。 本パラメタを省略した場合(NULL指定時)、CSVが指定されたとみなします。
char*	InFile	入力	入力ファイルを指定します。 本パラメタを省略した場合(NULL指定時)、標準入力より入力します。
char*	OutFile	入力	出力ファイルを指定します。 本パラメタを省略した場合(NULL指定時)、標準出力に出力します。
char*	Ocondition	入力	ソート項目を指定するソート式を指定します。 ソート式の詳細については、“A.4 ソート式”を参照してください。 1〜1024バイトの範囲で指定してください。
char*	Rcondition	入力	リターン式を指定します。 リターン式の詳細については、“A.5 リターン式”を参照してください。 1〜65535バイトの範囲で指定してください。本パラメタを省略した場合(NULL指定時)、入力レコードがそのまま出力されます。
char*	Reserve1	-	NULLを指定します。
char*	Reserve2	-	NULLを指定します。

◆CharacterCode (文字コード)

設定	意味
UTF-8	UTF-8の場合
SHIFT-JIS	Shift_JISの場合
EUC	EUC-JPの場合

設定値を二重引用符(")で囲んで指定します。

◆InFileType (入力ファイルタイプ)

設定	意味
CSV	CSVの場合
XML	XMLの場合

設定値を二重引用符(")で囲んで指定します。

◆InFile (入力ファイル)

[図：入力ファイルタイプがCSVの場合]

[図：入力ファイルタイプがXMLの場合]

• 本パラメタを省略した場合(NULL指定時)、または物理ファイル名を省略した場合は標準入力より入力します。
• 入力ファイルタイプがCSV形式の場合で、スキーマ情報を指定する場合は、スキーマ情報ファイル名と各物理ファイル名をセミコロン(;)で接続します。
• 入力ファイルタイプがCSV形式の場合で、スキーマ情報を指定しない場合は、各物理ファイル名をカンマ(,)で接続します。
• スキーマ情報を指定した場合、物理ファイル名に指定した各ファイルの先頭行には項目名が記述されていないものとみなし、データとしてソート対象になります。
  スキーマ情報を指定しない場合、物理ファイル名に指定した各ファイルの先頭行には項目名が記述されているものとみなし、先頭行のデータをソート対象にしません。
• 入力ファイルタイプがXML形式で複数のファイルを指定する場合には 各物理ファイル名をカンマ(,)で接続します。

◆Rcondition (リターン式)

• 本パラメタを省略した場合(NULL指定時)、入力レコードがそのまま出力されます。
• 本パラメタ省略時、複数のCSVファイルを入力とし、各CSVファイルが同一フォーマットでない場合、エラーとなります。
• 入力ファイル形式とリターン式の関係は下記となります。

  InFileType	Rcondition	出力 形式	出力内容	条件
  XML	NULL	XML	入力レコード形式
  	項目を指定	CSV	指定項目
  CSV	NULL	CSV	入力レコード形式	全CSVファイル同一フォーマット
  	項目を指定	CSV	指定項目

■復帰値

復帰値	説明
ASIS_SUCCESS	関数が正常に終了したことを示します。
ASIS_ERROR	関数の実行時に問題が検出されたことを示します。

■関数の利用規則

• OutFileパラメタで指定したファイルが存在する場合は上書きします。