Files Functions


 

 


Api92::vat_MoveVar

The Api92::vat_MoveVar function moves a variable from a folder to an other folder.

  • Parameters :
    D0.w : Handle of source folder
    D1.w : Handle of destination folder
    D2.w : 0-based index of variable in the source folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_MoveSelection

The Api92::vat_MoveSelection function moves every selected files from a folder to an other folder.

  • Parameters :
    D0.w : Handle of source folder
    D1.w : Handle of destination folder
    D2.w : 0-based index of variable in the source folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_CopyVar

The Api92::vat_CopyVar function copies a variable from a folder in an other folder.

  • Parameters :
    D0.w : Handle of source folder
    D1.w : Handle of destination folder
    D2.w : 0-based index of variable in the source folder
  • Return Values :
    D1.w : Error Code
    No other register modified


Api92::vat_CopySelection

The Api92::vat_CopySelection function copies every selected files from a folder to an other folder

  • Parameters :
    D0.w : Handle of source folder
    D1.w : Handle of destination folder
  • Return Values :
    D1.w : Error Code
    No other register modified


Api92::vat_DeleteVar

The Api92::vat_DeleteVar function deletes a variable from a folder

  • Parameters :
    D0.w : Handle of the folder
    D2.w : 0-based index of variable in the VAT to delete
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_DeleteFolder

The Api92::vat_DeleteFolder function delete a folder, giving its handle.
  • Parameters :
    D0.w : Handle of the folder to delete
  • Return Values :
    D1.w : Error Code
    No other register modified

To delete a folder including all nested folders inside, use the api92::nf_DeleteFolder function


Api92::vat_Delete

The Api92::vat_Delete function delete a VAT entry, checking if it is a folder or a file

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
    D2.w : 0-based index of item in the VAT to delete
  • Return Values :
    D1.w : Error Code
    No other register modified

To delete a folder including all nested folders inside, use the api92::nf_DeleteFolder function


Api92::vat_DeleteSelection

The Api92::vat_DeleteSelection function deletes every selected variables in a folder
  • Parameters :
    D0.w : Handle of a folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_Rename

The Api92::vat_Rename function renames a VAT entry (a folder or a file)

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
    D2.w : 0-based index of variable in the VAT to rename
    A0.l : Address of 0-terminated new name of entry
  • Return Values :
    D1.w : Error Code
    No other register modified


Api92::vat_IndexToAddr

The Api92::vat_IndexToAddr function converts the variables ( d0, d2 ) that reprensent ( Folder Handle, File Index ) to the address of the entry in the VAT.

  • Parameters :
    D0.w : Handle of the folder
    D2.w : 0-based index of the variable
  • Return Values :
    D1.w : Error Code
    A0.l : Address of the entry in the VAT.
    No other register modified


Api92::GetTIOSFileName

The Api92::GetTIOSFileName function gets the TIOS file name of a variable, in "folder\file" format.

  • Parameters :
    D0.w : Handle of the program
    A0.l : Address of a buffer ( 18 bytes at min )
  • Return Values :
    D0.w : 0 if error. Else success
    No other register modified


Api92::vat_CreateFolder

The Api92::vat_CreateFolder function creates a new folder at the root of the calculator.

  • Parameters :
    D0.w : Flags of the folder
    A0.l : Address of the 0-terminated folder name
  • Return Values :
    D0.w : Handle of created folder if successful
    D1.w : Error Code
    No other register modified

Api92::vat_CreateVar

The Api92::vat_CreateVar function creates a new variable in a folder of the calculator.
  • Parameters :
    D0.w : Handle of folder
    D1.w : Flags of the variable
    D2.w : Size of file data ( real size of file = d2 + 2 )
    A0.l : Address of the 0-terminated file name
  • Return Values :
    D0.w : Handle of created file buffer if successful
    D1.w : Error Code
    A0.l : Address of created file buffer if successful
    No other register modified

Api92::vat_ToggleHide

The Api92::vat_ToggleHide function toggles Hide/Unhide attribute of a VAT entry.

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
    D2.w : 0-based index of variable in the VAT.
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ToggleHideSelection

The Api92::vat_ToggleHideSelection function toggles Hide/Unhide attribute of selected items in a VAT.
  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ToggleLock

The Api92::vat_ToggleLock function toggles Lock/Unlock attribute of a VAT entry.

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
    D2.w : 0-based index of variable in the VAT.
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ToggleHideSelection

The Api92::vat_ToggleLockSelection function toggles Lock/Unlock attribute of selected items in a VAT.
  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ToggleSelect

The Api92::vat_ToggleSelect function toggles Selected/Unselected attribute of a VAT entry.

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
    D2.w : 0-based index of variable in the VAT.
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_SelectAll

The Api92::vat_SelectAll function selects all items in a VAT

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
  • Return Values :
    No register modified

Api92::vat_DeselectAll

The Api92::vat_DeselectAll function deselects all items in a VAT

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
  • Return Values :
    No register modified

Api92::vat_CountSelection

The Api92::vat_CountSelection function counts the number of selected items in the VAT

  • Parameters :
    D0.w : Handle of a Variable Allocation Table (VAT)
  • Return Values :
    D0.w : Number of selected items
    No other register modified


Api92::vat_UnarchiveVar

The Api92::vat_UnarchiveVar function unarchives a variable from flash memory

  • Parameters :
    D0.w : Handle of the folder containing the file
    D2.w : 0-based index of variable in the folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_UnarchiveSelection

The Api92::vat_UnarchiveSelection function unarchives every selected variables in a folder

  • Parameters :
    D0.w : Handle of the folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ArchiveVar

The Api92::vat_ArchiveVar function archives a variable in flash memory

  • Parameters :
    D0.w : Handle of the folder containing the file
    D2.w : 0-based index of variable in the folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_ArchiveSelection

The Api92::vat_ArchiveSelection function archives every selected variables in a folder

  • Parameters :
    D0.w : Handle of the folder
  • Return Values :
    D1.w : Error Code
    No other register modified

Api92::vat_FindVarEverywhere

The Api92::vat_FindVarEverywhere function looks for a variable everywhere in the folders of the calculators.

  • Parameters :
    A0.l : Address of the 0-terminated file name to look for
  • Return Values :
    D0.w : Handle of the folder if found
    D1.w : Handle of the variable if found
    D2.w : NULL if not found. Else 1-based index of the var in the VAT handled by d0.w
    A0.l : Address of variable in memory if found
    A1.l : Address of the VAT entry if found
    No other register modified

Api92::vat_Find

The Api92::vat_Find function looks for an item in one VAT of the calculators (file/folder).

  • Parameters :
    D0.w : Handle of the folder
    A0.l : Address of the 0-terminated file name to look for
  • Return Values :
    D1.w : Handle of the variable if found
    D2.w : NULL if not found. Else 1-based index of the var in the VAT handled by d0.w
    A0.l : Address of variable in memory if found
    A1.l : Address of the VAT entry if found
    No other register modified

Api92::vat_FindHdl

The Api92::vat_FindHdl function looks for a handle in one VAT of the calculators (file/folder).

  • Parameters :
    D0.w : Handle of the folder
    D1.w : Handle of the item to look for
  • Return Values :
    D2.w : NULL if not found. Else 1-based index of the var in the VAT handled by d0.w
    A0.l : Address of variable in memory if found
    A1.l : Address of the VAT entry if found
    No other register modified

Api92::vat_FindHdlEverywhere

The Api92::vat_FindHdl function looks for a handle everywhere in the folders of the calculators.

  • Parameters :
    D0.w : Handle of the folder
    D1.w : Handle of the item to look for
  • Return Values :
    D2.w : NULL if not found. Else 1-based index of the var in the VAT handled by d0.w
    A0.l : Address of variable in memory if found
    A1.l : Address of the VAT entry if found
    No other register modified