4D v14.3

DOCUMENT LIST

ホーム

 
4D v14.3
DOCUMENT LIST

DOCUMENT LIST 


 

DOCUMENT LIST ( pathname ; documents {; options} ) 
引数   説明
pathname  文字 in ボリューム、ディレクトリ、またはフォルダーへのパス名
documents  テキスト配列 in この場所にあるドキュメントの名前
options  倍長整数 in 取得するリストを指定するオプション

説明   

DOCUMENT LISTコマンド は、pathnameに渡すパス名にあるドキュメントの名前を要素とするテキスト配列documentsを生成します。

注: 引数pathname は絶対パス名だけを受け入れます。

options 引数を省略した場合、デフォルトで documents 配列にドキュメント名のみが返されます。options 引数にSystem Documentsテーマの以下の定数を渡すと、この動作を変更できます:

定数 コメント
Absolute path 倍長整数 2 documents配列は絶対パス名を格納
Ignore invisible 倍長整数 8 不可視ドキュメントをリストに含めない
Posix path 倍長整数 4 documents配列はPOSIXフォーマットパス名を格納
Recursive parsing 倍長整数 1 documents配列は指定したフォルダーに含まれるすべてのファイルとサブフォルダーを格納

注:

  • 相対モードにおけるRecursive parsingオプション (option 1のみ) では、プラットフォームに応じてサブフォルダー内のドキュメント名は":"または"\"から始まります。
  • 相対モードにおけるPosix pathオプション (option 4のみ) では、パスは"/"で始まりません。
  • 絶対モードにおけるPosix pathオプション (option 4 + 2) では、パスは常に"/"で始まります。

指定した場所にドキュメントがない場合、コマンドは空の配列を返します。pathnameに渡したパス名が無効だと、DOCUMENT LISTはファイルマネジャエラーを生成します。このエラーはON ERR CALLでインストールされるエラー処理メソッドを使用して、検知することができます。

フォルダー中のすべてのドキュメントをリスト (デフォルトシンタックス):

 DOCUMENT LIST("C:\\";arrFiles)

-> arrFiles:
        Text1.txt
        Text2.txt

絶対モードでフォルダー中のすべてのドキュメントをリスト:

 DOCUMENT LIST("C:\\";arrFiles; Absolute path)

-> arrFiles:
        C:\Text1.txt
        C:\Text2.txt

再帰 (相対) モードですべてのドキュメントをリスト:

 DOCUMENT LIST("C:\\";arrFiles;Recursive parsing)

-> arrFiles:
        Text1.txt
        Text2.txt
        \Folder1\Text3.txt
        \Folder1\Text4.txt
        \Folder2\Text5.txt
        \Folder2\Folder3\Picture1.png

再帰 (絶対) モードですべてのドキュメントをリスト:

 DOCUMENT LIST("C:\\MyFolder\\";arrFiles;Recursive parsing+Absolute path)

-> arrFiles:
        C:\MyFolder\MyText1.txt
        C:\MyFolder\MyText2.txt
        C:\MyFolder\Folder1\MyText3.txt
        C:\MyFolder\Folder1\MyText4.txt
        C:\MyFolder\Folder2\MyText5.txt
        C:\MyFolder\Folder2\Folder3\MyPicture1.png

再帰POSIX (相対) モードですべてのドキュメントをリスト:

 DOCUMENT LIST("C:\\MyFolder\\";arrFiles;Recursive parsing+Posix path)

-> arrFiles:
        MyText1.txt
        MyText2.txt
        Folder1/MyText3.txt
        Folder1/MyText4.txt
        Folder2/MyText5.txt
        Folder2/Folder3/MyPicture1.png

 
プロパティ 

プロダクト: 4D
テーマ: システムドキュメント
番号: 474

Errorシステム変数が更新されることがあります。

 
履歴 

初出: 4D v6
変更: 4D v13

 
参照 

FOLDER LIST
VOLUME LIST

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)

Inherited from : DOCUMENT LIST ( 4D v11 SQL Release 6)