impASC

内容

  1. 1 説明
  2. 2 追加の情報
  3. 3 コマンドラインでの使用法
  4. 4 変数
  5. 5 説明
    1. 5.1 この関数を使用するタイミング
    2. 5.2 オプションツリーの詳細
  6. 6 サンプル
  7. 7 関連のXファンクション

説明

ASCIIファイルをインポートします。

追加の情報

この機能は Origin 8.5 SR0で更新されました。

コマンドラインでの使用法

  1. impASC fname:="c:\nitrogen.txt" options.sparklines:=0;
  2. impasc fname:="c:\vartest1.dat%(crlf)c:\vartest2.dat" options.impmode:=4;

変数

表示
名		 変数
名		 I/O
と
データ型		 デフォルト
値		 説明
ファイル名 fname

入力

string

fname$

 インポートするファイルの名前を指定します。
起動オプション menu

入力

int

1

 この変数は、メニューを制御するもので、実際にはこのXファンクションは使いません。


オプションリスト:

  • single:単一ASCII(&S)
    単一ASCII
  • multiple:複数ASCII
    複数ASCII
ファイル情報 trfiles

入力

TreeNode

<unassigned>

 これはファイルの基本情報を表示するダイアログボックス内で使われます。情報はOriginが自動的に検出します。
インポートオプション options

入力

TreeNode

<unassigned>

 ダイアログのインポートオプションを指定します。詳細は以下の説明をご覧下さい。
出力 orng

出力

Range

<active>

 これは出力範囲を指定するのに使用します。

ここに記載されているシンタックスをご覧ください。
ヘッダ情報 trheader

出力

TreeNode

<unassigned>

 出力ヘッダ情報この変数は内部的に使用されます。使わないでください。
インポートフィルタ trFilter

入力

TreeNode

<optional>

 ダイアログのフィルターオプションを指定します。この変数は内部的に使用されます。使わないでください。
ファイル情報保存インデックス findex

出力

int

<optional>

 目的のワークブックのファイル情報保存のインデックス番号を指定します。
繰り返しインポート reimp

入力

int

0

 現在のインポートが再インポートの処理かどうか指定します。この変数の使用はお勧めしません。

説明

この関数は、ダイアログのオプションを設定することで、ASCIIファイルをインポートします。これは、メニュー、ツールバーまたはコマンドウィンドウから実行できます。

この関数を使用するタイミング

Originは、ASCIIファイルをインポートする3つのツールを提供します。インポートウィザード, 単一ASCIIインポート, 複数ASCIIインポート.

インポートするファイルのデータ構造を知っている場合には、単一ASCIIインポートと複数ASCIIインポートが役に立ちます。

ファイルの構造について詳細に分からない場合、インポートウィザードを選択するのが良いです。インポートウィザードは、強力で、多用途であり、設定の確認のためのプレビュー領域だけでなく、多くのオプションを提供しています。

オプションツリーの詳細

利用可能な多くのインポートオプションについての詳細は、 impASC オプションのツリーノード情報のページ をご覧ください。

サンプル

ASCIIファイルをインポートするオプションは多くあるので、この関数にはダイアログを通してアクセスすることがほとんどです。しかし、自動的にファイルをインポートするスクリプトからアクセスすることもできます。このセクションでは、ダイアログとスクリプトの両方でimpAscにアクセスする方法を説明します。

以下のステップは、ヘッダ行を自動で判断してファイルをインポートする方法についてです。
  1. 新規ワークブックを作成します。
  2. 次のどちらかの方法でimpASC ダイアログを開きます。コマンドに impASC -d; を入力する。標準ツールバーで複数ASCIIのインポートをクリックする。メインメニューで、ファイル：インポート：M複数ASCIIを選びます。
  3. インポートしたいファイルを選びます。(この場合、<Origin Installation Folder>;\Samples\Import and Export\S15-125-03.dat).OKをクリックします。
  4. impASCダイアログで、 ダイアログテーマの隣にある矢印ボタンをクリックして、システムデフォルトを選択します。
  5. インポートオプションで、ヘッダ行ノードを開きます。サブヘッダ行の自動決定が選択されていることを確認します。
  6. OKをクリックして、ファイルをインポートします。ファイルがワークブックにインポートされ、ロングネーム、単位、スパークラインが正しくセットされます。
  1. 基本的な使用法
    impASC fname:= system.path.program$+"Samples\Import and Export\S15-125-03.dat";
  2. 次のスクリプトは、最初にXファンクションdlgFileを使って、1つのファイルを探すためにファイルを開くダイアログを開き、ファイル名を文字列変数fname$に保存します。そして、impASCはパラメータfnameを指定せずに使用することができます。
    dlgFile;
    impASC;
  3. impASCは、複数ファイルのインポートをサポートしているので、 通常この関数は、Xファンクションfindfilesと一緒に使うことができます。
    //データフォルダをセットします
    string path$ = system.path.program$+"Samples\Import and Export";
    // dlgPathを使って、フォルダのパスを参照し、パスをpath$に保存できます。
    // dlgPath;
    // データフォルダに移動
    cd path$;
    // s*.datに合致するすべてのファイルを見つける
    findFiles ext:=s*.dat;
    // ファイルのインポート
    impASC;

関連するXファンクション

impFile, impinfo, dlgPath, dlgFile, findFiles, cd