impASC
内容 |
説明
ASCIIファイルをインポートします。
追加の情報
この機能は Origin 8.5 SR0で更新されました。
コマンドラインでの使用法
impASC fname:="c:\nitrogen.txt" options.sparklines:=0;impasc fname:="c:\vartest1.dat%(crlf)c:\vartest2.dat" options.impmode:=4;
変数
| 表示 名 |
変数 名 |
I/O と データ型 |
デフォルト 値 |
説明 |
|---|---|---|---|---|
| ファイル名 | fname |
入力 string |
fname$ |
インポートするファイルの名前を指定します。 |
| 起動オプション | menu |
入力 int |
1 |
この変数は、メニューを制御するもので、実際にはこのXファンクションは使いません。
|
| ファイル情報 | 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にアクセスする方法を説明します。
- ダイアログを使ってimpAscにアクセスする
- 以下のステップは、ヘッダ行を自動で判断してファイルをインポートする方法についてです。
- 新規ワークブックを作成します。
- 次のどちらかの方法でimpASC ダイアログを開きます。コマンドに
impASC -d;を入力する。標準ツールバーで複数ASCIIのインポートをクリックする。メインメニューで、ファイル：インポート：M複数ASCIIを選びます。 - インポートしたいファイルを選びます。(この場合、<Origin Installation Folder>;\Samples\Import and Export\S15-125-03.dat).OKをクリックします。
- impASCダイアログで、 ダイアログテーマの隣にある矢印ボタンをクリックして、システムデフォルトを選択します。
- インポートオプションで、ヘッダ行ノードを開きます。サブヘッダ行の自動決定が選択されていることを確認します。
- OKをクリックして、ファイルをインポートします。ファイルがワークブックにインポートされ、ロングネーム、単位、スパークラインが正しくセットされます。
- スクリプトから impASC にアクセス
- 基本的な使用法
impASC fname:= system.path.program$+"Samples\Import and Export\S15-125-03.dat";
- 次のスクリプトは、最初にXファンクションdlgFileを使って、1つのファイルを探すためにファイルを開くダイアログを開き、ファイル名を文字列変数fname$に保存します。そして、impASCはパラメータfnameを指定せずに使用することができます。
dlgFile;impASC;
- impASCは、複数ファイルのインポートをサポートしているので、 通常この関数は、Xファンクションfindfilesと一緒に使うことができます。
- //データフォルダをセットします
string path$ = system.path.program$+"Samples\Import and Export";- // dlgPathを使って、フォルダのパスを参照し、パスをpath$に保存できます。
- // dlgPath;
- // データフォルダに移動
cd path$;- // s*.datに合致するすべてのファイルを見つける
findFiles ext:=s*.dat;- // ファイルのインポート
impASC;