Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
load_text_file [2017/01/24 17:24]
francisco [Inputs]
load_text_file [2026/08/28 03:25] (current)
hermann Sync from local documentation review
Line 3: Line 3:
 ===== Description ===== ===== Description =====
  
-This functor loads a text from a file. The file name and its path must be specified.+Loads text from a file.
  
 ===== Inputs ===== ===== Inputs =====
  
 ^ Name  ^ Type  ^ Description ​ ^ ^ Name  ^ Type  ^ Description ​ ^
-| Filename ​ | [[Generic ​filename type]]  | Name of the file that contains the strings ​to be loadedDinamica automatically determines ​the file format from a selected file extension  ​|+| Filename ​ | [[Generic ​Filename Type]]  | Name and path of the file to loadIf no path is given, ​the file is located relative to the model script |
  
 ===== Optional Inputs ===== ===== Optional Inputs =====
  
 ^ Name  ^ Type  ^ Description ​ ^ Default Value  ^ ^ Name  ^ Type  ^ Description ​ ^ Default Value  ^
-  ​Suffix Digits | [[Non negative integer value type]]  ​Number of digits used to represent the file name suffix. ​ 0 | +| Suffix Digits ​ | [[Non Negative Integer Value Type]]  ​Number of digits used to render Step as a filename ​suffix. ​If Step needs more digits than this, it is used unmodified. If zero, no suffix is added. This is an advanced port.   
-|  ​step | [[Non negative integer value type]]  | Current step or model iteration. Files with the same name and numbered suffixes will be loaded sequentially according ​to the model step  ​|  ​None +Step  | [[Non Negative Integer Value Type]]  | Current step or model iteration, appended to Filename as a numeric suffix; automatically bound to the innermost compatible containerThis is an advanced port.  ​.none  | 
- Workdir | [[Workdir ​type]]  | Workdir ​folder ​path.  |  ​None |+| Workdir ​ | [[Workdir ​Type]]  | Work directory Filename is relative to; may be a folder ​or a Zip archive. When not bound, the directory containing the script is used. This is an advanced port.  | .none  |
  
-===== Output ​=====+===== Outputs ​=====
  
 ^ Name  ^ Type  ^ Description ​ ^ ^ Name  ^ Type  ^ Description ​ ^
-| Text  | [[String ​type]]  | The string ​loaded ​by the functor.  |+| Text  | [[String ​Type]]  | Text loaded ​from the file.  |
  
 ===== Group ===== ===== Group =====
  
-[[Functor List#​Input/​Output | Input/​Output]]+[[Functor List#Input / Output | Input / Output]]
  
 ===== Notes ===== ===== Notes =====
  
-None.+If Step is .none, the loaded filename has no numeric suffix.
  
 ===== Internal Name ===== ===== Internal Name =====
  
 LoadTextFile LoadTextFile
 +