From 0345245e860375a32c9a437c4a9d9cae807134e9 Mon Sep 17 00:00:00 2001 From: Shashank Date: Mon, 29 May 2017 12:40:26 +0530 Subject: CMSCOPE changed --- modules/fileio/help/en_US/addchapter.sce | 11 + modules/fileio/help/en_US/copyfile.xml | 90 ++ modules/fileio/help/en_US/deletefile.xml | 62 + modules/fileio/help/en_US/directory/CHAPTER | 2 + modules/fileio/help/en_US/directory/chdir.xml | 96 ++ modules/fileio/help/en_US/directory/createdir.xml | 82 + modules/fileio/help/en_US/directory/dir.xml | 114 ++ modules/fileio/help/en_US/directory/isdir.xml | 73 + modules/fileio/help/en_US/directory/ls.xml | 99 ++ modules/fileio/help/en_US/directory/mkdir.xml | 164 ++ modules/fileio/help/en_US/directory/pwd.xml | 36 + modules/fileio/help/en_US/directory/removedir.xml | 76 + modules/fileio/help/en_US/directory/rmdir.xml | 107 ++ modules/fileio/help/en_US/dispfiles.xml | 57 + modules/fileio/help/en_US/fileinfo.xml | 225 +++ modules/fileio/help/en_US/findfiles.xml | 76 + modules/fileio/help/en_US/fprintfMat.xml | 150 ++ modules/fileio/help/en_US/fscanfMat.xml | 178 +++ modules/fileio/help/en_US/getURL.xml | 163 ++ modules/fileio/help/en_US/getmd5.xml | 65 + modules/fileio/help/en_US/io.xml | 63 + modules/fileio/help/en_US/isfile.xml | 71 + modules/fileio/help/en_US/listfiles.xml | 110 ++ modules/fileio/help/en_US/listvarinfile.xml | 100 ++ modules/fileio/help/en_US/maxfiles.xml | 63 + modules/fileio/help/en_US/mclearerr.xml | 80 + modules/fileio/help/en_US/mclose.xml | 131 ++ modules/fileio/help/en_US/mdelete.xml | 109 ++ modules/fileio/help/en_US/meof.xml | 124 ++ modules/fileio/help/en_US/merror.xml | 120 ++ modules/fileio/help/en_US/mfprintf.xml | 173 +++ modules/fileio/help/en_US/mfscanf.xml | 260 ++++ modules/fileio/help/en_US/mget.xml | 258 ++++ modules/fileio/help/en_US/mgetl.xml | 115 ++ modules/fileio/help/en_US/mgetstr.xml | 135 ++ modules/fileio/help/en_US/mopen.xml | 324 ++++ modules/fileio/help/en_US/movefile.xml | 101 ++ modules/fileio/help/en_US/mput.xml | 176 +++ modules/fileio/help/en_US/mputl.xml | 108 ++ modules/fileio/help/en_US/mputstr.xml | 109 ++ modules/fileio/help/en_US/mseek.xml | 146 ++ modules/fileio/help/en_US/mtell.xml | 115 ++ modules/fileio/help/en_US/newest.xml | 74 + modules/fileio/help/en_US/path_filename/CHAPTER | 2 + .../fileio/help/en_US/path_filename/basename.xml | 105 ++ .../fileio/help/en_US/path_filename/dirname.xml | 117 ++ .../fileio/help/en_US/path_filename/fileext.xml | 63 + .../fileio/help/en_US/path_filename/fileparts.xml | 108 ++ .../fileio/help/en_US/path_filename/filesep.xml | 46 + .../fileio/help/en_US/path_filename/fullfile.xml | 70 + .../fileio/help/en_US/path_filename/fullpath.xml | 76 + .../en_US/path_filename/get_absolute_file_path.xml | 87 ++ .../fileio/help/en_US/path_filename/getdrives.xml | 53 + .../help/en_US/path_filename/getlongpathname.xml | 90 ++ .../en_US/path_filename/getrelativefilename.xml | 85 ++ .../help/en_US/path_filename/getshortpathname.xml | 91 ++ .../help/en_US/path_filename/is_absolute_path.xml | 66 + .../help/en_US/path_filename/pathconvert.xml | 138 ++ .../fileio/help/en_US/path_filename/pathsep.xml | 46 + .../fileio/help/en_US/path_filename/splitURL.xml | 163 ++ .../fileio/help/en_US/path_filename/tempname.xml | 76 + modules/fileio/help/en_US/save_format.xml | 708 +++++++++ modules/fileio/help/en_US/scanf.xml | 85 ++ modules/fileio/help/en_US/scanf_conversion.xml | 157 ++ modules/fileio/help/fr_FR/addchapter.sce | 11 + modules/fileio/help/fr_FR/directory/CHAPTER | 2 + modules/fileio/help/fr_FR/directory/chdir.xml | 73 + modules/fileio/help/fr_FR/directory/mkdir.xml | 72 + modules/fileio/help/fr_FR/directory/pwd.xml | 38 + modules/fileio/help/fr_FR/directory/rmdir.xml | 51 + modules/fileio/help/fr_FR/path_filename/CHAPTER | 2 + .../fileio/help/fr_FR/path_filename/fullfile.xml | 51 + .../help/fr_FR/path_filename/getlongpathname.xml | 65 + .../help/fr_FR/path_filename/getshortpathname.xml | 65 + modules/fileio/help/images/img001.png | Bin 0 -> 3466 bytes modules/fileio/help/images/img002.png | Bin 0 -> 1772 bytes modules/fileio/help/ja_JP/addchapter.sce | 11 + modules/fileio/help/ja_JP/copyfile.xml | 181 +++ modules/fileio/help/ja_JP/deletefile.xml | 104 ++ modules/fileio/help/ja_JP/directory/CHAPTER | 2 + modules/fileio/help/ja_JP/directory/chdir.xml | 69 + modules/fileio/help/ja_JP/directory/createdir.xml | 58 + modules/fileio/help/ja_JP/directory/dir.xml | 114 ++ modules/fileio/help/ja_JP/directory/isdir.xml | 71 + modules/fileio/help/ja_JP/directory/ls.xml | 100 ++ modules/fileio/help/ja_JP/directory/mkdir.xml | 75 + modules/fileio/help/ja_JP/directory/pwd.xml | 42 + modules/fileio/help/ja_JP/directory/removedir.xml | 60 + modules/fileio/help/ja_JP/directory/rmdir.xml | 65 + modules/fileio/help/ja_JP/dispfiles.xml | 109 ++ modules/fileio/help/ja_JP/fileinfo.xml | 431 ++++++ modules/fileio/help/ja_JP/findfiles.xml | 137 ++ modules/fileio/help/ja_JP/fprintfMat.xml | 285 ++++ modules/fileio/help/ja_JP/fscanfMat.xml | 344 +++++ modules/fileio/help/ja_JP/getURL.xml | 287 ++++ modules/fileio/help/ja_JP/getmd5.xml | 102 ++ modules/fileio/help/ja_JP/io.xml | 102 ++ modules/fileio/help/ja_JP/isfile.xml | 136 ++ modules/fileio/help/ja_JP/listfiles.xml | 225 +++ modules/fileio/help/ja_JP/listvarinfile.xml | 196 +++ modules/fileio/help/ja_JP/maxfiles.xml | 119 ++ modules/fileio/help/ja_JP/mclearerr.xml | 151 ++ modules/fileio/help/ja_JP/mclose.xml | 252 ++++ modules/fileio/help/ja_JP/mdelete.xml | 206 +++ modules/fileio/help/ja_JP/meof.xml | 235 +++ modules/fileio/help/ja_JP/merror.xml | 234 +++ modules/fileio/help/ja_JP/mfprintf.xml | 305 ++++ modules/fileio/help/ja_JP/mfscanf.xml | 472 ++++++ modules/fileio/help/ja_JP/mget.xml | 485 ++++++ modules/fileio/help/ja_JP/mgetl.xml | 203 +++ modules/fileio/help/ja_JP/mgetstr.xml | 256 ++++ modules/fileio/help/ja_JP/mopen.xml | 632 ++++++++ modules/fileio/help/ja_JP/movefile.xml | 201 +++ modules/fileio/help/ja_JP/mput.xml | 330 ++++ modules/fileio/help/ja_JP/mputl.xml | 195 +++ modules/fileio/help/ja_JP/mputstr.xml | 215 +++ modules/fileio/help/ja_JP/mseek.xml | 283 ++++ modules/fileio/help/ja_JP/mtell.xml | 210 +++ modules/fileio/help/ja_JP/newest.xml | 132 ++ modules/fileio/help/ja_JP/path_filename/CHAPTER | 2 + .../fileio/help/ja_JP/path_filename/basename.xml | 84 ++ .../fileio/help/ja_JP/path_filename/dirname.xml | 91 ++ .../fileio/help/ja_JP/path_filename/fileext.xml | 62 + .../fileio/help/ja_JP/path_filename/fileparts.xml | 100 ++ .../fileio/help/ja_JP/path_filename/filesep.xml | 48 + .../fileio/help/ja_JP/path_filename/fullfile.xml | 70 + .../fileio/help/ja_JP/path_filename/fullpath.xml | 76 + .../ja_JP/path_filename/get_absolute_file_path.xml | 88 ++ .../fileio/help/ja_JP/path_filename/getdrives.xml | 55 + .../help/ja_JP/path_filename/getlongpathname.xml | 73 + .../ja_JP/path_filename/getrelativefilename.xml | 88 ++ .../help/ja_JP/path_filename/getshortpathname.xml | 71 + .../help/ja_JP/path_filename/is_absolute_path.xml | 68 + .../help/ja_JP/path_filename/pathconvert.xml | 112 ++ .../fileio/help/ja_JP/path_filename/pathsep.xml | 44 + .../fileio/help/ja_JP/path_filename/splitURL.xml | 144 ++ .../fileio/help/ja_JP/path_filename/tempname.xml | 74 + modules/fileio/help/ja_JP/save_format.xml | 1595 ++++++++++++++++++++ modules/fileio/help/ja_JP/scanf.xml | 156 ++ modules/fileio/help/ja_JP/scanf_conversion.xml | 335 ++++ modules/fileio/help/pt_BR/addchapter.sce | 11 + modules/fileio/help/pt_BR/directory/CHAPTER | 2 + modules/fileio/help/pt_BR/directory/chdir.xml | 69 + modules/fileio/help/pt_BR/fileinfo.xml | 206 +++ modules/fileio/help/pt_BR/getmd5.xml | 54 + modules/fileio/help/pt_BR/newest.xml | 73 + modules/fileio/help/pt_BR/path_filename/CHAPTER | 2 + .../pt_BR/path_filename/get_absolute_file_path.xml | 85 ++ .../pt_BR/path_filename/getrelativefilename.xml | 88 ++ modules/fileio/help/ru_RU/addchapter.sce | 11 + modules/fileio/help/ru_RU/copyfile.xml | 95 ++ modules/fileio/help/ru_RU/deletefile.xml | 62 + modules/fileio/help/ru_RU/directory/CHAPTER | 2 + modules/fileio/help/ru_RU/directory/chdir.xml | 98 ++ modules/fileio/help/ru_RU/directory/createdir.xml | 80 + modules/fileio/help/ru_RU/directory/dir.xml | 122 ++ modules/fileio/help/ru_RU/directory/isdir.xml | 75 + modules/fileio/help/ru_RU/directory/ls.xml | 103 ++ modules/fileio/help/ru_RU/directory/mkdir.xml | 176 +++ modules/fileio/help/ru_RU/directory/pwd.xml | 36 + modules/fileio/help/ru_RU/directory/removedir.xml | 86 ++ modules/fileio/help/ru_RU/directory/rmdir.xml | 102 ++ modules/fileio/help/ru_RU/dispfiles.xml | 62 + modules/fileio/help/ru_RU/fileinfo.xml | 229 +++ modules/fileio/help/ru_RU/findfiles.xml | 78 + modules/fileio/help/ru_RU/fprintfMat.xml | 150 ++ modules/fileio/help/ru_RU/fscanfMat.xml | 188 +++ modules/fileio/help/ru_RU/getmd5.xml | 66 + modules/fileio/help/ru_RU/io.xml | 67 + modules/fileio/help/ru_RU/isfile.xml | 74 + modules/fileio/help/ru_RU/listfiles.xml | 115 ++ modules/fileio/help/ru_RU/listvarinfile.xml | 105 ++ modules/fileio/help/ru_RU/maxfiles.xml | 66 + modules/fileio/help/ru_RU/mclearerr.xml | 79 + modules/fileio/help/ru_RU/mclose.xml | 128 ++ modules/fileio/help/ru_RU/mdelete.xml | 104 ++ modules/fileio/help/ru_RU/meof.xml | 125 ++ modules/fileio/help/ru_RU/merror.xml | 118 ++ modules/fileio/help/ru_RU/mfprintf.xml | 167 ++ modules/fileio/help/ru_RU/mfscanf.xml | 259 ++++ modules/fileio/help/ru_RU/mget.xml | 254 ++++ modules/fileio/help/ru_RU/mgetl.xml | 121 ++ modules/fileio/help/ru_RU/mgetstr.xml | 139 ++ modules/fileio/help/ru_RU/mopen.xml | 349 +++++ modules/fileio/help/ru_RU/movefile.xml | 102 ++ modules/fileio/help/ru_RU/mput.xml | 179 +++ modules/fileio/help/ru_RU/mputl.xml | 108 ++ modules/fileio/help/ru_RU/mputstr.xml | 110 ++ modules/fileio/help/ru_RU/mseek.xml | 155 ++ modules/fileio/help/ru_RU/mtell.xml | 110 ++ modules/fileio/help/ru_RU/newest.xml | 77 + modules/fileio/help/ru_RU/path_filename/CHAPTER | 2 + .../fileio/help/ru_RU/path_filename/basename.xml | 104 ++ .../fileio/help/ru_RU/path_filename/dirname.xml | 115 ++ .../fileio/help/ru_RU/path_filename/fileext.xml | 65 + .../fileio/help/ru_RU/path_filename/fileparts.xml | 110 ++ .../fileio/help/ru_RU/path_filename/filesep.xml | 47 + .../fileio/help/ru_RU/path_filename/fullfile.xml | 75 + .../fileio/help/ru_RU/path_filename/fullpath.xml | 86 ++ .../ru_RU/path_filename/get_absolute_file_path.xml | 86 ++ .../fileio/help/ru_RU/path_filename/getdrives.xml | 57 + .../help/ru_RU/path_filename/getlongpathname.xml | 85 ++ .../ru_RU/path_filename/getrelativefilename.xml | 85 ++ .../help/ru_RU/path_filename/getshortpathname.xml | 88 ++ .../help/ru_RU/path_filename/is_absolute_path.xml | 66 + .../help/ru_RU/path_filename/pathconvert.xml | 150 ++ .../fileio/help/ru_RU/path_filename/pathsep.xml | 47 + .../fileio/help/ru_RU/path_filename/tempname.xml | 78 + modules/fileio/help/ru_RU/save_format.xml | 892 +++++++++++ modules/fileio/help/ru_RU/scanf.xml | 79 + modules/fileio/help/ru_RU/scanf_conversion.xml | 158 ++ 211 files changed, 27708 insertions(+) create mode 100755 modules/fileio/help/en_US/addchapter.sce create mode 100755 modules/fileio/help/en_US/copyfile.xml create mode 100755 modules/fileio/help/en_US/deletefile.xml create mode 100755 modules/fileio/help/en_US/directory/CHAPTER create mode 100755 modules/fileio/help/en_US/directory/chdir.xml create mode 100755 modules/fileio/help/en_US/directory/createdir.xml create mode 100755 modules/fileio/help/en_US/directory/dir.xml create mode 100755 modules/fileio/help/en_US/directory/isdir.xml create mode 100755 modules/fileio/help/en_US/directory/ls.xml create mode 100755 modules/fileio/help/en_US/directory/mkdir.xml create mode 100755 modules/fileio/help/en_US/directory/pwd.xml create mode 100755 modules/fileio/help/en_US/directory/removedir.xml create mode 100755 modules/fileio/help/en_US/directory/rmdir.xml create mode 100755 modules/fileio/help/en_US/dispfiles.xml create mode 100755 modules/fileio/help/en_US/fileinfo.xml create mode 100755 modules/fileio/help/en_US/findfiles.xml create mode 100755 modules/fileio/help/en_US/fprintfMat.xml create mode 100755 modules/fileio/help/en_US/fscanfMat.xml create mode 100755 modules/fileio/help/en_US/getURL.xml create mode 100755 modules/fileio/help/en_US/getmd5.xml create mode 100755 modules/fileio/help/en_US/io.xml create mode 100755 modules/fileio/help/en_US/isfile.xml create mode 100755 modules/fileio/help/en_US/listfiles.xml create mode 100755 modules/fileio/help/en_US/listvarinfile.xml create mode 100755 modules/fileio/help/en_US/maxfiles.xml create mode 100755 modules/fileio/help/en_US/mclearerr.xml create mode 100755 modules/fileio/help/en_US/mclose.xml create mode 100755 modules/fileio/help/en_US/mdelete.xml create mode 100755 modules/fileio/help/en_US/meof.xml create mode 100755 modules/fileio/help/en_US/merror.xml create mode 100755 modules/fileio/help/en_US/mfprintf.xml create mode 100755 modules/fileio/help/en_US/mfscanf.xml create mode 100755 modules/fileio/help/en_US/mget.xml create mode 100755 modules/fileio/help/en_US/mgetl.xml create mode 100755 modules/fileio/help/en_US/mgetstr.xml create mode 100755 modules/fileio/help/en_US/mopen.xml create mode 100755 modules/fileio/help/en_US/movefile.xml create mode 100755 modules/fileio/help/en_US/mput.xml create mode 100755 modules/fileio/help/en_US/mputl.xml create mode 100755 modules/fileio/help/en_US/mputstr.xml create mode 100755 modules/fileio/help/en_US/mseek.xml create mode 100755 modules/fileio/help/en_US/mtell.xml create mode 100755 modules/fileio/help/en_US/newest.xml create mode 100755 modules/fileio/help/en_US/path_filename/CHAPTER create mode 100755 modules/fileio/help/en_US/path_filename/basename.xml create mode 100755 modules/fileio/help/en_US/path_filename/dirname.xml create mode 100755 modules/fileio/help/en_US/path_filename/fileext.xml create mode 100755 modules/fileio/help/en_US/path_filename/fileparts.xml create mode 100755 modules/fileio/help/en_US/path_filename/filesep.xml create mode 100755 modules/fileio/help/en_US/path_filename/fullfile.xml create mode 100755 modules/fileio/help/en_US/path_filename/fullpath.xml create mode 100755 modules/fileio/help/en_US/path_filename/get_absolute_file_path.xml create mode 100755 modules/fileio/help/en_US/path_filename/getdrives.xml create mode 100755 modules/fileio/help/en_US/path_filename/getlongpathname.xml create mode 100755 modules/fileio/help/en_US/path_filename/getrelativefilename.xml create mode 100755 modules/fileio/help/en_US/path_filename/getshortpathname.xml create mode 100755 modules/fileio/help/en_US/path_filename/is_absolute_path.xml create mode 100755 modules/fileio/help/en_US/path_filename/pathconvert.xml create mode 100755 modules/fileio/help/en_US/path_filename/pathsep.xml create mode 100755 modules/fileio/help/en_US/path_filename/splitURL.xml create mode 100755 modules/fileio/help/en_US/path_filename/tempname.xml create mode 100755 modules/fileio/help/en_US/save_format.xml create mode 100755 modules/fileio/help/en_US/scanf.xml create mode 100755 modules/fileio/help/en_US/scanf_conversion.xml create mode 100755 modules/fileio/help/fr_FR/addchapter.sce create mode 100755 modules/fileio/help/fr_FR/directory/CHAPTER create mode 100755 modules/fileio/help/fr_FR/directory/chdir.xml create mode 100755 modules/fileio/help/fr_FR/directory/mkdir.xml create mode 100755 modules/fileio/help/fr_FR/directory/pwd.xml create mode 100755 modules/fileio/help/fr_FR/directory/rmdir.xml create mode 100755 modules/fileio/help/fr_FR/path_filename/CHAPTER create mode 100755 modules/fileio/help/fr_FR/path_filename/fullfile.xml create mode 100755 modules/fileio/help/fr_FR/path_filename/getlongpathname.xml create mode 100755 modules/fileio/help/fr_FR/path_filename/getshortpathname.xml create mode 100755 modules/fileio/help/images/img001.png create mode 100755 modules/fileio/help/images/img002.png create mode 100755 modules/fileio/help/ja_JP/addchapter.sce create mode 100755 modules/fileio/help/ja_JP/copyfile.xml create mode 100755 modules/fileio/help/ja_JP/deletefile.xml create mode 100755 modules/fileio/help/ja_JP/directory/CHAPTER create mode 100755 modules/fileio/help/ja_JP/directory/chdir.xml create mode 100755 modules/fileio/help/ja_JP/directory/createdir.xml create mode 100755 modules/fileio/help/ja_JP/directory/dir.xml create mode 100755 modules/fileio/help/ja_JP/directory/isdir.xml create mode 100755 modules/fileio/help/ja_JP/directory/ls.xml create mode 100755 modules/fileio/help/ja_JP/directory/mkdir.xml create mode 100755 modules/fileio/help/ja_JP/directory/pwd.xml create mode 100755 modules/fileio/help/ja_JP/directory/removedir.xml create mode 100755 modules/fileio/help/ja_JP/directory/rmdir.xml create mode 100755 modules/fileio/help/ja_JP/dispfiles.xml create mode 100755 modules/fileio/help/ja_JP/fileinfo.xml create mode 100755 modules/fileio/help/ja_JP/findfiles.xml create mode 100755 modules/fileio/help/ja_JP/fprintfMat.xml create mode 100755 modules/fileio/help/ja_JP/fscanfMat.xml create mode 100755 modules/fileio/help/ja_JP/getURL.xml create mode 100755 modules/fileio/help/ja_JP/getmd5.xml create mode 100755 modules/fileio/help/ja_JP/io.xml create mode 100755 modules/fileio/help/ja_JP/isfile.xml create mode 100755 modules/fileio/help/ja_JP/listfiles.xml create mode 100755 modules/fileio/help/ja_JP/listvarinfile.xml create mode 100755 modules/fileio/help/ja_JP/maxfiles.xml create mode 100755 modules/fileio/help/ja_JP/mclearerr.xml create mode 100755 modules/fileio/help/ja_JP/mclose.xml create mode 100755 modules/fileio/help/ja_JP/mdelete.xml create mode 100755 modules/fileio/help/ja_JP/meof.xml create mode 100755 modules/fileio/help/ja_JP/merror.xml create mode 100755 modules/fileio/help/ja_JP/mfprintf.xml create mode 100755 modules/fileio/help/ja_JP/mfscanf.xml create mode 100755 modules/fileio/help/ja_JP/mget.xml create mode 100755 modules/fileio/help/ja_JP/mgetl.xml create mode 100755 modules/fileio/help/ja_JP/mgetstr.xml create mode 100755 modules/fileio/help/ja_JP/mopen.xml create mode 100755 modules/fileio/help/ja_JP/movefile.xml create mode 100755 modules/fileio/help/ja_JP/mput.xml create mode 100755 modules/fileio/help/ja_JP/mputl.xml create mode 100755 modules/fileio/help/ja_JP/mputstr.xml create mode 100755 modules/fileio/help/ja_JP/mseek.xml create mode 100755 modules/fileio/help/ja_JP/mtell.xml create mode 100755 modules/fileio/help/ja_JP/newest.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/CHAPTER create mode 100755 modules/fileio/help/ja_JP/path_filename/basename.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/dirname.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/fileext.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/fileparts.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/filesep.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/fullfile.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/fullpath.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/get_absolute_file_path.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/getdrives.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/getlongpathname.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/getrelativefilename.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/getshortpathname.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/is_absolute_path.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/pathconvert.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/pathsep.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/splitURL.xml create mode 100755 modules/fileio/help/ja_JP/path_filename/tempname.xml create mode 100755 modules/fileio/help/ja_JP/save_format.xml create mode 100755 modules/fileio/help/ja_JP/scanf.xml create mode 100755 modules/fileio/help/ja_JP/scanf_conversion.xml create mode 100755 modules/fileio/help/pt_BR/addchapter.sce create mode 100755 modules/fileio/help/pt_BR/directory/CHAPTER create mode 100755 modules/fileio/help/pt_BR/directory/chdir.xml create mode 100755 modules/fileio/help/pt_BR/fileinfo.xml create mode 100755 modules/fileio/help/pt_BR/getmd5.xml create mode 100755 modules/fileio/help/pt_BR/newest.xml create mode 100755 modules/fileio/help/pt_BR/path_filename/CHAPTER create mode 100755 modules/fileio/help/pt_BR/path_filename/get_absolute_file_path.xml create mode 100755 modules/fileio/help/pt_BR/path_filename/getrelativefilename.xml create mode 100755 modules/fileio/help/ru_RU/addchapter.sce create mode 100755 modules/fileio/help/ru_RU/copyfile.xml create mode 100755 modules/fileio/help/ru_RU/deletefile.xml create mode 100755 modules/fileio/help/ru_RU/directory/CHAPTER create mode 100755 modules/fileio/help/ru_RU/directory/chdir.xml create mode 100755 modules/fileio/help/ru_RU/directory/createdir.xml create mode 100755 modules/fileio/help/ru_RU/directory/dir.xml create mode 100755 modules/fileio/help/ru_RU/directory/isdir.xml create mode 100755 modules/fileio/help/ru_RU/directory/ls.xml create mode 100755 modules/fileio/help/ru_RU/directory/mkdir.xml create mode 100755 modules/fileio/help/ru_RU/directory/pwd.xml create mode 100755 modules/fileio/help/ru_RU/directory/removedir.xml create mode 100755 modules/fileio/help/ru_RU/directory/rmdir.xml create mode 100755 modules/fileio/help/ru_RU/dispfiles.xml create mode 100755 modules/fileio/help/ru_RU/fileinfo.xml create mode 100755 modules/fileio/help/ru_RU/findfiles.xml create mode 100755 modules/fileio/help/ru_RU/fprintfMat.xml create mode 100755 modules/fileio/help/ru_RU/fscanfMat.xml create mode 100755 modules/fileio/help/ru_RU/getmd5.xml create mode 100755 modules/fileio/help/ru_RU/io.xml create mode 100755 modules/fileio/help/ru_RU/isfile.xml create mode 100755 modules/fileio/help/ru_RU/listfiles.xml create mode 100755 modules/fileio/help/ru_RU/listvarinfile.xml create mode 100755 modules/fileio/help/ru_RU/maxfiles.xml create mode 100755 modules/fileio/help/ru_RU/mclearerr.xml create mode 100755 modules/fileio/help/ru_RU/mclose.xml create mode 100755 modules/fileio/help/ru_RU/mdelete.xml create mode 100755 modules/fileio/help/ru_RU/meof.xml create mode 100755 modules/fileio/help/ru_RU/merror.xml create mode 100755 modules/fileio/help/ru_RU/mfprintf.xml create mode 100755 modules/fileio/help/ru_RU/mfscanf.xml create mode 100755 modules/fileio/help/ru_RU/mget.xml create mode 100755 modules/fileio/help/ru_RU/mgetl.xml create mode 100755 modules/fileio/help/ru_RU/mgetstr.xml create mode 100755 modules/fileio/help/ru_RU/mopen.xml create mode 100755 modules/fileio/help/ru_RU/movefile.xml create mode 100755 modules/fileio/help/ru_RU/mput.xml create mode 100755 modules/fileio/help/ru_RU/mputl.xml create mode 100755 modules/fileio/help/ru_RU/mputstr.xml create mode 100755 modules/fileio/help/ru_RU/mseek.xml create mode 100755 modules/fileio/help/ru_RU/mtell.xml create mode 100755 modules/fileio/help/ru_RU/newest.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/CHAPTER create mode 100755 modules/fileio/help/ru_RU/path_filename/basename.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/dirname.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/fileext.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/fileparts.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/filesep.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/fullfile.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/fullpath.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/get_absolute_file_path.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/getdrives.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/getlongpathname.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/getrelativefilename.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/getshortpathname.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/is_absolute_path.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/pathconvert.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/pathsep.xml create mode 100755 modules/fileio/help/ru_RU/path_filename/tempname.xml create mode 100755 modules/fileio/help/ru_RU/save_format.xml create mode 100755 modules/fileio/help/ru_RU/scanf.xml create mode 100755 modules/fileio/help/ru_RU/scanf_conversion.xml (limited to 'modules/fileio/help') diff --git a/modules/fileio/help/en_US/addchapter.sce b/modules/fileio/help/en_US/addchapter.sce new file mode 100755 index 000000000..c22115ff3 --- /dev/null +++ b/modules/fileio/help/en_US/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Files : Input/Output functions",SCI+"/modules/fileio/help/en_US",%T); + diff --git a/modules/fileio/help/en_US/copyfile.xml b/modules/fileio/help/en_US/copyfile.xml new file mode 100755 index 000000000..6b1a79000 --- /dev/null +++ b/modules/fileio/help/en_US/copyfile.xml @@ -0,0 +1,90 @@ + + + + + copyfile + copies a file + + + Calling Sequence + copyfile(source, destination) + [status, message] = copyfile(source, destination) + + + + Arguments + + + source + + + a character string: a filename or a directory name. + + + + + destination + + a character string: a directory name. + + + + + + + Description + + copyfile(source,destination) copies the file or + directory source (and subdirectories) to the file or + directory destination. + + + If source is a directory, destination can not be a file. + + copyfile replaces existing files without warning. + + + + [status, message] = copyfile(source, destination) + copies source to destination, returning the status and a message. + + + Whatever the operating system, if the copy succeeds, the status is 1 + and the message is empty; if the copy fails, the status is 0 and the + message is not empty. + + + The timestamp given to the destination file is identical to that + taken from source file. + + + + Examples + + copyfile(SCI+"/etc/scilab.start",TMPDIR+"/scilab.start") + [status,message] = copyfile(SCI+"/etc/scilab.start",TMPDIR); + + + + See Also + + + movefile + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/deletefile.xml b/modules/fileio/help/en_US/deletefile.xml new file mode 100755 index 000000000..ad945f1b4 --- /dev/null +++ b/modules/fileio/help/en_US/deletefile.xml @@ -0,0 +1,62 @@ + + + + + deletefile + deletes a file + + + Calling Sequence + f = deletefile(filename) + + + Arguments + + + filename + + a string: a file name existing or not. + + + + f + + + a boolean: %t or %f. + + + + + + + Description + + This function deletes a file filename. If file filename has been deleted, it will return %t else + %f. + + + + Examples + []) then +deletefile(TMPDIR+'/filetodelete.txt') +end + +deletefile(TMPDIR+'/notexistingfile') + ]]> + + diff --git a/modules/fileio/help/en_US/directory/CHAPTER b/modules/fileio/help/en_US/directory/CHAPTER new file mode 100755 index 000000000..8f46dc5e9 --- /dev/null +++ b/modules/fileio/help/en_US/directory/CHAPTER @@ -0,0 +1,2 @@ +title= Directory + diff --git a/modules/fileio/help/en_US/directory/chdir.xml b/modules/fileio/help/en_US/directory/chdir.xml new file mode 100755 index 000000000..c81d92756 --- /dev/null +++ b/modules/fileio/help/en_US/directory/chdir.xml @@ -0,0 +1,96 @@ + + + + + chdir + changes Scilab current directory + + + cd + changes Scilab current directory + + + Calling Sequence + b = chdir(path) + realpath = cd(path) + cd path + + + + Arguments + + + b + + + a boolean %t if chdir operation is ok + + + + + path + + a character string + + + + realpath + + a character string, the real path name after pathname + conversion (see below) + + + + + + + Description + Change the current Scilab directory to those given by + path. + + + + Note that path conversion is performed and for example + SCI/modules/core/macros is a valid pattern for both Unix and Windows. + If path is empty change to "home" directory. + + + + + Examples + + + + See Also + + + pwd + + + SCI + + + SCIHOME + + + TMPDIR + + + + diff --git a/modules/fileio/help/en_US/directory/createdir.xml b/modules/fileio/help/en_US/directory/createdir.xml new file mode 100755 index 000000000..31e5fc6ff --- /dev/null +++ b/modules/fileio/help/en_US/directory/createdir.xml @@ -0,0 +1,82 @@ + + + + + createdir + makes new directory + + + Calling Sequence + createdir(dirname) + status = createdir(dirname) + + + + Arguments + + + dirname + + a character string. + + + + status + + a boolean. + + + + + + Description + + createdir(dirname) creates the directory + dirname in the current + directory, if dirname is not in the current + directory, specify the relative path to the current directory or the + full path for dirname. + + + [status] = createdir(dirname) creates the directory + dirname in the existing directory, returning the + status. Here, status is %T for + success and %F otherwise. + + + createdir is used by mkdir. + + + + Examples + + + + See Also + + + mkdir + + + rmdir + + + removedir + + + + diff --git a/modules/fileio/help/en_US/directory/dir.xml b/modules/fileio/help/en_US/directory/dir.xml new file mode 100755 index 000000000..4b75a2c16 --- /dev/null +++ b/modules/fileio/help/en_US/directory/dir.xml @@ -0,0 +1,114 @@ + + + + + dir + gets file list + + + Calling Sequence + dir path + S=dir([path]) + + + + Arguments + + + path + + a string matrix giving a directory pathname (eventually ended + by a pattern built with *). Default + value is . (a dot). + + + + + S + + + a tlist of type dir with fields : + name, date, bytes and isdir. + + + + + + + Description + + dir can be used to get the files which match + the patterns given by the path argument. + Patterns are given to the Unix ls or to the Windows + dir commands in order to get information about files. + Thus in order to write portable Scilab script valid wildcard patterns + for both OS are to be given. Note that pathname conversion is + performed and for example SCI/modules/core/macros/*.sci + is a valid pattern for both Unix and Windows. + + + The name field of the returned variable is the column vector + of the file names. + + + The date field of the returned variable is the column vector + of integers containing a last modification date coded in second from 1 Jan 1970. + + + The bytes field of the returned variable is the column vector + of integers containing the size of the files in bytes. + + + The isdir field of the returned variable is the column vector + of boolean true if the corresponding name is a directory. + + + The default display of the returned structure is a column formatted list + of files. It can be changed redefining the function %dir_p. + + + Since Scilab 5.3.1, a trailing "/" or "\" (see filesep) is displayed for each directory. + + + + Examples + + + + See Also + + + listfiles + + + findfiles + + + ls + + + fileinfo + + + date + + + + diff --git a/modules/fileio/help/en_US/directory/isdir.xml b/modules/fileio/help/en_US/directory/isdir.xml new file mode 100755 index 000000000..426e62bc7 --- /dev/null +++ b/modules/fileio/help/en_US/directory/isdir.xml @@ -0,0 +1,73 @@ + + + + + isdir + checks if argument is a directory path + + + Calling Sequence + r = isdir(path) + + + Arguments + + + path + + a character string or a matrix of strings: a directory pathname. + + + + r + + + a boolean: %t if path is a path to a directory. + + + + + + + Description + + r = isdir(path) checks if path is a path to a directory. + + + + Reference + + This function is based on the C function + stat. The SCI and ~ shortcuts for Scilab directory and home directory are handled. + + + + Examples + + + + See Also + + + isfile + + + fileinfo + + + + diff --git a/modules/fileio/help/en_US/directory/ls.xml b/modules/fileio/help/en_US/directory/ls.xml new file mode 100755 index 000000000..446ccdafc --- /dev/null +++ b/modules/fileio/help/en_US/directory/ls.xml @@ -0,0 +1,99 @@ + + + + + ls + shows files + + + Calling Sequence + + files = ls [path] + files = ls( [path] ) + + + + Arguments + + + path + + + a string matrix giving a directory pathname (eventually ended + by a pattern built with *). Default value is . (a dot). + + + + + files + + + a string column vector. By default it contains a column + formatted output. + + + + + + + Description + + ls can be used to list the files which match + the patterns given by the path argument. + Patterns are given to the Unix ls or to the Windows + dir commands in order to get information on files. + Thus in order to write portable Scilab script valid wildcard patterns + for both OS are to be given. Note that pathname conversion is + performed and for example SCI/modules/core/macros/*.sci is a valid + pattern for both Unix and Windows. + + + If you want to get a vector of all files matching a pattern use preferabily + the listfiles or the dir function. + + + + Please note that starting from the version 5.0 of Scilab, the second + input argument has been removed (a sequence of strings which can + be added under Unix systems: the Unix ls command + options). This option has been removed mainly for security and portability reasons. + + + + + Examples + + + + See Also + + + listfiles + + + findfiles + + + dir + + + fileinfo + + + + diff --git a/modules/fileio/help/en_US/directory/mkdir.xml b/modules/fileio/help/en_US/directory/mkdir.xml new file mode 100755 index 000000000..5c443f3b0 --- /dev/null +++ b/modules/fileio/help/en_US/directory/mkdir.xml @@ -0,0 +1,164 @@ + + + + + mkdir + makes a new directory + + + Calling Sequence + + mkdir(dirname) + mkdir(parentdir, dirname) + status = mkdir( ... ) + [status, msg] = mkdir( ... ) + + + + Arguments + + + dirname + + + a character string: a directory to create. + + + + + parentdir + + + a character string: a directory in which the new directory dirname will be created. + + + + + status + + + an integer: the status of the operation. + + + + + msg + + + a character string: a message about an error. + + + + + + + Description + + mkdir(dirname) creates the directory dirname in the current directory, if dirname represents a relative path. Otherwise, dirname represents an absolute path and mkdir attempts to create the absolute directory dirname. + + + mkdir(parentdir, dirname) creates the directory dirname in the directory parentdir (if parentdir is not existing it will be created), where parentdir is an absolute or relative pathname. + + + [status,msg] = mkdir(parentdir, dirname) creates the directory dirname in the existing directory parentdir, returning the status and the message about an error. + + + + + + status + + + msg + + + + + -2 + + + mkdir: An error occurred: A file with the same name already exists in dirname + + + + + + 0 + + + mkdir: An error occurred: Impossible to create directory dirname + + + + + + 1 + + + + + + + + + 2 + + + mkdir: An error occurred: This directory already exists in dirname + + + + + + + + Whatever the operating system, if the creating of directory + succeeds, the status is 1 and the message + msg is empty. + + + + Examples + + + + + + See Also + + + chdir + + + dir + + + rmdir + + + + diff --git a/modules/fileio/help/en_US/directory/pwd.xml b/modules/fileio/help/en_US/directory/pwd.xml new file mode 100755 index 000000000..79749a16f --- /dev/null +++ b/modules/fileio/help/en_US/directory/pwd.xml @@ -0,0 +1,36 @@ + + + + pwd + gets Scilab current directory + + + Calling Sequence + pwd + x = pwd() + + + + Description + + pwd returns in ans the Scilab current directory. + x = pwd() returns in x the Scilab current + directory. + + + + Examples + + + + See Also + + + chdir + + + + diff --git a/modules/fileio/help/en_US/directory/removedir.xml b/modules/fileio/help/en_US/directory/removedir.xml new file mode 100755 index 000000000..898997e87 --- /dev/null +++ b/modules/fileio/help/en_US/directory/removedir.xml @@ -0,0 +1,76 @@ + + + + + removedir + removes a directory + + + Calling Sequence + + removedir(dirname) + [status] = removedir(dirname) + + + + Arguments + + + dirname + + a character string. + + + + status + + a boolean. + + + + + + Description + + removedir(dirname) removes the directory dirname from the current directory. If the directory is not empty, files and subdirectories are removed. If dirname is not in the current directory, specify the relative path to the current directory or the full path for dirname. + + + [status] = removedir(dirname) removes the directory dirname and its contents from the current directory, returning the status. Here, status is %T for success and is %F for error. + + + removedir is used by rmdir. + + + + Examples + + + + See Also + + + createdir + + + mkdir + + + rmdir + + + + diff --git a/modules/fileio/help/en_US/directory/rmdir.xml b/modules/fileio/help/en_US/directory/rmdir.xml new file mode 100755 index 000000000..823f02de0 --- /dev/null +++ b/modules/fileio/help/en_US/directory/rmdir.xml @@ -0,0 +1,107 @@ + + + + + rmdir + removes a directory + + + Calling Sequence + + rmdir(dirname) + rmdir(dirname,'s') + [status, message] = rmdir(dirname,'s') + + + + Arguments + + + dirname + + a character string. + + + + 's' + + + a mark to remove directory dirname with + subdirectories. + + + + + status + + a boolean. + + + + message + + + a character string: a message about an error. + + + + + + + Description + + rmdir(dirname) removes the directory + dirname from the current directory. If the + directory is not empty, you must use the s argument. If + dirname is not in the current directory, specify + the relative path to the current directory or the full path for + dirname. + + + rmdir(dirname,'s') removes the directory dirname and its contents from the current directory. + + + [status, message] = rmdir(dirname,'s') removes the + directory dirname and its contents from the + current directory, returning the status, and a message. Here, + status is 1 for success and is 0 for error. + + + Whatever the operating system, if the removing of directory + succeeds, the status is 1 and the message + message is empty. + + + + Examples + + + + See Also + + + createdir + + + mkdir + + + removedir + + + + diff --git a/modules/fileio/help/en_US/dispfiles.xml b/modules/fileio/help/en_US/dispfiles.xml new file mode 100755 index 000000000..a384461f6 --- /dev/null +++ b/modules/fileio/help/en_US/dispfiles.xml @@ -0,0 +1,57 @@ + + + + + dispfiles + displays opened files properties + + + Calling Sequence + dispfiles([units]) + + + Arguments + + + units + + a vector of integer numbers, the file's logical units. By default all opened files. + + + + + + Description + + dispfiles displays properties of currently opened files. + + + + Examples + + + + See Also + + + file + + + mopen + + + + diff --git a/modules/fileio/help/en_US/fileinfo.xml b/modules/fileio/help/en_US/fileinfo.xml new file mode 100755 index 000000000..8d18b207e --- /dev/null +++ b/modules/fileio/help/en_US/fileinfo.xml @@ -0,0 +1,225 @@ + + + + + fileinfo + provides information about a file + + + Calling Sequence + [x, ierr] = fileinfo(files) + + + Arguments + + + files + + a character string or a string column vector, file + pathname. + + + + + x + + an integer vector of size 13 containing information or an + empty matrix if file does not exist. + + + If files is a string column vector, x will be a matrix of + size m x 13. + + + If a filename does not exist, it will return as output + information a line of size 13 with Nan + in each element of this line. + + + + + ierr + + error indicator, 0, if no error has occurred. + + + + + + Description + + x = fileinfo(file) returns: + + + + x(1) + + The file size + + + + x(2) + + The file mode (decimal value) + + + + x(3) + + The user id + + + + x(4) + + The group id + + + + x(5) + + The device number + + + + x(6) + + The date of last data modification + + + + x(7) + + The date of last file status change + + + + x(8) + + The date of last access + + + + x(9) + + The device type (if inode device) + + + + x(10) + + The blocksize for filesystem I/O (always 0 on Windows) + + + + x(11) + + The number of blocks allocated (always 0 on Windows) + + + + x(12) + + The inode + + + + x(13) + + The number of hard links + + + + + + References + + This function is an interface to the C function stat. + + + Permissions are typically specified as octal numbers: dec2oct(x(2)) to convert. + + Numeric mode is from one to four octal digits (0-7), derived by + adding up the bits with values 4, 2, and 1. Any omitted digits are assumed + to be leading zeros. The first digit selects the set user ID (4) and set + group ID (2) and sticky (1) attributes. The second digit selects + permissions for the user who owns the file: read (4), write (2), and + execute (1); the third selects permissions for other users in the file's + group, with the same values; and the fourth for other users not in the + file's group, with the same values. + + + So, to check permissions, it is necessary to use masks. Let us take an example: + In octal, x(2)=1664, so first digit corresponds to sticky attributes. The second + indicates that file owner has permission of writing and reading. It is the same + for other users in the file's group. Finally, others users has just right to read. + To apply a mask, it is simpler to look at this octal in binary. + So: x(2)= 1 110 110 100. + To check if the owner has write permission, we must take a look at the second triplet: 110 + and compare it with write permission 010. So, the operation is: 110 000 000 & 010 000 000. + If result is not null (it is the case here), owner has write permission. + + + + Examples + 0) then + disp('WRITE PERMISSION on this file.'); +else + disp('NO WRITE PERMISSION on this file.'); +end +// Checks read permission +if ( bitand( w(2), S_IREAD ) <> 0) then + disp('READ PERMISSION on this file.'); +else + disp('NO READ PERMISSION on this file.'); +end + +FILES = [SCI;SCIHOME;'not_exist_file';TMPDIR] +[X,ERRS] = fileinfo(FILES) + ]]> + + + See Also + + + getdate + + + file + + + dispfiles + + + newest + + + isdir + + + + diff --git a/modules/fileio/help/en_US/findfiles.xml b/modules/fileio/help/en_US/findfiles.xml new file mode 100755 index 000000000..157eb759c --- /dev/null +++ b/modules/fileio/help/en_US/findfiles.xml @@ -0,0 +1,76 @@ + + + + + findfiles + + finding all files with a given file specification + + + + Calling Sequence + f = findfiles() + f = findfiles(path) + f = findfiles(path, filespec) + + + + Arguments + + + path + + a character string, a path. + + + + filespec + + + a character stirng, a file specification, for example "*.sce". + + + + + f + + a column vector of strings, filenames. + + + + + + Description + + Finding all files with a given file specification + filespec. + + + + Examples + + + + See Also + + + listfiles + + + + diff --git a/modules/fileio/help/en_US/fprintfMat.xml b/modules/fileio/help/en_US/fprintfMat.xml new file mode 100755 index 000000000..0b3f6b0a0 --- /dev/null +++ b/modules/fileio/help/en_US/fprintfMat.xml @@ -0,0 +1,150 @@ + + + + + fprintfMat + writes a matrix in a file + + + Calling Sequence + fprintfMat(file, M [,format,text]) + + + Arguments + + + file + + a string, the pathname of the file to be written + + + + M + + a matrix of real numbers + + + + format + + a character string giving the format. This is an optional + parameter, the default value is "%lf". + + Supported format: + %[width].[precision]type or + %type, where: + + + width: an optional number that specifies the minimum number of characters output; + + + precision: an optional number that + specifies the maximum number of characters printed for all + or part of the output field, or the minimum number of + digits printed for integer values; + + + type: lf, lg, d, i, e, f, g (see scanf_conversion for details). + + + + + text + + + a row (column) vector of strings giving non numerical + comments stored at the beginning of the file. + + + + + + + Description + + The fprintfMat function writes a matrix in a + formated file. Each row of the matrix give a line in the file. If + text is given then the elements of + text are inserted elementwise at the beginning of the + file one element per line. + + + + Examples + + + + See Also + + + scanf_conversion + + + mclose + + + meof + + + mfprintf + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mscanf + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/fscanfMat.xml b/modules/fileio/help/en_US/fscanfMat.xml new file mode 100755 index 000000000..5f2b243e1 --- /dev/null +++ b/modules/fileio/help/en_US/fscanfMat.xml @@ -0,0 +1,178 @@ + + + + + fscanfMat + reads a matrix from a text file + + + Calling Sequence + M = fscanfMat(filename[, fmt]); + [M, text] = fscanfMat(filename [, fmt]); + + + + Arguments + + + filename + + + a character string giving the name of the file to be scanned. + + + + + fmt + + + a character string giving the format. This is an optional + parameter, the default value is "%lg". + + + Supported format: %[width].[precision]type or %type where: + + + width: optional number that specifies + the minimum number of characters output; + + + precision: optional number that + specifies the maximum number of characters printed for all + or part of the output field, or the minimum number of + digits printed for integer values. + + + type: lf, lg, d, i, e, f, g (see scanf_conversion). + + + + + M + + output variable. A matrix of real numbers. + + + + text + + + output variable. A column vector of strings. It is + comments in the beginning of the file filename. + + + + + + + Description + + The fscanfMat function is used to read a real + matrix from a text file. The first non-numeric lines of the file are + returned in text if requested and all the remaining + lines must have the same number of columns (column separator are assumed + to be either white spaces or tab characters, if there are the both, white + spaces are chosen by default). The number of columns of the matrix + will follow the number of columns found in the file and the number of + lines is fetched by detecting eof in the input file. This function can be + used to read back numerical data saved with the + fprintfMat (default separator used is a space). + + + fscanfMat supports files encoded as ANSI/ASCII and UTF-8. + + + To read a CSV formated file, the csvRead function is recommended. + + + + Examples + + fd = mopen(TMPDIR + "/Mat", "w"); + mfprintf(fd, "Some text.....\n"); + mfprintf(fd, "Some text again\n"); + a = rand(6,6); + for i = 1:6 , + for j = 1:6, mfprintf(fd, "%5.2f ", a(i,j));end; + mfprintf(fd, "\n"); + end + mclose(fd); + a1 = fscanfMat(TMPDIR + "/Mat") + + A = ones(5,5) + 0.1; + fprintfMat(TMPDIR + "/Matrix.txt", A, "%lg"); + B = fscanfMat(TMPDIR + "/Matrix.txt", "%lg"); + A == B + + C = [%nan, %inf, -%inf, 1]; + fprintfMat(TMPDIR + "/MatrixNANINF.txt", C); + D = fscanfMat(TMPDIR + '/MatrixNANINF.txt') + + + + + See Also + + + scanf_conversion + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + csvRead + + + + diff --git a/modules/fileio/help/en_US/getURL.xml b/modules/fileio/help/en_US/getURL.xml new file mode 100755 index 000000000..1223d4603 --- /dev/null +++ b/modules/fileio/help/en_US/getURL.xml @@ -0,0 +1,163 @@ + + + + + + getURL + + Download an URL (HTTP, HTTPS, FTP...) + + + + Calling Sequence + + filename = getURL(URL); + [filename, [content]] = getURL(URL [, targetDir [, username [, password]]]]); + [filename, [content]] = getURL(URL [, targetFile [, username [, password]]]]); + + + + + Arguments + + + URL + + String: An URL. Supported and tested: HTTP, HTTPS, FTP (IPv4 and IPv6) + + + + targetDir + + String optional parameter: In which directory the file will be stored (current directory if empty) + + + + targetFile + + String optional parameter: Where (and under which name) the file will be stored (current directory if empty) + + + + username + + String optional parameter: Username for the websites which require authentication + + + + password + + String optional parameter: Password for the websites which require authentication + + + + filename + + String: The path to the downloaded file + + + + content + + String: The content to the downloaded file + + + + + + + Description + + Download a file from an URL + + + getURL will download a file from a remote URL. By default, getURL will use the same name as provided in the URL. However, under some circumstances (for example, http://www.scilab.org/), the filename is not provided by the URL itself, getURL will rename the file to index.html + + + content contains the content of a page pointed by an URL. + + + This function is based on the curl library. + + + Username and Password can be specified for the websites which required authentication. The authentication method used is the CURLAUTH_ANY provided by CURLOPT_HTTPAUTH parameter of the libcurl library. + + IPv6 (and obviously IPv4) are supported out-of-the box by getURL. + + Proxy configuration is enabled in this version, it can be modified in the Preferences under the rubric "Internet". + + + The CURLOPT_FOLLOWLOCATION curl option is activated to make sure the download follow the URL. + + + + getURL is based on libcurl. The version of this library in the official Scilab binary has been compiled with HTTP, HTTPS, FTP and FTPS support. If Scilab has been installed through a packaging system in a distribution, it is likely that other protocols than HTTP, HTTPS and FTPS will work. However, they have not been tested enough. + + + + + + Examples + + + + // Will download the URL and name the file maths_simulation + getURL("http://www.scilab.org/products/scilab/features/maths_simulation"); + + // Save the Scilab homepage in the current directory (and rename the file) + getURL("http://www.scilab.org","scilab_homepage.html"); + + // Download a Scilab example and execute it + myFile = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR) + exec(myFile); + contour3d(); + + // Use authentication + getURL("http://httpbin.org/basic-auth/user/passwd",TMPDIR+"/testfile.html","user","passwd") + + // Needs IPv6 connectivity + getURL("http://ipv6.google.com/intl/en_com/images/srpr/logo3w.png") + + // Retrieve the content + [myFile, content] = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR) + + + + See Also + + + splitURL + + + + + + History + + + 5.5.0 + + Function getURL() introduced + + + + + + diff --git a/modules/fileio/help/en_US/getmd5.xml b/modules/fileio/help/en_US/getmd5.xml new file mode 100755 index 000000000..4e1aa6cee --- /dev/null +++ b/modules/fileio/help/en_US/getmd5.xml @@ -0,0 +1,65 @@ + + + + + getmd5 + get md5 checksum + + + Calling Sequence + res = getmd5(filename) + res = getmd5(ParamString,'string') + + + + Arguments + + + res + + md5 result (a string) + + + + filename + + filename (a string or a matrix of strings) + + + + ParamString + + a string or a matrix of strings + + + + + + Description + + getmd5 get md5 checksum of a file filename or a string ParamString. + + + + Examples + + + diff --git a/modules/fileio/help/en_US/io.xml b/modules/fileio/help/en_US/io.xml new file mode 100755 index 000000000..95ef2bcdf --- /dev/null +++ b/modules/fileio/help/en_US/io.xml @@ -0,0 +1,63 @@ + + + + + %io + a variable, which keeps standard input and standard output (file + descriptor) + + + + Calling Sequence + %io(1) + %io(2) + + + + Description + + %io(1) returns standard input (file descriptor 5). + + + %io(2) returns standard output (file descriptor 6). + + File descriptor 0 is the standard error. + + + Examples + + + + See Also + + + write + + + mfprintf + + + file + + + dispfiles + + + + diff --git a/modules/fileio/help/en_US/isfile.xml b/modules/fileio/help/en_US/isfile.xml new file mode 100755 index 000000000..cd2ef060f --- /dev/null +++ b/modules/fileio/help/en_US/isfile.xml @@ -0,0 +1,71 @@ + + + + + isfile + checks whether argument is an existing file + + + Calling Sequence + x = isfile(filenames) + + + Arguments + + + filenames + + a character string or a string matrix. + + + + x + + + a matrix of boolean (%t if filenames are + existing files). + + + + + + + Description + + x = isfile(filenames) checks whether filenames is an existing file or not (a + directory is not a file). See also isdir. + + + + Examples + + filenames = ls(SCI) + + x = isfile(filenames) + + isfile(SCI + '/etc') + isdir(SCI + '/etc') + + + + See Also + + + fileinfo + + + isdir + + + + diff --git a/modules/fileio/help/en_US/listfiles.xml b/modules/fileio/help/en_US/listfiles.xml new file mode 100755 index 000000000..500192171 --- /dev/null +++ b/modules/fileio/help/en_US/listfiles.xml @@ -0,0 +1,110 @@ + + + + + listfiles + list of files + + + Calling Sequence + files = listfiles(paths [, flag, flagexpand]) + + + Arguments + + + paths + + + a string matrix giving a set of pathnames (eventually ended by a pattern built with *). + + + + + flag, flagexpand + + + boolean optional parameters (default value is %t). + + + + + files + + a string matrix. + + + + + + Description + + listfiles can be used to list the files which match + the patterns given by one of the paths entries. + Patterns are given to the Unix ls or to the Windows + dir commands in order to get information about files. + Thus in order to write portable Scilab script valid wildcard patterns + for both OS are to be given. Note that pathname conversion is + performed and for example SCI/core/macros/*.sci is a valid + pattern for both Unix and Windows. + + + If flag is true the pathnames given by + paths are converted according to the getos() == 'Windows' + value (see also pathconvert). + Moreover, if flagexpand is true leading strings like + SCIHOME, SCI or + ~ are expanded using environment variables. + + + If the input argument paths is the name of a directory, the returned files + are the names relative to that directory. + + + If the input argument paths contains more than one element, or if it contains + a pattern (e.g. "/*", "*.c"), the returned files are the absolute paths (i.e. + file name prepended with the name of the directory). + + + + Examples + + + + + + History + + + 5.4.0 + If paths is not a single string, all returned files are homogenized with the absolute path form. + + + + + See Also + + + findfiles + + + basename + + + pathconvert + + + + diff --git a/modules/fileio/help/en_US/listvarinfile.xml b/modules/fileio/help/en_US/listvarinfile.xml new file mode 100755 index 000000000..2b766b9d6 --- /dev/null +++ b/modules/fileio/help/en_US/listvarinfile.xml @@ -0,0 +1,100 @@ + + + + listvarinfile + list of variables in a saved data file + + + Calling Sequence + listvarinfile(filename) + [names, typs, dims, vols] = listvarinfile(filename) + + + + Arguments + + + filename + + + a character string, the pathname of the file to be inspected. + + + + + nams + + + a matrix of strings, names of the variables saved in the file. + + + + + dims + + + a list, dimensions of the variables saved in the file. + + + + + typs + + + a numeric matrix, types of the variables saved in the file. + + + + + vols + + + a numeric matrix, size in bytes of the variables saved in the file. + + + + + + + Description + + This utility function lists "a la whos" the variables contained in + a Scilab data file produced by save. + + + + Hypermatrices are reported as plain mlists; + rationals and state-spaces are reported as plain tlists; + graphic handles are not recognized. + + + + + Examples + + + + See Also + + + whos + + + save + + + load + + + save_format + + + type + + + + diff --git a/modules/fileio/help/en_US/maxfiles.xml b/modules/fileio/help/en_US/maxfiles.xml new file mode 100755 index 000000000..119e1a4f1 --- /dev/null +++ b/modules/fileio/help/en_US/maxfiles.xml @@ -0,0 +1,63 @@ + + + + + maxfiles + sets the limit for the number of files a Scilab is allowed to have open simultaneously + + + Calling Sequence + r = maxfiles(newnumbermax) + + + Arguments + + + newnumbermax + + an integer the new value. + + + + r + + an integer: effective new value. + + + + + + Description + + maxfiles sets the limit for the number of files a Scilab is allowed to have open simultaneously. + + Minimum : 20 + Maximum : 100 + Default : 20 + + + Examples + + + + See Also + + + mopen + + + + diff --git a/modules/fileio/help/en_US/mclearerr.xml b/modules/fileio/help/en_US/mclearerr.xml new file mode 100755 index 000000000..e5ff6275b --- /dev/null +++ b/modules/fileio/help/en_US/mclearerr.xml @@ -0,0 +1,80 @@ + + + + + mclearerr + resets binary file access errors + + + Calling Sequence + mclearerr([fd]) + + + Arguments + + + fd + + + a scalar: the fd parameter returned by the + function mopen. -1 stands for last opened + file. Default value is -1. + + + + + + + Description + + The function mclearerr is used to reset the error + indicator and EOF indicator to zero. + + + + See Also + + + merror + + + mclose + + + mopen + + + mput + + + mget + + + mgetstr + + + mputstr + + + meof + + + mseek + + + mtell + + + + diff --git a/modules/fileio/help/en_US/mclose.xml b/modules/fileio/help/en_US/mclose.xml new file mode 100755 index 000000000..2c8a8a3a4 --- /dev/null +++ b/modules/fileio/help/en_US/mclose.xml @@ -0,0 +1,131 @@ + + + + + mclose + closes an opened file + + + Calling Sequence + + err = mclose([fd]) + mclose('all') + + + + Arguments + + + fd + + + a scalar: the fd parameter returned by the function mopen is used as a file descriptor. + + + + + err + + a scalar: an error indicator. + + + + + + Description + + mclose must be used to close a file opened by + mopen. If fd is omitted + mclose closes the last opend file. + + + mclose('all') closes all files opened by + file('open',..) or mopen. + + Be careful with this use of mclose because when + it is used inside a Scilab script file, it also closes the script and + Scilab will not execute commands written after + mclose('all'). + + + + + Examples + + + + + See Also + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + file + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/mdelete.xml b/modules/fileio/help/en_US/mdelete.xml new file mode 100755 index 000000000..f994f690f --- /dev/null +++ b/modules/fileio/help/en_US/mdelete.xml @@ -0,0 +1,109 @@ + + + + + mdelete + deletes file(s) + + + Calling Sequence + mdelete(filename) + + + Arguments + + + filename + + + a character string: the pathname of the file(s) to delete. + + + + + + + Description + + mdelete may be used to delete a file or a set of files if + filename contains meta-characters. + + + + Note that mdelete does not ask for confirmation + when you enter the delete command. + To avoid accidentally losing files, make sure that you have + accurately specified the items you want deleted. + + + + + Examples + + + + + See Also + + + mopen + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mprintf + + + mput + + + mputstr + + + mscanf + + + mseek + + + mtell + + + + diff --git a/modules/fileio/help/en_US/meof.xml b/modules/fileio/help/en_US/meof.xml new file mode 100755 index 000000000..1ba59a0cc --- /dev/null +++ b/modules/fileio/help/en_US/meof.xml @@ -0,0 +1,124 @@ + + + + + meof + checks if end of file has been reached + + + Calling Sequence + err=meof(fd) + + + Arguments + + + fd + + + a scalar: the fd parameter returned by the function mopen. -1 stands for last opened file. Default value is -1. + + + + + err + + a scalar: an error indicator. + + + + + + Description + + The function meof will return a non null value if + end of file has been reached in a previous call to + mget or mgetstr. The function + mclearerr is used to reset the error flag and EOF + flag to zero. + + + + Examples + + + + + See Also + + + mclose + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/merror.xml b/modules/fileio/help/en_US/merror.xml new file mode 100755 index 000000000..aaa9d2b8e --- /dev/null +++ b/modules/fileio/help/en_US/merror.xml @@ -0,0 +1,120 @@ + + + + + merror + tests the file access errors indicator + + + Calling Sequence + + err = merror([fd]) + [err, msg] = merror([fd]) + + + + Arguments + + + fd + + + a scalar: the fd parameter returned by the + function mopen is used as a file descriptor + (it's a positive integer). -1 stands for last opened file. The + default value is -1. + + + + + err + + a scalar: an error status number of the most + recent file I/O operation associated with the specified file. + + + If the most recent I/O operation performed on the specified + file was successful, the value of msg is empty + and merror returns an err + value of 0. + + + + + msg + + a string: an error string message. + + + + + + Description + + The function merror is used to test the file + access errors indicator returning non-zero if it is set. The error + indicator can only be reset by the mclearerr + function. + + + A nonzero err indicates that an error occurred in the most recent file I/O operation. The value of message is a string that can contain information about the nature of the error. If the message is not helpful, consult the C run-time library manual for your host operating system for further details. + + + + Examples + 0) then + mprintf('Problem\n'); +end +mclose(fd); + ]]> + + + See Also + + + mclearerr + + + mclose + + + mopen + + + mput + + + mget + + + mgetstr + + + mputstr + + + meof + + + mseek + + + mtell + + + + diff --git a/modules/fileio/help/en_US/mfprintf.xml b/modules/fileio/help/en_US/mfprintf.xml new file mode 100755 index 000000000..3a52b023e --- /dev/null +++ b/modules/fileio/help/en_US/mfprintf.xml @@ -0,0 +1,173 @@ + + + + + mfprintf + converts, formats, and writes data to a file + + + Calling Sequence + mfprintf(fd, format, a1, ..., an); + + + Arguments + + + fd + + + a scalar, file descriptor given by mopen + (it's a positive integer). + + + If fd equals 0 redirection in stderr. + + + If fd equals 6 redirection in stdout. + + + OBSOLETE: The value -1 refers to the + default file (i.e the last opened file). + + + + + format + + + a Scilab string describing the format to use to write the + remaining operands. The + + format + + operand follows, + as close as possible, the C + + printf + + format + operand syntax. + + + + + str + + a character string: a string to be scanned. + + + + a1, ..., an + + + the data to be converted and printed according to + the format parameter. + + + + + + + Description + + The mfprintf function is a interface for C-coded + version of fprintf function. + + + The mfprintf function writes formatted operands + to the file specified by the file desciptor fd. The + argument operands are formatted under control of the + format operand. + + + This function may be used to output column vectors of numbers + and string vectors without an explicit loop on the elements. In that + case this function iterates on the rows. The shortest vector gives the + number of time the format has to be iterated. + + + An homogeneous sequence of identical type parameters can be replaced + by a matrix. + + + + Examples + 0)) then + editor(TMPDIR+'/text.txt') +end +mfprintf(0,'stderr output.\n'); +mfprintf(6,'stdout output.\n'); + ]]> + + + See Also + + + mclose + + + meof + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + printf_conversion + + + + diff --git a/modules/fileio/help/en_US/mfscanf.xml b/modules/fileio/help/en_US/mfscanf.xml new file mode 100755 index 000000000..f41578f7e --- /dev/null +++ b/modules/fileio/help/en_US/mfscanf.xml @@ -0,0 +1,260 @@ + + + + + mfscanf + + reads input from the stream pointer stream (interface to the C + fscanf function) + + + + mscanf + + reads input from the standard input (interface to the C scanf + function) + + + + msscanf + reads its input from the character string (interface to the C + sscanf function) + + + + Calling Sequence + + [n, v_1,..., v_m] = mfscanf([niter,]fd, format) + L = mfscanf([niter,] fd,format) + + [n, v_1,..., v_m] = mscanf([niter,] format) + L = mscanf([niter,]format) + + [n, v_1,..., v_m] = msscanf([niter,]str, format) + L = msscanf([niter,] str, format) + + + + Arguments + + + format + + + a Scilab string describing the format to use to write the + remaining operands. The format operand + follows, as close as possible, the C printf + format operand syntax as described in + scanf_conversion. + + + + + fd + + + a positive integer: a file descriptor returned by the function + mopen. The value -1 refers to the last + opened file. + + + + + str + + a Scilab string or string vector. + + + + niter + + + an integer: the number of times the + format + to be used. + + + + + n + + an integer: the number of data read or -1 if EOL has been + encountered before any datum has been read. + + + + + v_i + + + Each function reads characters, interprets them according to a + format, and stores the results in its output + arguments. If more than n output arguments are + provided, the last ones v_n+1, ..., v_m are + set to empty matrices. + + + + + L + + + if all data are homogeneous they are stored in a unique vector + which is returned, otherwise subsequences of same data type are + stored in matrices and a mlist (with type + cblock) containing all the built matrices is + returned. + + + + + + + Description + + The mfscanf function reads characters from the + stream fd. + + + The mscanf function reads characters from Scilab + window. + + + The msscanf function reads characters from the + Scilab string str. + + + The niter optional argument specifies how many + time the format has to used. One iteration produces one line in the output + matrix. If niter==-1 the function iterates up to the + end of file. The niter default value is 1. + + Comments about precision: + + mfscanf is based on C function + fscanf. If you use '%f', + '%g', '%e' as format your data + will be cast to float and returned in a Scilab variable. + + + If this Scilab variable is a double then you can have some precision + errors. In this case, it is better to use '%lg' format. + + + + Examples + + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + scanf_conversion + + + + diff --git a/modules/fileio/help/en_US/mget.xml b/modules/fileio/help/en_US/mget.xml new file mode 100755 index 000000000..08029e57e --- /dev/null +++ b/modules/fileio/help/en_US/mget.xml @@ -0,0 +1,258 @@ + + + + + mget + reads byte or word in a given binary format and converts to + a double type + + + + mgeti + + reads byte or word in a given binary format and returns an int type + + + + Calling Sequence + + x = mget([n, type, fd]) + x = mgeti([n, type, fd]) + + + + Arguments + + + n + + a positive integer scalar: the number of items to be read. + + + + fd + + + a scalar: a file descriptor returned by the function mopen. -1 + stands for last opened file. Default value is + -1. + + + + + type + + + a string: the binary format used to write all the entries of + x. + + + + + x + + a vector of floating point or integer numbers. + + + + + + Description + + The mget function reads data in the input + specified by the stream parameter fd and returns a + vector of floating point data. + + + + The mgeti function reads data in the input + specified by the stream parameter fd and returns a + vector of integer data. + + + Data is read at the position at which the file pointer is currently + pointing and advances the indicator appropriately. + + + The type parameter is a conversion specifier + which may be set to any of the following flag characters (with default + value "l"): + + + + On Windows, default behavior is to skip byte 13 (0x0D). + mopen should be called with the + 'b' option, e.g. + fd1 = mopen(file1,'rb'), so that all bytes will be read + without exception. + + + Data type: + + + d + + double + + + + f + + float + + + + l + + long long int + + + + i + + int or long int + + + + s + + short + + + + c + + character + + + + Optional flag: + + + u.. + + unsigned (in combination with one of the above types) + + + + ..l + + + little endian (in combination with one of the above types) + + + + + ..b + + + big endian (in combination with one of the above types) + + + + + + Bytes read is automatically swapped if necessary (by checking + little=endian status). + + + This default swapping behavior can be suprressed by adding a flag in + the mopen function. + + + Formats "l", "d" and + "f" are only valid with the + mget function. + + + + Examples + mget(1,'ull',fd1) + write(%io(2),'Bug'); +end + +fd2=mopen(file2,'rb'); +if 1996<>mget(1,'ull',fd2) + write(%io(2),'Bug'); +end + +mclose(fd1); +mclose(fd2); + ]]> + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/mgetl.xml b/modules/fileio/help/en_US/mgetl.xml new file mode 100755 index 000000000..a60664261 --- /dev/null +++ b/modules/fileio/help/en_US/mgetl.xml @@ -0,0 +1,115 @@ + + + + + mgetl + reads lines from an text file + + + Calling Sequence + txt = mgetl(file_desc [,m]) + + + Arguments + + + file_desc + + + a character string giving the file name or an integer giving a logical unit returned by mopen. + + + + + m + + + an integer scalar: a number of lines to read. Default value is -1. + + + + + txt + + a column vector of strings. + + + + + + Description + + mgetl function allows to read a lines from an text file. + + + If m is omitted or is -1 all lines till end of file occurs are read. + + + If m is given mgetl tries to + read exactly m lines. This option is useful to + sequentialy read part of a file. In this case if an end of file (EOF) + occurs before m lines are read the read lines are + returned (it is possible to check if EOF had occurred using the + meof function) issued. + + + mgetl allows to read files coming from Unix, + Windows or Mac operating systems. + + + mgetl supports only UTF-8 and ANSI file encoding. + + + + Examples + + + + See Also + + + mputl + + + mclose + + + mfscanf + + + mget + + + mput + + + mgetstr + + + mopen + + + read + + + + diff --git a/modules/fileio/help/en_US/mgetstr.xml b/modules/fileio/help/en_US/mgetstr.xml new file mode 100755 index 000000000..c1d7d9da4 --- /dev/null +++ b/modules/fileio/help/en_US/mgetstr.xml @@ -0,0 +1,135 @@ + + + + + mgetstr + reads a character string from a file + + + Calling Sequence + str = mgetstr(n, [fd]) + + + Arguments + + + n + + non-negative integer: how many characters should be + read. + + + + + fd + + + an integer: file descriptor as returned by + mopen: where characters should be read. The value -1 stands for the last opened file and is the default. + + + + + str + + the character string to be read. + + + + + + Description + + The mgetstr function attempts to read up + to n characters from a file. If end of file is + reached before n characters are read, + mgetstr returns the properly read values + only. As a consequence, when the read cursor is already at the end + of the file when mgetstr is called, it returns + an empty string no matter what value is provided for + n. + + + + Examples + + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + "Input/Output functions" section + + + + + + diff --git a/modules/fileio/help/en_US/mopen.xml b/modules/fileio/help/en_US/mopen.xml new file mode 100755 index 000000000..f8efdd53f --- /dev/null +++ b/modules/fileio/help/en_US/mopen.xml @@ -0,0 +1,324 @@ + + + + + mopen + opens a file in Scilab + + + Calling Sequence + [fd, err] = mopen(file [, mode, swap ]) + + + Arguments + + + file + + a character string containing the path of the file to open. + + + + mode + + a character string specifying the access mode requested for the file. + + + + swap + + + a scalar. If swap is present and + swap = 0 then automatic bytes swap is + disabled. + + The default value is 1. + + + + err + + a scalar. Error indicator. + + + error value: + error message: + + + 0 + No error + + + -1 + no more logical units + + + -2 + cannot open file + + + -3 + no more memory + + + -4 + invalid name + + + -5 + invalid status + + + + + + fd + + + a scalar: a file descriptor (it's a positive integer). + + + + + + + Description + + mopen may be used to open a file in a way + compatible with the C fopen procedure. Without + swap argument the file is supposed to be coded in "little endian IEEE + format" and data are swapped if necessary to match the IEEE format of + the processor. + + + The mode parameter controls the access type requested for + the stream. The parameter can have one of the following values: + + + r + + opens for reading (default). The file must exist, otherwise it fails. + + + + w + + opens for writing. If the file exists, its contents are destroyed. + + + + a + + opens for appending. It creates the file if it does not exist. + + + + r+ + + opens for both reading and writing. The file must exist, otherwise it fails. + + + + w+ + + opens for both reading and writing. If the file exists, its contents are destroyed. + + + + a+ + + opens for both reading and appending. It creates the file if it does not exist. + + + + + + In addition, the following characters can be used to specify the type of file: + + + t + + text file. + + + + b + + binary file (default). + + + + + + The default access mode is 'rb' (binary + file reading). + + + + Note: on Windows, in text file mode, CR (carriage + return) - LF (linefeed) combinations are translated into + LF on reading, and LF are translated to CR-LF + combinations on writing. + + + + When you open a file for update, you can perform both input and output + operations on the resulting stream. However, an output operation cannot + be directly followed by an input operation without a file-positioning + operation (mseek function). Also, an input + operation cannot be directly followed by an output operation without an + intervening file positioning operation, unless the input operation + encounters the end of the file. + + + When you open a file for append (that is, when the + mode parameter is a or + a+), it is impossible to overwrite information + already in the file. You can use the mseek + function to reposition the file pointer to any position in the file, + but when output is written to the file, the current file pointer is + ignored. All output is written at the end of the file and the file + pointer is repositioned to the end of the output. + + + To open files in a way compatible with Fortran-like functions use function file. + + + + + + Examples + + + + + + + + + + + + + + + + See Also + + + file + + + mclose + + + merror + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/movefile.xml b/modules/fileio/help/en_US/movefile.xml new file mode 100755 index 000000000..44013df9d --- /dev/null +++ b/modules/fileio/help/en_US/movefile.xml @@ -0,0 +1,101 @@ + + + + + movefile + moves file or directory + + + Calling Sequence + movefile(source, destination) + [status, message] = movefile(source, destination) + + + + Arguments + + + source + + + a character string. + + + + + destination + + + a character string. + + + + + status + + + an integer: the status of the operation. + + + + + message + + + a character string: a message about an error. + + + + + + + + Description + + movefile(source, destination) moves the file or directory + source (and subdirectories) to the file or directory + destination. + + + If source is a directory, destination cannot be a file. + + movefile replaces existing files without + warning. + + + + [status, message] = movefile(source, destination) moves source to destination, returning the status and a message. + + + Whatever the operating system, if the move succeeds, the + status is 1 and the message is + empty; if the move fails, the status is 0 and the + message is not empty. + + + + Examples + + + + See Also + + + copyfile + + + + diff --git a/modules/fileio/help/en_US/mput.xml b/modules/fileio/help/en_US/mput.xml new file mode 100755 index 000000000..9fe4160ad --- /dev/null +++ b/modules/fileio/help/en_US/mput.xml @@ -0,0 +1,176 @@ + + + + + mput + writes byte or word in a given binary format + + + Calling Sequence + mput(x [, type, fd]) + + + Arguments + + + x + + a vector of floating point or integer type numbers + + + + fd + + + a scalar: a file descriptor returned by the function mopen. -1 + stands for last opened file. Default value is + -1. + + + + + type + + + a string: the binary format used to write all the entries of x. + + + + + + + Description + + The mput function writes data to the output specified by the + stream parameter fd. Data is written at the + position at which the file pointer is currently pointing and + advances the indicator appropriately. + + + The type parameter is a conversion specifier which may be set to any of the + following flag characters (with default value "l"): + + + + "l", "i", "s", "ul", "ui", "us", "d", "f", "c", "uc" + + + for writing respectively a long long, an int (long + int), a short, an unsigned long long int, an unsigned int (long int), an unsigned short, a double, a float, a char and an unsigned char. The bytes which are wrote are automatically swapped if necessary (by checking little-endian status) in order to produce machine independent binary files (in little-endian mode). This default swapping mode can be suppressed by adding a flag swap = 0 in the mopen function. + + + + + "..l" or "..b" + + + It is also possible to write in little-endian or big-endian + mode by adding a "l" or + "b" character at the end of a + type specification. For example + "db" will write a double in big-endian mode. + + + + + + + Examples + mget(1,'l') then pause,end +if 1996<>mget(1,'i') then pause,end +if 1996<>mget(1,'s') then pause,end +if 98<>mget(1,'c') then pause,end + +// force little-endian +if 1996<>mget(1,'ll') then pause,end +if 1996<>mget(1,'il') then pause,end +if 1996<>mget(1,'sl') then pause,end +if 98<>mget(1,'cl') then pause,end + +// force big-endian +if 1996<>mget(1,'lb') then pause,end +if 1996<>mget(1,'ib') then pause,end +if 1996<>mget(1,'sb') then pause,end +if 98<>mget(1,'cb') then pause,end + +mclose(); + ]]> + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/mputl.xml b/modules/fileio/help/en_US/mputl.xml new file mode 100755 index 000000000..7147e48d9 --- /dev/null +++ b/modules/fileio/help/en_US/mputl.xml @@ -0,0 +1,108 @@ + + + + + mputl + writes strings in a text file + + + Calling Sequence + r = mputl(txt, file_desc) + + + Arguments + + + r + + + returns %t or %f to check + if function has correctly wrote on the file. + + + + + file_desc + + + a character string giving the name of the file or + + + an integer scalar: a file descriptor returned by + mopen function. + + + + + txt + + a vector of strings. + + + + + + Description + + mputl function allows to write a vector of + strings as a sequence of lines in a text file. + + + mputl supports strings encoded as ANSI/ASCII and UTF-8. + + + + Examples + + + + See Also + + + mget + + + mgetl + + + mclose + + + mfprintf + + + mput + + + mputstr + + + mopen + + + write + + + + diff --git a/modules/fileio/help/en_US/mputstr.xml b/modules/fileio/help/en_US/mputstr.xml new file mode 100755 index 000000000..364a45afb --- /dev/null +++ b/modules/fileio/help/en_US/mputstr.xml @@ -0,0 +1,109 @@ + + + + + mputstr + writes a character string in a file + + + Calling Sequence + mputstr(str [, fd]); + + + Arguments + + + fd + + + a scalar: a file descriptor returned by the function mopen. -1 stands for last opened file. Default value is -1. + + + + + str + + a character string. + + + + + + Description + + The mputstr function allows to write a character string str in a binary file. + + + + Examples + + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mseek + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/mseek.xml b/modules/fileio/help/en_US/mseek.xml new file mode 100755 index 000000000..f452d4e65 --- /dev/null +++ b/modules/fileio/help/en_US/mseek.xml @@ -0,0 +1,146 @@ + + + + + mseek + sets current position in a binary file + + + Calling Sequence + mseek(n [,fd, flag]) + + + Arguments + + + n + + a scalar: the offset in a number of bytes. + + + + fd + + + a scalar: a file descriptor returned by the function + mopen. -1 + stands for last opened file. Default value is + -1. + + + + + flag + + + a string: specifies the origin. Default value 'set'. + + + + + + + Description + + The function mseek sets the position of the next input or output operation on the stream fd. The new position is at the signed distance given by n bytes from the beginning, from the current position, or from the end of the file, according to the flag value which can be 'set', 'cur' or 'end'. This is the reason why n must be positive when flag is equal to 'set'. + + + mseek allows the file position indicator to be + set beyond the end of the existing data in the file. If data is + later written at this point, subsequent reads of data in the gap + will return zero until data is actually written into the gap. + mseek, by itself, does not extend the size of + the file. + + + + Examples + res then + write(%io(2),'Bug'); +end +mseek(0,fd1,'set'); + +// trying to read more than stored data +res1=mget(100,'d',fd1); +if res1<>res then + write(%io(2),'Bug'); +end +meof(fd1) +mclearerr(fd1) +mclose(fd1); + ]]> + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mtell + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/mtell.xml b/modules/fileio/help/en_US/mtell.xml new file mode 100755 index 000000000..4abf019be --- /dev/null +++ b/modules/fileio/help/en_US/mtell.xml @@ -0,0 +1,115 @@ + + + + + mtell + Returns the offset of the current byte relative to the beginning of a file + + + Calling Sequence + mtell([fd]) + + + Arguments + + + fd + + + a scalar: a file descriptor returned by the function + mopen. -1 + stands for last opened file. Default value is + -1. + + + + + + + Description + + The function mtell returns the offset of the + current byte relative to the beginning of the file associated with + the named stream fd. + + + + + Examples + + + + + See Also + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mdelete + + + + diff --git a/modules/fileio/help/en_US/newest.xml b/modules/fileio/help/en_US/newest.xml new file mode 100755 index 000000000..4fd84a386 --- /dev/null +++ b/modules/fileio/help/en_US/newest.xml @@ -0,0 +1,74 @@ + + + + + newest + returns newest file of a set of files + + + Calling Sequence + k = newest(paths) + k = newest(path1, path2, ..., pathn) + + + + Arguments + + + k + + an integer: the index of the newest file. + + + + paths + + + a character string vector, paths(i) is the pathname of i-th file. + + + + + pathi + + + a character string, the pathname of i-th file + + + + + + + Description + + Given a set of pathnames newest returns the index of the newest + one. Non existant files are supposed to be the oldest. + + + + Examples + + + + See Also + + + fileinfo + + + + diff --git a/modules/fileio/help/en_US/path_filename/CHAPTER b/modules/fileio/help/en_US/path_filename/CHAPTER new file mode 100755 index 000000000..7475b052d --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/CHAPTER @@ -0,0 +1,2 @@ +title = Paths - Filenames + diff --git a/modules/fileio/help/en_US/path_filename/basename.xml b/modules/fileio/help/en_US/path_filename/basename.xml new file mode 100755 index 000000000..4ce08a74a --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/basename.xml @@ -0,0 +1,105 @@ + + + + + basename + strip directory and suffix from filenames + + + Calling Sequence + processedfiles = basename(files[,flag [,flagexpand]]) + + + Arguments + + + files + + a string matrix giving a set of file names. + + + + flag + + optional boolean, used to convert the given path(s) for the current operating system. + Default value is true (%t). + + + + + flagexpand + + optional boolean, used to expand leading + variables in paths. Only used with + flag argument. Default value + is true (%t). + + + + + processedFiles + + a string matrix containing the processed filenames. + + + + + + Description + + basename(files) returns the suffixs of paths, i.e. the last string following the final file separator for each path given in files. + + + If flag is true the paths are first converted for the current operating system (for example, 'C:/Tmp/folder' will be converted on Windows to 'C:\Tmp\folder'). + + + if flagexpand is true, leading path variables (HOME, SCI, SCIHOME, ...) are expanded for the current operating system + (for example, 'HOME\tmp' will be converted on Linux to 'home/<user>/tmp', where <user> is the current user logged on). + + + See more details on flag and flagexpand in pathconvert section. + + + + Examples + + + + See Also + + + listfiles + + + pathconvert + + + fileparts + + + + diff --git a/modules/fileio/help/en_US/path_filename/dirname.xml b/modules/fileio/help/en_US/path_filename/dirname.xml new file mode 100755 index 000000000..80580d653 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/dirname.xml @@ -0,0 +1,117 @@ + + + + + dirname + gets directory from filenames + + + Calling Sequence + dirs = dirname(files[, flag [,flagexpand]]) + + + Arguments + + + files + + a string matrix containing file paths + + + + flag + + + optional boolean, used to convert the given + path(s) for the current operating system. + Default value is true (%t). + + + + + flagexpand + + + optional boolean, used to expand leading + variables in paths. Only used with + flag argument. Default value + is true (%t). + + + + + dirs + + string matrices + + + + + + Description + + dirname returns the directory paths of the file entries + given in files. + + + If flag is true the paths are first + converted for the current operating system (for example, + C:/Tmp/folder' will be converted on Windows to + 'C:\Tmp\folder'). + + + If flagexpand is true, leading path + variables (home, + SCI, SCIHOME, + ...) are expanded for the current operating system (for + example, 'home\tmp' will be converted on + GNU/Linux to 'home/<user>/tmp', + where <user> is the current user + logged on). + + + See more details on flag and + flagexpand + in pathconvert section. + + + + Examples + + + + See Also + + + basename + + + listfiles + + + pathconvert + + + + diff --git a/modules/fileio/help/en_US/path_filename/fileext.xml b/modules/fileio/help/en_US/path_filename/fileext.xml new file mode 100755 index 000000000..b009f7838 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/fileext.xml @@ -0,0 +1,63 @@ + + + + + fileext + returns extension for a file path + + + Calling Sequence + extension = fileext(fullpath) + + + Arguments + + + fullpath + + a string matrix, the given file path. + + + + extension + + + a string matrix, the extension part is any or ''. + + + + + + + Description + + extension = fileext(fullpath) splits the fullpath character string in the extension part including the dot. + + + + Examples + + + + See Also + + + fileparts + + + + diff --git a/modules/fileio/help/en_US/path_filename/fileparts.xml b/modules/fileio/help/en_US/path_filename/fileparts.xml new file mode 100755 index 000000000..55719a168 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/fileparts.xml @@ -0,0 +1,108 @@ + + + + + fileparts + returns the path, filename and extension for a file path + + + Calling Sequence + [path, fname, extension] = fileparts(fullpath) + value = fileparts(fullpath, sel) + + + + Arguments + + + fullpath + + a string or a string matrix, the given file path. + + + + sel + + a optional character string selector, with possible values: + 'path', 'fname' or 'extension'. + + + + + path + + + a string or a string matrix, the path of the directory pointed to by fullpath. + + + + + fname + + + a string or a string matrix, the filename part is any or ''. + + + + + extension + + + a string or a string matrix, the extension part is any or ''. + + + + + value + + + a string or a string matrix, depending on sel value. + + + + + + + Description + + [path, fname, extension] = fileparts(fullpath) splits the + fullpath character string in its three parts: the path of the + directory pointed to, the filename part, the extension part + including the dot. + + + + Examples + + + + See Also + + + pathconvert + + + basename + + + fullfile + + + + diff --git a/modules/fileio/help/en_US/path_filename/filesep.xml b/modules/fileio/help/en_US/path_filename/filesep.xml new file mode 100755 index 000000000..7302f2dc3 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/filesep.xml @@ -0,0 +1,46 @@ + + + + + filesep + returns directory separator for current platform + + + Calling Sequence + s = filesep() + + + Arguments + + + s + + a string + + + + + + Description + + The filesep returns directory separator ('/' on GNU/Linux or '\' on Windows). + + + + Examples + + + diff --git a/modules/fileio/help/en_US/path_filename/fullfile.xml b/modules/fileio/help/en_US/path_filename/fullfile.xml new file mode 100755 index 000000000..4929d894e --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/fullfile.xml @@ -0,0 +1,70 @@ + + + + + fullfile + builds a full filename from parts + + + Calling Sequence + f = fullfile(varargin) + + + Arguments + + + varargin + + + character strings, all directories and filename used to + build the full filename (at least one directory and + filename). + + + + + f + + + a character string or matrix of strings, full filename. + + + + + + + Description + + f = fullfile(varargin) builds a full filename taking care of platform on which it is run + and handling the cases when the directories begin or end with a directory separator. + + + + Examples + + + + See Also + + + pathconvert + + + fileparts + + + + diff --git a/modules/fileio/help/en_US/path_filename/fullpath.xml b/modules/fileio/help/en_US/path_filename/fullpath.xml new file mode 100755 index 000000000..d0a38b90b --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/fullpath.xml @@ -0,0 +1,76 @@ + + + + + fullpath + creates an full path name for the specified relative path name. + + + Calling Sequence + res = fullpath(relative_path) + + + Arguments + + + res + + a string or matrix of string. + + + + + + relative_path + + a string or a matrix of string. + + + + + + Description + + fullpath(relative_path) сreates a full path name + for the specified relative path name. + + + + Examples + + + + History + + + 5.4.0 + Matrix of String managed (SEP 72) + + + + diff --git a/modules/fileio/help/en_US/path_filename/get_absolute_file_path.xml b/modules/fileio/help/en_US/path_filename/get_absolute_file_path.xml new file mode 100755 index 000000000..2f39b7f6a --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/get_absolute_file_path.xml @@ -0,0 +1,87 @@ + + + + + get_absolute_file_path + + gives an absolute pathname of a file opened in Scilab + + + + Calling Sequence + pathname = get_absolute_file_path(filename) + + + Arguments + + + filename + + a character string: filename. + + + + pathname + + a character string: an absolute pathname. + + + + + + Description + + get_absolute_file_path gives an absolute pathname + of a file already opened in Scilab. + + + get_absolute_file_path searches in Scilab's + internal list of files currently opened filename + and returns its path pathname. + + If file is not opened, it will return an error. + + + In previous version (Scilab 5.0.x) current directory was + returned if file was not found. + + + This function can be used to find from where (path) is executed a + Scilab script. + + + + Examples + + + + See Also + + + getshortpathname + + + getlongpathname + + + pwd + + + + diff --git a/modules/fileio/help/en_US/path_filename/getdrives.xml b/modules/fileio/help/en_US/path_filename/getdrives.xml new file mode 100755 index 000000000..cefe023cd --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/getdrives.xml @@ -0,0 +1,53 @@ + + + + + getdrives + gets the drive letters of all mounted filesystems on the computer + + + Calling Sequence + drives = getdrives() + + + Arguments + + + drives + + a matrix of strings. + + + + + + Description + + The function getdrives gets the drive letters of all + mounted filesystems on the computer. + + + getdrives returns the roots of all mounted filesystems on the computer as a matrix of strings. + + + For GNU/Linux this list consists solely of the root directory, /. + + + + Examples + + + diff --git a/modules/fileio/help/en_US/path_filename/getlongpathname.xml b/modules/fileio/help/en_US/path_filename/getlongpathname.xml new file mode 100755 index 000000000..e2bb6382d --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/getlongpathname.xml @@ -0,0 +1,90 @@ + + + + + getlongpathname + gets long path name + + + Calling Sequence + + longpath = getlongpathname(shortpath) + [longpath, bOK] = getlongpathname(shortpath) + + + + Arguments + + + shortpath + + a character string or matrix of strings: the short path. + + + + longpath + + a character string or matrix of strings: the long path. + + + + bOK + + + a boolean or a matrix of boolean: %T if + path has been converted else %F. + + + + + + + Description + + The getlongpathname primitive converts the + specified path shortpath to its long form. If no long path is found, this + primitive returns the specified name. + + + + Note: If the path cannot be converted (bOK is %F) and in particular if the + operating system is not Windows, the returned long path is identical to the + input short path. + + + + + Examples + + + + + + See Also + + + getshortpathname + + + getrelativefilehname + + + pwd + + + + diff --git a/modules/fileio/help/en_US/path_filename/getrelativefilename.xml b/modules/fileio/help/en_US/path_filename/getrelativefilename.xml new file mode 100755 index 000000000..61e0bc4af --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/getrelativefilename.xml @@ -0,0 +1,85 @@ + + + + + getrelativefilename + given absolute directories and absolute filenames, returns relative file names + + + Calling Sequence + rel_file = getrelativefilename(abs_dir, abs_file) + + + Arguments + + + abs_dir + + a character string or matrix of character strings: absolute directories. + + + + abs_file + + a character string or matrix of character strings: absolute filenames. + + + + rel_file + + a character string or a matrix of character strings: relative filenames. + + + + + + Description + + Given absolute directories abs_dir and absolute filenames abs_file, getrelativefilename returns relative file names rel_file. That is, if the input arguments are some string matrices (m x n), for indexes (i, j), getrelativefilename returns rel_file(i,j) associated with abs_dir(i,j) and abs_file(i,j). + This implies that abs_dir and abs_file must have the same dimensions. + + + For example, if the current directory is + C:\scilab\bin and the filename + C:\scilab\modules\helptools\readme.txt is + given, getrelativefilename will return + ..\modules\helptools\readme.txt. + + + + Examples + + + + See Also + + + getshortpathname + + + getlongpathname + + + pwd + + + + diff --git a/modules/fileio/help/en_US/path_filename/getshortpathname.xml b/modules/fileio/help/en_US/path_filename/getshortpathname.xml new file mode 100755 index 000000000..1da4b574e --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/getshortpathname.xml @@ -0,0 +1,91 @@ + + + + + getshortpathname + gets short path name + + + Calling Sequence + + shortpath = getshortgpathname(longpath) + [shortpath, bOK] = getshortpathname(longpath) + + + + Arguments + + + longpath + + a character string or matrix of strings: the long path. + + + + shortpath + + + a character string or a matrix of strings: the short path. + + + + + bOK + + + a boolean or a matrix of boolean: %T if + path has been converted else %F. + + + + + + + Description + + The getshortpathname primitive converts the + specified path longpath to its short form. + + + + Note: If the path cannot be converted (bOK is %F) and in particular if the + operating system is not Windows, the returned short path is identical to the + input long path. + + + + + Examples + + + + + + See Also + + + getlongpathname + + + getrelativefilehname + + + pwd + + + + diff --git a/modules/fileio/help/en_US/path_filename/is_absolute_path.xml b/modules/fileio/help/en_US/path_filename/is_absolute_path.xml new file mode 100755 index 000000000..afaf4199b --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/is_absolute_path.xml @@ -0,0 +1,66 @@ + + + + + is_absolute_path + checks if argument is an absolute path + + + Calling Sequence + r = is_absolute_path(path) + + + Arguments + + + path + + a character string or a matrix of strings: a directory pathname. + + + + r + + + a boolean: %t if path is an absolute path. + + + + + + + Description + + r = is_absolute_path(path) checks if path is an absolute path. + + + + Examples + + + + See Also + + + get_absolute_file_path + + + fileparts + + + + diff --git a/modules/fileio/help/en_US/path_filename/pathconvert.xml b/modules/fileio/help/en_US/path_filename/pathconvert.xml new file mode 100755 index 000000000..85bffb99a --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/pathconvert.xml @@ -0,0 +1,138 @@ + + + + + pathconvert + converts a path to an OS path format. + + + Calling Sequence + paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]]) + + + Arguments + + + paths + + a string matrix giving a set of file paths + + + + flagtrail + + + optional boolean, used to add a trailing file separator to the + paths (\ or /, + depending on the target path format). Default value is true + (%t). + + + + + flagexpand + + + optional boolean, used to expand leading variables in paths. + Default value is true (%t). + + + + + type + + + optional string, used to specify the target path format: 'u' for POSIX path format (GNU/Linux,...), and 'w' for Windows path format. + + + + + + + Description + + pathconvert is used to convert a set of paths, + to be compatible with an OS (Operating System) path format. For example Windows path style uses / for file separator, while it is \ on other OS. + + + By default, the paths are converted to the current OS path format (but another path format can be specified with argument type). + + + + Note: Windows paths starting with a drive letter prefix are converted to + the POSIX paths using the cygwin convention (with /cygdrive). + For example: C:\tmp will be converted to /cygdrive/C/tmp. + + + + flagtrail is used to add or remove a file + separator (depending on the target path format) to the end + of paths. When the parameter is set to true, a trailing file + separator is added if missing. Otherwise, the trailing file + separators are removed. + + + flagexpand is used to expand the leading + Scilab environment variables in paths. The following + variables are accepted: + + + SCI + + + WSCI + + + SCIHOME + + + TMPDIR + + + home (or ~) + + + + WSCI is unknown on GNU/Linux and + ~ in term "path" is unknown on Windows. + + + + + Examples + + + + See Also + + + basename + + + listfiles + + + dirname + + + + diff --git a/modules/fileio/help/en_US/path_filename/pathsep.xml b/modules/fileio/help/en_US/path_filename/pathsep.xml new file mode 100755 index 000000000..d3f235bc2 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/pathsep.xml @@ -0,0 +1,46 @@ + + + + + pathsep + returns path separator for current platform + + + Calling Sequence + s = pathsep() + + + Arguments + + + s + + a string + + + + + + Description + + pathsep returns path separator (':' on GNU/Linux or ';' on Windows ). + + + + Examples + + + diff --git a/modules/fileio/help/en_US/path_filename/splitURL.xml b/modules/fileio/help/en_US/path_filename/splitURL.xml new file mode 100755 index 000000000..09809c551 --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/splitURL.xml @@ -0,0 +1,163 @@ + + + + + + splitURL + + Split an URL (HTTP, HTTPS, FTP...) + + + + Calling Sequence + + [proto, server, path, query, username, port, fragment] = splitURL(URL); + + + + + Arguments + + + URL + + String: An URL. Supported and tested: HTTP, HTTPS, FTP (IPv4 and IPv6) + + + + proto + + + String: the protocol (ex: http, ftp, etc) + + + + + server + + + String: the server (ex: www.scilab.org) + + + + + path + + + String: the path (ex: /products/scilab) + + + + + query + + + String: query (ex: ?SearchText=plot3d) + + + + + username + + + String: username (ex: username:pass) + + + + + port + + + int: port (ex: 80) + + + + Note that if the port is not provided in the URL, the value will be 0. + + + + + + fragment + + + String: fragment (ex: #chapter1) + + The fragment is also called anchor and it is used to create a bookmark inside an HTML document. + + + + + + + Description + + Split an URL by component + + + This function is based on the libxml2 library (in particular, the function xmlParseURI). + + + + + + Examples + + + [proto, server, path, query, username, port, fragment] = splitURL("http://xmlsoft.org/html/libxml-uri.html#xmlParseURI") + + [proto, server, path] = splitURL("ftp://ftp.free.fr/pub/Distributions_Linux/debian/README") + + [a,b,c,d]=splitURL("http://www.scilab.org/content/search?SearchText=plot") + + + + + + + + See Also + + + getURL + + + + + + History + + + 5.5.0 + + Function splitURL() introduced + + + + + + diff --git a/modules/fileio/help/en_US/path_filename/tempname.xml b/modules/fileio/help/en_US/path_filename/tempname.xml new file mode 100755 index 000000000..f49c2c82e --- /dev/null +++ b/modules/fileio/help/en_US/path_filename/tempname.xml @@ -0,0 +1,76 @@ + + + + + tempname + + creates a file with an unique filename + + + + Calling Sequence + tmp_name = tempname([prefix]) + + + Arguments + + + tmp_name + + a string + + + + + + prefix + + + a string: prefix of filename (On Windows, 3 characters maximum). + + + + + + + Description + + The tempname creates a file with an unique + filename in the TMPDIR directory. + + + tmp_name = tempname() returns an unique string, + tmp_name, suitable for use as a temporary filename. + + + + Examples + + + + History + + + 5.4.0 + + Function tempname introduced. + + + + + diff --git a/modules/fileio/help/en_US/save_format.xml b/modules/fileio/help/en_US/save_format.xml new file mode 100755 index 000000000..74a0960fd --- /dev/null +++ b/modules/fileio/help/en_US/save_format.xml @@ -0,0 +1,708 @@ + + + + + save format + format of files produced by "save" + + + Abstract + The goal of this document is to specify the HDF5 format used by Scilab to store its data. + The format is called SOD for Scilab Open Data. + The first public release of SOD has been done with Scilab 5.4.0. + + + Rationale + Interoperability is one of the key aspects of modern software. In order to improve more and more this aspect, a standard definition of the HDF5 format is proposed in this SEP. + Since Scilab 5.2.0, an export / import capability has been developed and maintain to exchange data. This is already one of the base components of Xcos to store and exchange data. + + + Supported data types + All Scilab data types are supported. For example: + + + + + Name + + + Example in Scilab + + + + + double + + + A=32; + b=[32,2]; + c=[2,2;3,4]; + d=rand(10,10); + + + + + string + + + a="my string"; + b=["string 1";"my string 2"]; + + + + + boolean + + + a=%t; + b=[%t, %f]; + + + + + integer + + + + int8([1 -120 127 312]) + x=int32(-200:100:400) + + + + + + polynomial + + + + s=poly([2 3],"s") + poly(1:4,'s','c') + + + + + + sparse + + + + sp=sparse([1,2;4,5;3,10],[1,2,3]) + + + + + + boolean sparse + + + + dense=[%F, %F, %T, %F, %F + %T, %F, %F, %F, %F + %F, %F, %F, %F, %F + %F, %F, %F, %F, %T]; + sp=sparse(dense) + + + + + + list + + + + l = list(1,["a" "b"]) + + + + + + tlist + + + + t = tlist(["listtype","field1","field2"], [], []); + + + + + + mlist + + + + M=mlist(['V','name','value'],['a','b';'c' 'd'],[1 2; 3 4]); + + + + + + + Several "types" are based on tlist or mlist. It is the case of rational, state-space, hypermat, cell and struct. They are therefore transparently saved. + + + void and undefined are two specific elements created to manage special cases in the list management. They are described later in this document. + + + + HDF5 File Structure + Scilab HDF5 architecture is pretty straightforward. + General + For each Scilab variable, a dataset at the root position is declared. The name of the dataset is the name of Scilab variable. + Example, the following code: + + emptyuint32matrix = uint32([]); + uint32scalar = uint32(1); + uint32rowvector = uint32([1 4 7]); + uint32colvector = uint32([1;4;7]); + uint32matrix = uint32([1 4 7;9 6 3]); + save("uint32.sod","emptyuint32matrix","uint32scalar","uint32rowvector","uint32colvector","uint32matrix"); + + produces: + + + + + + + Each root dataset has an attribute called SCILAB_Class. This attribute defines which types is the variable stored in the HDF5 file. + + If the variable is a primitive type and without complex values associated, data are stored directly into the dataset. Otherwise, the dataset contains references to the actual data. + Every SOD file contains two specific variables: + + + + SCILAB_scilab_version – Describe which version of Scilab has been used to save the SOD file. + + For example, with Scilab 5.4.0, the data will be: + + SCILAB_scilab_version = scilab-5.4.0 + + + + SCILAB_sod_version – Describe which version of the SOD specification has been used to save the file. + For example, with Scilab 5.4.0, the data will be: + + SCILAB_sod_version = 2 + + + + + Types where data are stored straight into the dataset. + + + + + + Scilab Type + + + HDF5 Scilab type attribute + + + HDF5 attributes + + + HDF data types mapping + + + + + string + + + SCILAB_Class = string + + + + + + String + + + + + boolean + + + SCILAB_Class = boolean + + + + + + 32-bit integer + + + + + integer + + + SCILAB_Class = integer + + + SCILAB_precision = {8, 16, 32, u8, u16, u32} + + + 8 = 8-bit character + 16 = 16-bit integer + 32 = 32-bit integer + u8 = 8-bit unsigned character + u16 = 16-bit unsigned integer + u32 = 32-bit unsigned integer + + + + + For these types, like in Scilab, the data are stored in a one dimension array. Data are stored by column wise. + To reconstruct the matrix, vector or scalar, two attributes provides the number of columns and rows. + + Since the 5.4.0 release of Scilab and SOD v2, SCILAB_cols and SCILAB_rows are no longer used for matrices of double, integer, polynomial and string. SOD uses the native multidimensional HDF5 feature. + + + Example + + + The saving of the declaration: int32([1 -4 7;-9 6 -3]) will be displayed as: + + + + + + + in hdfview. + And the metadata will be: + + int32matrix (800, 2) + 32-bit integer, 3 x 2 => the size of the variable + Number of attributes = 2 + SCILAB_Class = integer + SCILAB_precision = 32 + + + + Scalar value are stored as a matrix of size 1 by 1. + + + + An empty variable ([]) will have the attribute SCILAB_empty set to true. + + + Types where data are stored in a dedicated group + + Many of Scilab datatypes are stored using groups. This allows a clear separations of the value but also an easy access. + + Groups are named from the variables enclosed by "#". For example, for a matrix of double called matrixofdouble, the name of the root dataset will be matrixofdouble, the name of the associated group will be #matrixofdouble#. + + For recursive data type (list, mlist, tlist, etc), names of subgroup are constructed the following way: + + The # allows the creation of an unique identifier. The number of initial # shows the level of depth. Therefore, the sublist ###listnested#_#2##_#1## will indicate that it is located at the second level. + + The underscore "_" is a way to represent the depth. Usually, the "/" character is used in such case but it is a reserved keyword in the HDF5 specification. + + The integers used in the naming shows the position in the data structure, both in term of position in the current structure but also regarding the parent element. In the example, ###listnested#_#2##_#1##, the 1 shows that it is dealing with the second element of the third structure of the main element (elements are indexed from 0). + + + For example, the group named ###listnested#_#2##_#1##, will point to the value [32, 42] from the example: + + + listnested=list(2,%i,'f',ones(3,3)) + listnested(3) = list( %t, [32,42]); + + + Sparse + + + Scilab type: sparse + + + HDF5 Scilab type attribute: SCILAB_Class = sparse + + + HDF5 attributes: + + SCILAB_rows = <int> + Number of rows + + SCILAB_cols = <int> + + Number of columns + + SCILAB_items = <int> + + Define the number of elements in the sparse matrix + + Root dataset values: + + + First value (#0#): Each element of this data structure shows the number of non-null element per line. Therefore, the first element shows the number of element in the first line of the sparse matrix. + + + Second value (#1#): Provides the position of the column of each elements of the sparse matrix. + + + Third value (#2#): Stores the reference to the actual values of the element in the sparse matrix (which will be stored in a specific group). + + Example, taking this matrix: + + 0. 1. 0. 0. 0. 0. 0. 0. 0. 0. + 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. + 0. 0. 0. 0. 0. 0. 0. 0. 0. 3. + 0. 0. 0. 0. 2. 0. 0. 0. 0. 0. + + which is generated by the function: + + sparse([1,2;4,5;3,10],[1,2,3]) + + + will have: + + + #0# contains 1;0;1;1 + + + #1# contains 2;10;5 + + + #2# references a matrix of double (not complex in this example) which contains 1.0; 3.0; 2.0 + + + Boolean sparse + + + Scilab type: boolean sparse + + + HDF5 Scilab type attribute: SCILAB_Class = boolean sparse + + + HDF5 attributes: + + + SCILAB_rows = <int> + + Number of rows + + SCILAB_cols = <int> + + Number of columns + + SCILAB_items = <int> + + Define the number of elements in the sparse matrix + + Root dataset values: While a sparse has 3 datasets, the boolean sparse has only 2 because defined values are automatically considered as true. + + + First value (#0#): Each element of this data structure shows the number of non-null element per line. + + Therefore, the first element shows the number of element in the first line of the sparse matrix. + + Second value (#1#): Provides the position of the column of each elements of the sparse matrix. + + With the boolean sparse matrix: + + dense=[%F, %F, %T, %F, %F + %T, %F, %F, %F, %F + %F, %F, %F, %F, %F + %F, %F, %F, %F, %T]; + + + #0# contains 1;1;0;1. + + + #1# contains 3;1;5. + + Only the two information are necessary to recreate the boolean sparse. + HDF data types mapping: + 32-bit integer + + Double + + + Scilab type: double + + + HDF5 Scilab type attribute: SCILAB_Class = double + + + Root dataset values: Both real and complex values are stored in a group called #<variable name>#. + + + First value: Reference to the real values. Named #0#. + + + If the matrix is complex, the second value will reference the complex values. Named #1#. + + + HDF data types mapping: 64-bit floating-point + + + Polynomial + + + Scilab type: polynomial + + + HDF5 Scilab type attribute: SCILAB_Class = polynomial + + + HDF5 attributes: + + SCILAB_Class = polynomial + SCILAB_varname = <string> + The symbolic variable name + + SCILAB_Complex = <boolean> + + If the polynomial is complex (not set if false) + + Root dataset values: + + Coefficients are stored under the form of a matrix of double (cf the relative section to double storage). It is interesting to note that coefficients can be complex and, therefore, be stored as a matrix of complex. Rules of naming of the (sub-)groups and dataset are described at the beginning of the chapter. + + HDF data types mapping: Object reference + + + list + + + Scilab type: list + + + HDF5 Scilab type attribute: + + SCILAB_Class = list + + HDF5 attributes: SCILAB_items = <number of items in the list> + + + Root dataset values: + + + Associated to the root dataset, values stored in this dataset are the references to the values stored in the list. The values are stored in the group called #<variable name>#. In the #<variable name># group, data can be any type. They are included straight into the group. Their representations are the same as in other cases, based in recursive structure (meaning that list of list of list of various types can stored and loaded). + + Rules of naming of the (sub-)groups and dataset are described at the beginning of the chapter. + + HDF data types mapping: Object reference + + + tlist + + + Scilab type: tlist + + + HDF5 Scilab type attribute: + + SCILAB_Class = tlist + + HDF5 attributes: cf list + + + mlist + + + Scilab type: mlist + + + HDF5 Scilab type attribute: + + SCILAB_Class = mlist + + HDF5 attributes: cf list + + + void + + + Scilab type: void + + + HDF5 Scilab type attribute: + + SCILAB_Class = void + A void value can only be found in very special usages of list, tlist and mlist. It can be created with the following syntax: + voidelement_ref=list(1,,3); + + undefined + + + Scilab type: undefined + + + HDF5 Scilab type attribute: + + SCILAB_Class = undefined + + An undefined value is generated when the size of a list is increased and some elements not defined. They will be generated with the syntax: + + + undefinedelement_ref=list(2,%i,'f',ones(3,3)); + undefinedelement_ref(6)="toto" + + + + Real life examples + + Sample files of all these variables are provided into the Scilab distribution. They are available in the directory: SCI/modules/hdf5/tests/sample_scilab_data/ + + At the date of redaction of this document, the following files are provided with the Scilab distribution: + + + booleanmatrix.sod + + booleanscalar.sod + + booleansparse.sod + + emptymatrix.sod + + emptysparse.sod + + hypermatrixcomplex.sod + + hypermatrix.sod + + int16.sod + + int32.sod + + int8.sod + + listnested.sod + + list.sod + + matricedoublecomplexscalar.sod + + matricedoublecomplex.sod + + matricedoublescalar.sod + + matricedouble.sod + + matricestringscalar.sod + + matricestring.sod + + mlist.sod + + polynomialscoef.sod + + polynomials.sod + + sparsematrix.sod + + tlist.sod + + uint16.sod + + uint32.sod + + uint8.sod + + undefinedelement.sod + + voidelement.sod + + + + + Format evolutions + + + + + SOD version + + + Scilab version + + + Description + + + + + 0 + + + 5.2.0 + + + Initial version of the Scilab/HDF5 format + + + + + 1 + + + 5.4.0 alpha / beta + + + Default format for load and save + Previous format (.bin) still supported + + + + + 2 + + + 5.4.0 + + + + For matrices of double, integer, polynomial and string SCILAB_cols / SCILAB_rows have been removed to use multidimensional HDF5 + + + + + + + + + 6.0.0 (future) + + + .bin support dropped. + + + + + + + See Also + + + save + + + load + + + listvarinfile + + + type + + + typeof + + + + + diff --git a/modules/fileio/help/en_US/scanf.xml b/modules/fileio/help/en_US/scanf.xml new file mode 100755 index 000000000..16f7f54ef --- /dev/null +++ b/modules/fileio/help/en_US/scanf.xml @@ -0,0 +1,85 @@ + + + + + scanf + converts formatted input on standard input + + + Calling Sequence + [v_1, ..., v_n] = scanf(format); + + + Arguments + + + format + + a character string: specifies the format conversion. + + + + v_1, ..., v_n + + converted results. + + + + + + Description + + The scanf function gets character data on standard input (%io(1)), interprets it according + to a format, and returns the converted results v_1, ..., v_n. + + + The format parameter contains conversion specifications + used to interpret the input. + + + The format parameter can contain + white-space characters (blanks, tabs, newline, or formfeed) + that, except in the following two cases, read the input up to the + next nonwhite-space character. Unless there is a match in the control + string, trailing white-space (including a newline character) is not + read. + + + + + Any character except % (percent sign), which must match the next character of the input stream. + + + + + A conversion specification that directs the conversion of the next input field. See scanf_conversion for details. + + + + + + See Also + + + read + + + mfscanf + + + scanf_conversion + + + + diff --git a/modules/fileio/help/en_US/scanf_conversion.xml b/modules/fileio/help/en_US/scanf_conversion.xml new file mode 100755 index 000000000..a7547df2a --- /dev/null +++ b/modules/fileio/help/en_US/scanf_conversion.xml @@ -0,0 +1,157 @@ + + + + + scanf_conversion + mscanf, msscanf, mfscanf conversion specifications + + + Description + + Each conversion specification in the format parameter contains the following elements: + + + + + the character % (percent sign); + + + + + the optional assignment suppression character * (asterisk); + + + + + an optional numeric maximum field width; + + + + + a conversion code. + + + + + The conversion specification has the following syntax: + + + [*][width][size]convcode. + + + The results from the conversion are placed in v_i arguments unless you specify assignment suppression with * (asterisk). Assignment suppression provides a way to describe an input field that is to be skipped. The input field is a string of nonwhite-space characters. It extends to the next inappropriate character or until the field width, if specified, is exhausted. + + + The conversion code indicates how to interpret the input field. + You should not specify the v_i parameter for a + suppressed field. You can use the following conversion codes: + + + + % + + + accepts a single % (percent sign) input at this point; no assignment is done. + + + + + d, i + + accepts a decimal integer. + + + + u + + accepts an unsigned decimal integer. + + + + o + + accepts an octal integer. + + + + x + + accepts a hexadecimal integer. + + + + e, f, g + + + accepts a floating-point number. The next field is converted accordingly and stored through the corresponding parameter, which should be a pointer to a float. The input format for floating-point numbers is a string of digits, with the following optional characteristics: + + + + + it can be a signed value; + + + + + it can be an exponential value, containing a decimal point followed by an exponent field, which consists of an E or an e followed by an (optionally signed) integer; + + + + + it can be one of the special values %inf, %nan; + + + + + + + s + + accepts a string of characters. + + + + c + + + character value is expected. The normal skip over white-space is suppressed. + + + + + %lg + + gets value as a double. + + + + + + See Also + + + msscanf + + + mfscanf + + + mscanf + + + printf_conversion + + + + diff --git a/modules/fileio/help/fr_FR/addchapter.sce b/modules/fileio/help/fr_FR/addchapter.sce new file mode 100755 index 000000000..5161b0f9d --- /dev/null +++ b/modules/fileio/help/fr_FR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Entrées/Sorties [fichiers]",SCI+"/modules/fileio/help/fr_FR",%T); + diff --git a/modules/fileio/help/fr_FR/directory/CHAPTER b/modules/fileio/help/fr_FR/directory/CHAPTER new file mode 100755 index 000000000..cf7f4739a --- /dev/null +++ b/modules/fileio/help/fr_FR/directory/CHAPTER @@ -0,0 +1,2 @@ +title= Répertoire + diff --git a/modules/fileio/help/fr_FR/directory/chdir.xml b/modules/fileio/help/fr_FR/directory/chdir.xml new file mode 100755 index 000000000..b51c5ee02 --- /dev/null +++ b/modules/fileio/help/fr_FR/directory/chdir.xml @@ -0,0 +1,73 @@ + + + + chdir + change le répertoire courant de + Scilab + + + + cd + change le répertoire courant de + Scilab + + + + Séquence d'appel + chdir(path) + realpath=cd(path) + cd path + + + + Paramètres + + + path + + une chaîne de caractères fournissant le chemin du + répertoire. + + + + + realpath + + une chaîne de caractères, le chemin effectif après conversion + (voir ci-dessous) + + + + + + + Description + Change le répertoire courrant de Scilab par celui donné par la + variable path. + + + + Notez que le chemin fourni est converti. Ainsi + SCI/modules/fileio/macros est un chemin valide pour Unix et Windows. Si + path est vide , le chemin de destination est alors "home". + + + + + Exemples + + + + Voir aussi + + + pwd + + + + diff --git a/modules/fileio/help/fr_FR/directory/mkdir.xml b/modules/fileio/help/fr_FR/directory/mkdir.xml new file mode 100755 index 000000000..b3cdc4707 --- /dev/null +++ b/modules/fileio/help/fr_FR/directory/mkdir.xml @@ -0,0 +1,72 @@ + + + + mkdir + Crée un nouveau répertoire + + + Séquence d'appel + + mkdir('dirname') + mkdir('parentdir','newdir') + status=mkdir( ... ) + [status,msg]=mkdir( ... ) + + + + Description + + mkdir('dirname') crée le répertoire dirname. + Si dirname représente un chemin relatif, le + répertoire dirname est créé dans le répertoire + courant. + + + mkdir('parentdir', 'dirname') crée le répertoire + dirname dans le répertoire existant + parentdir, ou parentdir est un + chemin relatif ou absolu. + + + [status,message] = mkdir('parentdir', 'dirname') crée le répertoire + dirname dans le répertoire existant + parentdir, retourne le statut, et un message. Ici, + status vaut 1 si tout c'est bien passé, 2 si le + répertoire existe déjà, -2 si c'est un nom de fichiers, 0 dans + un autre cas. + + + + Exemples + + + + + + Voir aussi + + + cd + + + dir + + + rmdir + + + + diff --git a/modules/fileio/help/fr_FR/directory/pwd.xml b/modules/fileio/help/fr_FR/directory/pwd.xml new file mode 100755 index 000000000..2db1d03d3 --- /dev/null +++ b/modules/fileio/help/fr_FR/directory/pwd.xml @@ -0,0 +1,38 @@ + + + + pwd + affiche le répertoire courant de Scilab + + + Séquence d'appel + pwd + x=pwd() + + + + Description + + pwd renvoie dans ans le répertoire courant de Scilab. + x=pwd() renvoie dans x le répertoire courant de Scilab. + + + + Exemples + + + + Voir aussi + + + chdir + + + cd + + + + diff --git a/modules/fileio/help/fr_FR/directory/rmdir.xml b/modules/fileio/help/fr_FR/directory/rmdir.xml new file mode 100755 index 000000000..18f0f57ab --- /dev/null +++ b/modules/fileio/help/fr_FR/directory/rmdir.xml @@ -0,0 +1,51 @@ + + + + rmdir + Supprime un répertoire + + + Séquence d'appel + rmdir('dirname') + rmdir('dirname','s') + [status,message] = rmdir('dirname','s') + + + + Description + rmdir('dirname') supprime le répertoire dirname depuis le répertoire + courant. Si le répertoire n'est pas vide, vous devez utiliser l'argument + s. Si dirname n'est pas dans le répertoire courant , vous devez specifier + le chemin relatif ou complet pour acceder a dirname. + + rmdir('dirname','s') suppprime le répertoire dirname depuis le + répertoire courant et ses sous répertoires ainsi que leurs contenus. + + [status, message] = rmdir('dirname','s') supprime le répertoire dirname + et son contenu depuis le répertoire courant et retourne la variable status + et un message. Ici, status vaut 1 si l'execution s'est bien passé et 0 en + cas d'erreur. + + + + Exemples + + + + Voir aussi + + + cd + + + dir + + + mkdir + + + + diff --git a/modules/fileio/help/fr_FR/path_filename/CHAPTER b/modules/fileio/help/fr_FR/path_filename/CHAPTER new file mode 100755 index 000000000..74627e0b8 --- /dev/null +++ b/modules/fileio/help/fr_FR/path_filename/CHAPTER @@ -0,0 +1,2 @@ +title = Chemins - nom de fichiers + diff --git a/modules/fileio/help/fr_FR/path_filename/fullfile.xml b/modules/fileio/help/fr_FR/path_filename/fullfile.xml new file mode 100755 index 000000000..503592016 --- /dev/null +++ b/modules/fileio/help/fr_FR/path_filename/fullfile.xml @@ -0,0 +1,51 @@ + + + + fullfile + Construit un nom de fichier complet + + + Séquence d'appel + f = fullfile(varargin) + + + Paramètres + + + varargin + + tous les répertoires et le nom de fichier utilisés pour créer le nom de fichier complet (au moins un répertoire et un nom de fichier) + + + + f + + nom de fichier complet + + + + + + Description + + f= fullfile(varargin) construit un nom de fichier complet en prenant en compte la plateforme actuelle et en gérant les cas où les noms de répertoires commencent ou finissent par un séparateur de répertoire. + + + + Exemples + + + + Voir aussi + + + pathconvert + + + fileparts + + + + diff --git a/modules/fileio/help/fr_FR/path_filename/getlongpathname.xml b/modules/fileio/help/fr_FR/path_filename/getlongpathname.xml new file mode 100755 index 000000000..e80f7383b --- /dev/null +++ b/modules/fileio/help/fr_FR/path_filename/getlongpathname.xml @@ -0,0 +1,65 @@ + + + + getlongpathname + retourne le chemin au format nom long (Seulement pour + Windows) + + + + Séquence d'appel + longpath=getlongpathname(shortpath) + [longpath,bOK]=getlongpathname(shortpath) + + + + Paramètres + + + shortpath + + Une chaine de caracteres ou une matrice de chaines de + caracteres contenant le chemin au format court + + + + + longpath + + Une chaine de caracteres ou une matrice de chaines de + caracteres contenant le chemin au format long. + + + + + bOK + + retourne %T si le chemin a ete converti ou %F dans le cas + contraire. + + + + + + + Description + La primitive getlongpathname convertie le chemin au format court en + un nom de chemin au format long. + + + + Exemples + + + + Voir aussi + + + getshortpathname + + + + diff --git a/modules/fileio/help/fr_FR/path_filename/getshortpathname.xml b/modules/fileio/help/fr_FR/path_filename/getshortpathname.xml new file mode 100755 index 000000000..7053e075c --- /dev/null +++ b/modules/fileio/help/fr_FR/path_filename/getshortpathname.xml @@ -0,0 +1,65 @@ + + + + getshortpathname + retourne le chemin au format court (Seulement pour + Windows) + + + + Séquence d'appel + shortpath=getshortgpathname(longpath) + [shortpath,bOK]=getshortpathname(longpath) + + + + Paramètres + + + longpath + + Une chaine de caractere ou une matrice de chaines de + caracteres contenant le chemin au format long. + + + + + shortpath + + Une chaine de caractere ou une matrice de chaines de + caracteres contenant le chemin au format court + + + + + bOK + + contient %T si le chemin a ete converti ou %F si ce n'est pas + le cas. + + + + + + + Description + La primitive getshortpathname convertie un chemin au format long en + un chemin au format court. + + + + Exemples + + + + Voir aussi + + + getlongpathname + + + + diff --git a/modules/fileio/help/images/img001.png b/modules/fileio/help/images/img001.png new file mode 100755 index 000000000..6d0607dd8 Binary files /dev/null and b/modules/fileio/help/images/img001.png differ diff --git a/modules/fileio/help/images/img002.png b/modules/fileio/help/images/img002.png new file mode 100755 index 000000000..1b2cc33c0 Binary files /dev/null and b/modules/fileio/help/images/img002.png differ diff --git a/modules/fileio/help/ja_JP/addchapter.sce b/modules/fileio/help/ja_JP/addchapter.sce new file mode 100755 index 000000000..50bfd2d84 --- /dev/null +++ b/modules/fileio/help/ja_JP/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Files : Input/Output functions",SCI+"/modules/fileio/help/ja_JP",%T); + diff --git a/modules/fileio/help/ja_JP/copyfile.xml b/modules/fileio/help/ja_JP/copyfile.xml new file mode 100755 index 000000000..ccd071c83 --- /dev/null +++ b/modules/fileio/help/ja_JP/copyfile.xml @@ -0,0 +1,181 @@ + + + + + + + + + copyfile + + ファイルをコピー + + + + + + 呼び出し手順 + + copyfile(source, destination) + + [status, message] = copyfile(source, destination) + + + + + + + + 引数 + + + + + + source + + + + + + 文字列: ファイル名またはディレクトリ名. + + + + + + + + + + destination + + + + 文字列: ディレクトリ名. + + + + + + + + + + + + + + 説明 + + + + copyfile(source,destination) は, + + ファイルまたはディレクトリsourceを, + + ファイルまたはディレクトリdestinationに + + コピーします. + + + + + + sourceがディレクトリの場合, + + destinationにファイルを指定することは + + できません. + + + + copyfile 警告を発生せずに既存のファイルを置換します. + + + + + + + + [status, message] = copyfile(source, destination)は, + + source から destinationにコピーし, + + status および messageを返します. + + + + + + どのようなオペレーティン部システムであろうと, + + コピーに成功した場合,statusは1となり, + + messageは空になります ; + + コピーに失敗した場合, + + statusは0となり,messageは空でなくなります. + + + + + + コピー先のファイルに指定されるタイムスタンプは + + コピー元のファイルのものと同じになります. + + + + + + + + + + + + copyfile(SCI+"/etc/scilab.start",TMPDIR+"/scilab.start") + + [status,message] = copyfile(SCI+"/etc/scilab.start",TMPDIR); + + + + + + + + 参照 + + + + + + movefile + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/deletefile.xml b/modules/fileio/help/ja_JP/deletefile.xml new file mode 100755 index 000000000..3dd1f458c --- /dev/null +++ b/modules/fileio/help/ja_JP/deletefile.xml @@ -0,0 +1,104 @@ + + + + + + + + + deletefile + + ファイルを削除する + + + + + + 呼び出し手順 + + f = deletefile(filename) + + + + + + 引数 + + + + + + filename + + + + 文字列: 存在または存在しないファイルの名前. + + + + + + + + f + + + + + + 論理値: %t または %f + + + + + + + + + + + + + + 説明 + + + + この関数は,ファイルfilenameを削除します. + + ファイルfilenameが削除された場合に %t , + + それ以外の場合に%fを返します. + + + + + + + + + + []) then +deletefile(TMPDIR+'/filetodelete.txt') +end +deletefile(TMPDIR+'/notexistingfile') + ]]> + + + + + diff --git a/modules/fileio/help/ja_JP/directory/CHAPTER b/modules/fileio/help/ja_JP/directory/CHAPTER new file mode 100755 index 000000000..8f46dc5e9 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/CHAPTER @@ -0,0 +1,2 @@ +title= Directory + diff --git a/modules/fileio/help/ja_JP/directory/chdir.xml b/modules/fileio/help/ja_JP/directory/chdir.xml new file mode 100755 index 000000000..b2d7542bf --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/chdir.xml @@ -0,0 +1,69 @@ + + + + chdir + Scilab カレントディレクトリを変更する + + + cd + Scilab カレントディレクトリを変更する + + + 呼び出し手順 + b=chdir(path) + realpath=cd(path) + cd path + + + + パラメータ + + + b + + chdir処理がokの場合に論理値 %t. + + + + path + + 文字列 + + + + realpath + + 文字列, パス名変換の後に実際のパス名(以下参照) + + + + + + 説明 + + カレントの Scilab ディレクトリをpath + で指定したディレクトリに変更します. + パス変換が実行されるため,例えば, + SCI/modules/core/macrosは unix および windows の両方で + 有効であることに注意してください. + path が空の場合, "home" ディレクトリに変更されます. + + + + + + + + 参照 + + + pwd + + + + diff --git a/modules/fileio/help/ja_JP/directory/createdir.xml b/modules/fileio/help/ja_JP/directory/createdir.xml new file mode 100755 index 000000000..36dc1ff77 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/createdir.xml @@ -0,0 +1,58 @@ + + + + + createdir + 新規ディレクトリを作成 + + + 呼び出し手順 + createdir('dirname') + status = createdir('dirname') + + + + 説明 + createdir('dirname') はカレントのディレクトリに + ディレクトリ dirname を作成します. + dirname がカレントのディレクトリでない場合, + カレントのディレクトリに対する相対パスまたは dirname への絶対パスを + 指定してください. + + [status] = createdir('dirname') は + 既存のディレクトリ parentdir の中にディレクトリ dirname を作成し, + ステータスとメッセージを返します. + ここで,ステータスは成功時に %T, その他の場合 %F となります. + + createdir は mkdirで使用されます. + + + + + + + 参照 + + + mkdir + + + rmdir + + + + diff --git a/modules/fileio/help/ja_JP/directory/dir.xml b/modules/fileio/help/ja_JP/directory/dir.xml new file mode 100755 index 000000000..0b7e94b0e --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/dir.xml @@ -0,0 +1,114 @@ + + + + + dir + ファイル一覧を取得する + + + 呼び出し手順 + dir path + S=dir([path]) + + + + パラメータ + + + path + + + ディレクトリpathnameを指定する文字列行列 + (*を含むパターンで終わる場合もあります). + デフォルト値は.です. + + + + + S + + + dir型のtlistで + 以下のフィールドを有します : + name, date および + isdir + + + + + + + 説明 + + dir は path 引数により指定したパターンに + 一致するファイルを取得するために使用することができます. + パターンは,ファイルに関する情報を取得するために, + unix ls または + Windows dir コマンドに指定されます. + よって, ポータブルな Scilab スクリプトを書くためには, + 両方のOSで有効なワイルドカードパターンを指定する必要があります. + pathname 変換が行われるため, + 例えば, SCI/modules/core/macros/*.sci は + unix および windows の両方で有効なパターンとなることに注意してください. + + + 戻り値の変数のname フィールドファイル名の + 列ベクトルです. + + + 戻り値の + date フィールドは, 1970年1月1日からの積算日でコード化された + 直近の修正日を含む整数の列ベクトルです. + + + 戻り値の変数のフィールドisdirは, + 対応する名前がディレクトリの場合に true となる + 論理値の列ベクトルです. + + + デフォルトで表示される戻り値の構造はファイルの整形済みの列です. + これは,関数%dir_pを再定義することにより変更することが可能です. + + + + + + + + 参照 + + + listfiles + + + findfiles + + + ls + + + fileinfo + + + date + + + + diff --git a/modules/fileio/help/ja_JP/directory/isdir.xml b/modules/fileio/help/ja_JP/directory/isdir.xml new file mode 100755 index 000000000..bb58ddc83 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/isdir.xml @@ -0,0 +1,71 @@ + + + + + isdir + 引数がディレクトリパスかどうかを調べる + + + 呼び出し手順 + r=isdir(path) + + + パラメータ + + + path + + 文字列または文字列の行列, ファイルのパス名 + + + + r + + + 論理値, path がディレクトリへのパスの場合に真. + + + + + + + 説明 + + r=isdir(path) は, path がディレクトリへのパスかどうかを調べます. + + + + 参照 + + この関数はC関数 stat に基づいています. SCI および + Scilabディレクトリに関するショートカット~ + およびホームディレクトリが処理されます. + + + + + + + + 参照 + + + fileinfo + + + + diff --git a/modules/fileio/help/ja_JP/directory/ls.xml b/modules/fileio/help/ja_JP/directory/ls.xml new file mode 100755 index 000000000..0bbe76f95 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/ls.xml @@ -0,0 +1,100 @@ + + + + + ls + ファイルを表示 + + + 呼び出し手順 + ls path options + files=ls( [path] ) + + + + パラメータ + + + path + + ディレクトリパス名を指定する文字列行列 (多くの場合,末尾が + *のパターンとなります).デフォルト値は + .です. + + + + + files + + 文字列の列ベクトル. デフォルトで, + 列整形された出力を含みます.オプションの一つが + '-1'の場合, files は各ファイルに関する + エントリを含みます. + + + + + + + 説明 + + ls は, + path引数で指定したパターンに一致するファイルの一覧を得るために + 使用することができます. + パターンは,ファイルに関する情報を取得するために + Unixではls,Windowsでは + dirコマンドに指定されます. + このため, ポータブルなScilabスクリプトを書くためには, + 両方のOSに有効なワイルドカードパターンを指定する必要があります. + パス名の変換が行われ,例えばSCI/core/macros/*.sci + はUnixとWindowsの両方で有効なパターンであることに注意してください. + + + 全てのファイルのベクトルを取得したい場合には, + listfiles または dir関数 + を使用することが推奨されます. + + + Scilab バージョン 5.0 以降, 2番目の入力引数 + (Unixシステムで指定可能な一連の文字列: Unix ls コマンドオプション) + が削除されたことに注意してください. + このオプションは,主にセキュリティおよび移植性のため削除されました. + + + + + + + + 参照 + + + listfiles + + + findfiles + + + dir + + + fileinfo + + + + diff --git a/modules/fileio/help/ja_JP/directory/mkdir.xml b/modules/fileio/help/ja_JP/directory/mkdir.xml new file mode 100755 index 000000000..059f50c3d --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/mkdir.xml @@ -0,0 +1,75 @@ + + + + + mkdir + 新規ディレクトリ + + + 呼び出し手順 + mkdir('dirname') + mkdir('parentdir','newdir') + status=mkdir( ... ) + [status,msg]=mkdir( ... ) + + + + 説明 + mkdir('dirname') は,dirname が相対パスを表す場合, + カレントのディレクトリにディレクトリ dirname を作成します. + その他の場合, dirname は絶対パスを表し, + mkdir は絶対ディレクトリ dirname の作成を試みます. + + mkdir('parentdir','dirname') は既存のディレクトリ + parentdir にディレクトリ dirname を作成します. + ただし, parentdir は絶対またh相対パス名です. + + [status,message] = mkdir(...,'dirname') は, + 既存のディレクトリ parentdir に + ディレクトリ dirname を作成し, + メッセージ status を返します. + ここで, status は,成功の場合に1,ファイルがすでに存在する場合に2, + ファイル名の場合に-2,その他の場合に 0になります. + + + + + + + + 参照 + + + cd + + + dir + + + rmdir + + + + diff --git a/modules/fileio/help/ja_JP/directory/pwd.xml b/modules/fileio/help/ja_JP/directory/pwd.xml new file mode 100755 index 000000000..bbf914d3d --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/pwd.xml @@ -0,0 +1,42 @@ + + + + pwd + Scilab カレントディレクトリを出力 + + + pwd + Scilab カレントディレクトリを取得 + + + 呼び出し手順 + pwd + x=pwd() + + + + 説明 + + pwd は, Scilab カレントディレクトリ を ans に返します. + x=pwd()x にScilab カレントディレクトリを返します. + + + + + + + + 参照 + + + chdir + + + cd + + + + diff --git a/modules/fileio/help/ja_JP/directory/removedir.xml b/modules/fileio/help/ja_JP/directory/removedir.xml new file mode 100755 index 000000000..d825ff090 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/removedir.xml @@ -0,0 +1,60 @@ + + + + + removedir + ディレクトリを削除 + + + 呼び出し手順 + removedir('dirname') + [status] = removedir('dirname','s') + + + + 説明 + removedir('dirname') は + カレントのディレクトリからディレクトリ dirname を削除します. + ディレクトリが空でない場合, + ファイルおよびサブディレクトリは削除されます. + dirnameがカレントディレクトリでない場合, + カレントディレクトリへの相対パスまたは dirname のフルパスを + 指定してください. + + [status] = removedir('dirname') はディレクトリ dirname と + その中身をカレントのディレクトリから削除し, + status を返します. + ここで, status は成功時に %T, エラー時に %F となります. + + removedir は rmdirで使用されます. + + + + + + + 参照 + + + mkdir + + + rmdir + + + + diff --git a/modules/fileio/help/ja_JP/directory/rmdir.xml b/modules/fileio/help/ja_JP/directory/rmdir.xml new file mode 100755 index 000000000..4b9ff9f96 --- /dev/null +++ b/modules/fileio/help/ja_JP/directory/rmdir.xml @@ -0,0 +1,65 @@ + + + + + rmdir + ディレクトリを削除 + + + 呼び出し手順 + rmdir('dirname') + rmdir('dirname','s') + [status,message] = rmdir('dirname','s') + + + + 説明 + rmdir('dirname') はカレントのディレクトリからディレクトリ dirname を + 削除します. + ディレクトリが空でない場合, + 引数 s を指定する必要があります. + dirname がカレントのディレクトリにない場合, + カレントディレクトリに対する相対パスまたは + dirname のフルパスを指定してください. + + rmdir('dirname','s') はディレクトリ dirname と + その中身をカレントのディレクトリから削除します. + + [status, message] = rmdir('dirname','s') はディレクトリ dirname + との中身をカレントのディレクトリから削除し, statusとメッセージを返します. + ここで statusは成功時に 1,エラー時に 0 となります. + + + + + + + + 参照 + + + cd + + + dir + + + mkdir + + + + diff --git a/modules/fileio/help/ja_JP/dispfiles.xml b/modules/fileio/help/ja_JP/dispfiles.xml new file mode 100755 index 000000000..a624fa06a --- /dev/null +++ b/modules/fileio/help/ja_JP/dispfiles.xml @@ -0,0 +1,109 @@ + + + + + + + + + dispfiles + + オープンされているファイルのプロパティを表示 + + + + + + 呼び出し手順 + + dispfiles([units]) + + + + + + 引数 + + + + + + units + + + + + + 整数値のベクトル, ファイルの論理ユニット. + + デフォルトではオープンされている全ファイル. + + + + + + + + + + + + + + 説明 + + + + dispfiles は, + + 現在オープンされているファイルのプロパティを表示します. + + + + + + + + + + + + + + + + 参照 + + + + + + file + + + + + + mopen + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/fileinfo.xml b/modules/fileio/help/ja_JP/fileinfo.xml new file mode 100755 index 000000000..61424b7cd --- /dev/null +++ b/modules/fileio/help/ja_JP/fileinfo.xml @@ -0,0 +1,431 @@ + + + + + + + + + fileinfo + + ファイルに関する情報を出力 + + + + + + 呼び出し手順 + + [x,ierr] = fileinfo(files) + + + + + + 引数 + + + + + + files + + + + 文字列または文字列の列ベクトル, ファイルパス名 + + + + + + + + + + x + + + + + + 情報を含む大きさ13の整数ベクトルまたは + + ファイルが存在しない場合に空の行列. + + + + + + filesが文字列の列ベクトルの場合, + + x は + + 大きさm x 13の行列となります. + + + + + + あるファイル名が存在しない場合, 出力情報として, + + 各要素にNanを有する + + 大きさ13の行を返します. + + + + + + + + + + ierr + + + + エラーインジケータ, エラーが発生していない場合に 0 + + + + + + + + + + + + 説明 + + + + x = fileinfo(file) は以下を返します: + + + + + + + + x(1) + + + + ファイルの大きさ + + + + + + + + x(2) + + + + ファイルモード (10進値). + + + + + + + + x(3) + + + + ユーザid + + + + + + + + x(4) + + + + グループid + + + + + + + + x(5) + + + + デバイス番号 + + + + + + + + x(6) + + + + 直近の修正日 + + + + + + + + x(7) + + + + 直近の変更日 + + + + + + + + x(8) + + + + 直近のアクセス日 + + + + + + + + x(9) + + + + デバイス型 (inode デバイスの場合) + + + + + + + + x(10) + + + + ファイルシステム I/O のブロックサイズ (Windowsでは常に0) + + + + + + + + x(11) + + + + 確保されたブロック数 (Windowsでは常に0) + + + + + + + + x(12) + + + + inode + + + + + + + + x(13) + + + + ハードリンクの数 + + + + + + + + + + + + 参考 + + + + この関数はC関数statへのインターフェイスです. + + + + + + 許可属性は,通常,8進数で指定されます : 変換にはdec2oct(x(2)) + + を使用します + + + + + + 数値モードは,1から4個の8進数 (0-7), + + 4, 2, および 1でビットを加算することにより導かれます. + + 全ての省略された桁は先頭にゼロがあると仮定されます. + + 最初の桁はユーザID(4)を選択し, + + グループID(2)およびスティッキー(1)属性を設定します. + + 2番目の桁は,fileを所有するユーザの許可属性を選択します + + : 読み込み(4), 書き込み(2),実行(1); + + 3桁目はファイルのグループの同じ値を有する + + 他のユーザの許可属性を選択します; + + 4桁目はファイルグループにない同じ値を有する許可属性を + + 選択します. + + + + + + 許可属性を確認するには, マスクを使用する必要があります. + + 次の例を見てみましょう: + + 8進数, x(2)=1664, 最初の桁はsticky属性に対応します. + + 2桁目はファイル所有者が書き込みおよび読込権限を有することを示します. + + これは,このファイルのグループ内の他のユーザも同じです. + + 最後に他のユーザは読込権限のみ有します. + + マスクを適用するには, この8進数をバイナリ(2進数)形式で見るだけで構いません. + + つまり:x(2)= 1 110 110 100. + + 所有者が書き込み権限を有するかどうか確認するには, + + 2番目のトリプレット: 110 を見て, 書き込み許可 010 を有するものと比較します. + + つまり,処理は以下のようになります: 110 000 000 & 010 000 000. + + 結果がヌルでない場合 (本ケースが相当), 所有者が書き込み権限を有します. + + + + + + + + + + 0) then + disp('WRITE PERMISSION on this file.'); +else + disp('NO WRITE PERMISSION on this file.'); +end + +// 読込許可を確認 +if ( bitand( w(2), S_IREAD ) <> 0) then + disp('READ PERMISSION on this file.'); +else + disp('NO READ PERMISSION on this file.'); +end + +FILES = [SCI;SCIHOME;'not_exist_file';TMPDIR] +[X,ERRS] = fileinfo(FILES) + ]]> + + + + + + 参照 + + + + + + getdate + + + + + + file + + + + + + dispfiles + + + + + + newest + + + + + + isdir + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/findfiles.xml b/modules/fileio/help/ja_JP/findfiles.xml new file mode 100755 index 000000000..808d62960 --- /dev/null +++ b/modules/fileio/help/ja_JP/findfiles.xml @@ -0,0 +1,137 @@ + + + + + + + + + findfiles + + + + 指定したファイル仕様を有する全てのファイルを見つける + + + + + + + + 呼び出し手順 + + f = findfiles() + + f = findfiles(path) + + f = findfiles(path, filespec) + + + + + + + + 引数 + + + + + + path + + + + 文字列, パス. + + + + + + + + filespec + + + + + + 文字列, ファイル仕様, 例えば "*.sce". + + + + + + + + + + f + + + + 文字列の列ベクトル, ファイル名. + + + + + + + + + + + + 説明 + + + + 指定したファイル仕様filespecを有する + + ファイルを全て見つけます. + + + + + + + + + + + + + + + + 参照 + + + + + + listfiles + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/fprintfMat.xml b/modules/fileio/help/ja_JP/fprintfMat.xml new file mode 100755 index 000000000..2fbdd4819 --- /dev/null +++ b/modules/fileio/help/ja_JP/fprintfMat.xml @@ -0,0 +1,285 @@ + + + + + + + + + fprintfMat + + 行列をファイルに書き込む + + + + + + 呼び出し手順 + + fprintfMat(file, M [,format,text]) + + + + + + 引数 + + + + + + fil + + + + 文字列, 書き込むファイルのパス名 + + + + + + + + M + + + + 実数の行列 + + + + + + + + format + + + + + + 形式を指定する文字列. オプションのパラメータで, + + デフォルト値は"%lf". + + + + サポートされる形式: + + %[width].[precision]type または + + %type, ただし: + + + + + + width: + + 文字出力の最小数を指定するオプションの数値; + + + + + + precision: + + 出力フィールド全てまたは一部に関する + + 出力される文字の最大数を指定するオプションの数値; + + または整数値を印字する桁の最小数; + + + + + + type: lf, lg, d, i, e, f, g (詳細はscanf_conversion を参照). + + + + + + + + + + text + + + + + + ファイルの先頭に保存される + + 数値以外のコメントを指定する文字列の行(列)ベクトル. + + + + + + + + + + + + + + 説明 + + + + fprintfMat 関数は,整形済みのファイルに + + 行列を書き込みます. + + 行列の各行はファイルの中で1行となります. + + textが指定された場合, + + ファイルの先頭に1行に1要素/行で + + textの要素が要素毎に挿入されます. + + + + + + + + + + + + + + + + 参照 + + + + + + scanf_conversion + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/fscanfMat.xml b/modules/fileio/help/ja_JP/fscanfMat.xml new file mode 100755 index 000000000..e50510717 --- /dev/null +++ b/modules/fileio/help/ja_JP/fscanfMat.xml @@ -0,0 +1,344 @@ + + + + + + + + + fscanfMat + + テキストファイルから行列を読み込む + + + + + + 呼び出し手順 + + M = fscanfMat(filename[, fmt]); + + [M, text] = fscanfMat(filename [, fmt]); + + + + + + + + 引数 + + + + + + filename + + + + スキャンするファイルの名前を指定する文字列. + + + + + + + + fmt + + + + + + a character string giving the format. This is an optional + + parameter, the default value is "%lg". + + + + + + Supported format: %[width].[precision]type or %type where: + + + + + + width: optional number that specifies + + the minimum number of characters output; + + + + + + precision: optional number that + + specifies the maximum number of characters printed for all + + or part of the output field, or the minimum number of + + digits printed for integer values. + + + + + + type: lf, lg, d, i, e, f, g (see scanf_conversion). + + + + + + + + + + M + + + + 出力変数. 実数の行列. + + + + + + + + text + + + + + + 出力変数. 文字列の列ベクトル. + + ファイルfilenameの先頭のコメントです. + + + + + + + + + + + + + + 説明 + + + + fscanfMat関数はテキストファイルからスカラー行列を読み込むために + + 使用されます. + + textが指定された場合,ファイルの先頭の非数値の行が + + 返されます.残りの行の列の数は同じである必要があります + + (コロンセパレータは空白文字またはタブ文字であるとみなされます). + + 行列の列の数はファイルでみつかった列の数となり, + + 行の数は入力ファイルの終端を検出するまでに取得した行数と + + なります. + + この関数はfprintfMatで保存した数値データを + + 読み戻すために使用することができます. + + + + + + fscanfMatは,ANSI/ASCII および UTF-8でエンコードされた + + ファイルをサポートします.. + + + + + + CSV形式のファイルを読み込む場合, + + csvRead関数の使用が推奨されます. + + + + + + + + + + + + fd = mopen(TMPDIR + "/Mat", "w"); + + mfprintf(fd, "Some text.....\n"); + + mfprintf(fd, "Some text again\n"); + + a = rand(6,6); + + for i = 1:6 , + + for j = 1:6, mfprintf(fd, "%5.2f ", a(i,j));end; + + mfprintf(fd, "\n"); + + end + + mclose(fd); + + a1 = fscanfMat(TMPDIR + "/Mat") + + + + A = ones(5,5) + 0.1; + + fprintfMat(TMPDIR + "/Matrix.txt", A, "%lg"); + + B = fscanfMat(TMPDIR + "/Matrix.txt", "%lg"); + + A == B + + + + C = [%nan, %inf, -%inf, 1]; + + fprintfMat(TMPDIR + "/MatrixNANINF.txt", C); + + D = fscanfMat(TMPDIR + '/MatrixNANINF.txt') + + + + + + + + + + 参照 + + + + + + scanf_conversion + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + csvRead + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/getURL.xml b/modules/fileio/help/ja_JP/getURL.xml new file mode 100755 index 000000000..3740ee11e --- /dev/null +++ b/modules/fileio/help/ja_JP/getURL.xml @@ -0,0 +1,287 @@ + + + + + + + + + getURL + + URL (HTTP, HTTPS, FTP...) をダウンロード + + + + + + 呼び出し手順 + + filename = getURL(URL); + + [filename, [content]] = getURL(URL [, targetDir [, username [, password]]]]); + + [filename, [content]] = getURL(URL [, targetFile [, username [, password]]]]); + + + + + + + + 引数 + + + + + + URL + + + + 文字列: URL. サポートされており,テスト済みです: HTTP, HTTPS, FTP (IPv4 およびIPv6) + + + + + + + + targetDir + + + + 文字列オプションパラメータ:ファイルを保存するディレクトリ (空の場合はカレントディレクトリ) + + + + + + + + targetFile + + + + 文字列オプションパラメータ: ファイルの保存先(空の場合はカレントディレクトリ) + + + + + + + + + + username + + + + 文字列オプションパラメータ: 認証が必要なWebサイト用のユーザ名 + + + + + + + + password + + + + 文字列オプションパラメータ: 認証が必要なWebサイト用のパスワード + + + + + + + + filename + + + + 文字列: ファイルをダウンロードするパス + + + + + + + + content + + + + 文字列: ダウンロードしたファイルの内容 + + + + + + + + + + + + 説明 + + URLからファイルをダウンロード. + + + + getURL はリモートURLからファイルをダウンロードします. + + getURLはURLで指定するものと同じ名前を使用します. + + しかし,いくつかの習慣に基づき(例えば,http://www.scilab.org/) + + ファイル名がURLで指定されない場合に, + + getURLはファイル名をindex.htmlに変更します. + + + + content はURLに指定されたページの内容を有します. + + + + この関数は curlライブラリにもとづいています. + + + + 認証が必要なWebサイト用にusername と password を指定できます. + + 使用される認証方法はCURLAUTH_ANYで, + + libcurlライブラリのCURLOPT_HTTPAUTHパラメータで指定されます. + + + + IPv6 (そして当然 IPv4) が getURLにより標準でサポートされます. + + このバージョンではプロキシ設定が有効となっています. + + ATOMS設定ファイルのパラメータを使用します. + + + + + + URLに追従して確実にダウンロードを行うには, + + curlオプションCURLOPT_FOLLOWLOCATION を有効にします. + + + + + + getURL は libcurlにもとづいています. + + 公式のScilabバイナリにおけるこのライブラリのバージョンは, + + HTTP, HTTPS, FTP および FTPS サポートを有効にしてコンパイルされています. + + Scilabがディストリビューションのパッケージシステムによりインストールされた場合, + + HTTP, HTTPS および FTPS以外の + + 他のプロトコル + + も動作する可能性があります.しかし, これらはまだ十分に試験されていません. + + + + + + + + + + + + // URLをダウンロードし, ファイル maths_simulation に保存します + + getURL("http://www.scilab.org/products/scilab/features/maths_simulation"); + + // Scilabホームページをカレントディレクトリに保存します (そしてファイルにリネーム) + + getURL("http://www.scilab.org","scilab_homepage.html"); + + // Scilabの例をダウンロードし, 実行します + + myFile = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR) + + exec(myFile); + + contour3d(); + + // 認証を使用 + + getURL("http://httpbin.org/basic-auth/user/passwd",TMPDIR+"/testfile.html","user","passwd") + + // IPv6接続を使用 + + getURL("http://ipv6.google.com/intl/en_com/images/srpr/logo3w.png") + + // 内容を取得 + + [myFile, content] = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR) + + + + + + + + 参照 + + + + + + splitURL + + + + + + + + + + History + + + + + + 5.5.0 + + この関数はScilab 5.5.0で追加されました + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/getmd5.xml b/modules/fileio/help/ja_JP/getmd5.xml new file mode 100755 index 000000000..e6d2ccac5 --- /dev/null +++ b/modules/fileio/help/ja_JP/getmd5.xml @@ -0,0 +1,102 @@ + + + + + + + getmd5 + + md5 チェックサムを取得 + + + + + + 呼出し手順 + + res=getmd5(filename) + + res=getmd5(ParamString,'string') + + + + + + + + 引数 + + + + + + res + + + + md5 結果 (文字列) + + + + + + + + filename + + + + ファイル名 (文字列または文字列の行列) + + + + + + + + ParamString + + + + 文字列または文字列の行列 + + + + + + + + + + + + 説明 + + + + getmd5は, + + ファイルfilenameまたは文字列ParamStringの + + md5 チェックサムを取得します. + + + + + + + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/io.xml b/modules/fileio/help/ja_JP/io.xml new file mode 100755 index 000000000..6c76b23e1 --- /dev/null +++ b/modules/fileio/help/ja_JP/io.xml @@ -0,0 +1,102 @@ + + + + + + + + + %io + + + + 標準入力および標準出力を保持する変数(ファイル記述子). + + + + + + + + 呼び出し手順 + + %io(1) + + %io(2) + + + + + + + + 説明 + + %io(1) は標準入力を返します (ファイル記述子 5). + + %io(2) は標準出力を返します (ファイル記述子 6). + + ファイル記述子 0 は標準エラーです. + + + + + + + + + + + + + + 参照 + + + + + + write + + + + + + mfprintf + + + + + + file + + + + + + dispfiles + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/isfile.xml b/modules/fileio/help/ja_JP/isfile.xml new file mode 100755 index 000000000..8880499c6 --- /dev/null +++ b/modules/fileio/help/ja_JP/isfile.xml @@ -0,0 +1,136 @@ + + + + + + + + + isfile + + 引数が既存のファイルかどうか調べる + + + + + + 呼び出し手順 + + x = isfile(filenames) + + + + + + 引数 + + + + + + filenames + + + + 文字列または文字列の行列. + + + + + + + + x + + + + + + 論理値の行列 (filenamesが + + 存在する場合に%t). + + + + + + + + + + + + + + 説明 + + + + x = isfile(filenames)は,filenamesが + + 既存のファイルかどうかを調べます. + + (ディレクトリはファイルではありません. + + isdirを参照ください.) + + + + + + + + + + + + filenames = ls(SCI) + + + + x = isfile(filenames) + + + + isfile(SCI + '/etc') + + isdir(SCI + '/etc') + + + + + + + + 参照 + + + + + + fileinfo + + + + + + isdir + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/listfiles.xml b/modules/fileio/help/ja_JP/listfiles.xml new file mode 100755 index 000000000..33808fa51 --- /dev/null +++ b/modules/fileio/help/ja_JP/listfiles.xml @@ -0,0 +1,225 @@ + + + + + + + + + listfiles + + ファイルのリスト + + + + + + 呼び出し手順 + + files = listfiles(paths [, flag, flagexpand]) + + + + + + 引数 + + + + + + paths + + + + + + パス名の集合を指定する文字列の行列 + + (多くの場合, 末尾が * のパターンとなります) + + + + + + + + + + flag, flagexpand + + + + + + オプションの論理値パラメータ + + (デフォルト値は%tです). + + + + + + + + + + files + + + + 文字列の行列. + + + + + + + + + + + + 説明 + + + + listfiles は, + + パスエントリの指定したパターンのどれかに一致するファイル + + の一覧を得るために使用されます. + + パターンは,ファイルに関する情報を取得するために + + Unixではls,Windowsでは + + dirコマンドに指定されます. + + このため, ポータブルなScilabスクリプトを書くためには, + + 両方のOSに有効なワイルドカードパターンを指定する必要があります. + + パス名の変換が行われ,例えばSCI/core/macros/*.sci + + はUnixとWindowsの両方で有効なパターンであることに注意してください. + + + + + + flag が真の場合,pathsで + + 指定したパス名は getos() == 'Windows' の値に基づき変換されます + + (pathconvert参照). + + さらに,flagexpand が真の場合, + + HOME, SCI または ~ のような + + 主要な文字列は環境変数を用いて展開されます. + + + + + + 入力引数 paths がディレクトリ名の場合, + + 返されるfilesはディレクトリのネーティブな名前です. + + + + + + 入力引数pathsが複数の要素を有する場合,または + + パターンfiles + + (例: "/*", "*.c")を有する場合, + + 返されるfilesは絶対パス + + (すなわち,ディレクトリ名の末尾にファイル名を追加したもの)です. + + + + + + + + + + + + + + + + + + 履歴 + + + + + + 5.4.0 + + + + pathsが単一の文字列でない場合, + + 返されるファイルは全て絶対パス形式に統一されます. + + + + + + + + + + + + 参照 + + + + + + findfiles + + + + + + basename + + + + + + pathconvert + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/listvarinfile.xml b/modules/fileio/help/ja_JP/listvarinfile.xml new file mode 100755 index 000000000..1aa5c90e0 --- /dev/null +++ b/modules/fileio/help/ja_JP/listvarinfile.xml @@ -0,0 +1,196 @@ + + + + + + + listvarinfile + + 保存されたデータファイルの中の変数の一覧を得る + + + + + + 呼び出し手順 + + listvarinfile(filename) + + [names, typs, dims, vols] = listvarinfile(filename) + + + + + + + + 引数 + + + + + + filename + + + + 文字列, 調べるファイルのパス名 + + + + + + + + + + nams + + + + 文字列の行列, ファイルに保存した変数の名前 + + + + + + + + + + dims + + + + リスト, ファイルに保存した変数の次元 + + + + + + + + + + typs + + + + 数値行列, ファイルに保存した変数の型 + + + + + + + + + + vols + + + + 数値行列, ファイルに保存した変数の大きさ(単位:バイト) + + + + + + + + + + + + + + 説明 + + + + + + + + このユーティリティ関数は, + + saveにより作成されたScilabデータファイルに含まれる + + 変数の一覧 "a la whos" を取得します. + + + + + + + + ハイパー行列はプレーンな mlist として報告されます; + + 有理数および状態空間はプレーンな tlist として報告されます; + + グラフィックハンドルは認識されません. + + + + + + + + + + + + + + + + + + + + + + 参照 + + + + + + whos + + + + + + save + + + + + + load + + + + + + save_format + + + + + + type + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/maxfiles.xml b/modules/fileio/help/ja_JP/maxfiles.xml new file mode 100755 index 000000000..2b4b64fa1 --- /dev/null +++ b/modules/fileio/help/ja_JP/maxfiles.xml @@ -0,0 +1,119 @@ + + + + + + + + + maxfiles + + + + Scilabが同時にオープンできるファイル数を最大値を指定する. + + + + + + + + 呼び出し手順 + + r= maxfiles(newnumbermax) + + + + + + 引数 + + + + + + newnumbermax + + + + 整数, 新しい値 + + + + + + + + r + + + + 整数: 新しい実効値. + + + + + + + + + + + + 説明 + + + + maxfilesは, + + Scilabが同時にオープンできるファイル数を最大値を指定します. + + + + 最小値 : 20 + + 最大値 : 100 + + デフォルト : 20 + + + + + + + + + + + + + + 参照 + + + + + + mopen + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mclearerr.xml b/modules/fileio/help/ja_JP/mclearerr.xml new file mode 100755 index 000000000..806372d9c --- /dev/null +++ b/modules/fileio/help/ja_JP/mclearerr.xml @@ -0,0 +1,151 @@ + + + + + + + + + mclearerr + + バイナリファイルアクセスエラーをリセット + + + + + + 呼び出し手順 + + mclearerr([fd]) + + + + + + 引数 + + + + + + fd + + + + + + スカラー: mopen関数により返された + + fdパラメータ. + + -1 は直近にオープンされたファイルを意味します. + + デフォルト値は -1 です. + + + + + + + + + + + + + + 説明 + + + + 関数mclearerrは,エラーインジケータおよび + + EOFインジケータを 0にリセットするために使用されます. + + + + + + + + 参照 + + + + + + merror + + + + + + mclose + + + + + + mopen + + + + + + mput + + + + + + mget + + + + + + mgetstr + + + + + + mputstr + + + + + + meof + + + + + + mseek + + + + + + mtell + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mclose.xml b/modules/fileio/help/ja_JP/mclose.xml new file mode 100755 index 000000000..7135d951b --- /dev/null +++ b/modules/fileio/help/ja_JP/mclose.xml @@ -0,0 +1,252 @@ + + + + + + + + + mclose + + オープンされているファイルを閉じる + + + + + + 呼び出し手順 + + + + err = mclose([fd]) + + mclose('all') + + + + + + + + 引数 + + + + + + fd + + + + + + スカラー: 関数mopenにより返された + + fdパラメータがファイル記述子として使用されます. + + + + + + + + + + err + + + + スカラー: エラーインジケータ. + + + + + + + + + + + + 説明 + + + + mcloseは,mopenによりオープンされた + + ファイルを閉じるために使用されます. + + fdが省略された場合, + + mcloseは直近にオープンされたファイルを閉じます. + + + + + + mclose('all')は, + + file('open',..) または mopenにより + + オープンされた全てのファイルを閉じます. + + + + これをScilabスクリプトファイルの中で使用する場合には注意してください. + + スクリプト自体も閉じられるため, Scilab は + + mclose('all')の後に書かれたコマンドを実行しません. + + + + + + + + + + + + + + + + + + 参照 + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetl + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputl + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + file + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mdelete.xml b/modules/fileio/help/ja_JP/mdelete.xml new file mode 100755 index 000000000..1281eba14 --- /dev/null +++ b/modules/fileio/help/ja_JP/mdelete.xml @@ -0,0 +1,206 @@ + + + + + + + + + mdelete + + ファイルを削除 + + + + + + 呼び出し手順 + + mdelete(filename) + + + + + + 引数 + + + + + + filename + + + + 文字列: 削除するファイルのパス名. + + + + + + + + + + + + 説明 + + + + mdelete は, + + ファイルまたはfilenameがメタ文字を含む場合に + + ファイルの集合を削除するために使用できます. + + + + + + + + 削除コマンドを入力する時, + + mdeleteは確認をしないことに注意してください. + + ファイル失う事故を避けるため, 削除したいアイテムを正確に指定していることを + + 確認してください. + + + + + + + + + + + + + + + + + + 参照 + + + + + + mopen + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/meof.xml b/modules/fileio/help/ja_JP/meof.xml new file mode 100755 index 000000000..ba5061f39 --- /dev/null +++ b/modules/fileio/help/ja_JP/meof.xml @@ -0,0 +1,235 @@ + + + + + + + + + meof + + ファイルの終端に達したかどうかを確認する + + + + + + 呼び出し手順 + + err=meof(fd) + + + + + + 引数 + + + + + + fd + + + + + + スカラー: 関数mopenにより返された + + fdパラメータ. + + -1 は直近にオープンされたファイルを意味します. + + デフォルト値は -1です. + + + + + + + + + + err + + + + スカラー: エラーインジケータ + + + + + + + + + + + + 説明 + + + + 関数meofは,前の + + mget または mgetstr + + のコールにより + + ファイル終端に達している場合にヌル以外の値を返します. + + エラーフラグおよびEOFフラグをゼロにリセットするために, + + 関数mclearerrが使用されます. + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/merror.xml b/modules/fileio/help/ja_JP/merror.xml new file mode 100755 index 000000000..9b10ce120 --- /dev/null +++ b/modules/fileio/help/ja_JP/merror.xml @@ -0,0 +1,234 @@ + + + + + + + + + merror + + ファイルアクセスに関するエラーインジケータを調べる + + + + + + 呼び出し手順 + + + + err = merror([fd]) + + [err, msg] = merror([fd]) + + + + + + + + 引数 + + + + + + fd + + + + + + スカラー: 関数mopenにより返された + + fdパラメータがファイル記述子(正の整数)として使用されます. + + -1 は直近にオープンされたファイルを意味します. + + デフォルト値は -1です. + + + + + + + + + + err + + + + + + スカラー: + + 指定したファイルに関する直近のファイルI/O処理のエラーステータス番号 + + を返します. + + + + + + 指定したファイルで実行された直近のI/O処理が成功した場合, + + msgの値は空となり, merrorは + + errの値として 0 を返します. + + + + + + + + + + msg + + + + 文字列: エラー文字列メッセージ. + + + + + + + + + + + + 説明 + + + + 関数 merrorはファイルアクセスエラーインジケータ + + をテストするため使用されます. + + エラーが設定されている場合, ゼロでない要素を返します. + + エラーインジケータはmclearerr関数により + + リセットすることのみが可能です. + + + + + + ゼロでないerrは,直近のI/O処理で発生したエラーを指します. + + メッセージの値は,エラーの特性に関する情報を含む文字列です. + + このメッセージが役に立たない場合, + + 詳細については使用するオペレーティングシステム用の + + C言語のランタイムライブラリのマニュアルを参照してください. + + + + + + + + + + 0) then + mprintf('Problem\n'); +end +mclose(fd); + ]]> + + + + + + 参照 + + + + + + mclearerr + + + + + + mclose + + + + + + mopen + + + + + + mput + + + + + + mget + + + + + + mgetstr + + + + + + mputstr + + + + + + meof + + + + + + mseek + + + + + + mtell + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mfprintf.xml b/modules/fileio/help/ja_JP/mfprintf.xml new file mode 100755 index 000000000..64c99eaac --- /dev/null +++ b/modules/fileio/help/ja_JP/mfprintf.xml @@ -0,0 +1,305 @@ + + + + + + + + + mfprintf + + 変換,整形し,ファイルにデータを書き込む + + + + + + 呼び出し手順 + + mfprintf(fd, format, a1, ..., an); + + + + + + 引数 + + + + + + fd + + + + + + スカラー, mopenで指定したファイル記述子 + + (正の整数). + + + + + + fd が 0 の場合, stderr へのリダイレクション. + + + + + + fdが 6 の場合, stdout へのリダイレクション. + + + + + + 古い仕様 :値 -1 はデフォルトのファイル + + ( すなわち直近にオープンされたファイル)を指します. + + + + + + + + + + format + + + + + + 残りのオペランドを書き込む際に使用されるフォーマットを指定する + + Scilab 文字列. + + formatオペランドはCのprintf + + のフォーマットオペランドの構文に可能な限り似せられています. + + + + + + + + + + str + + + + 文字列: スキャンされる文字列. + + + + + + + + a1, ..., an + + + + + + formatパラメータに基づき変換,出力されるデータ. + + + + + + + + + + + + + + 説明 + + + + mfprintf 関数は, C言語のfprintf関数への + + インターフェイスです. + + + + + + mfprintf関数は,整形されたオペランドを + + ファイル記述子fdで指定したファイルに書き込みます. + + 引数のオペランドは,formatオペランドの制御のもとで整形されます. + + + + + + この関数は数値の列ベクトルおよび文字列ベクトルを要素に関する + + 明示的なループ処理を行うことなく出力する際に使用することができます. + + この場合,この関数は行に関する反復処理を行ないます. + + 最も短いベクトルはフォーマットの反復回数を指定します. + + + + + + 同じ型パラメータの一様なシーケンスは + + 行列で置換することができます. + + + + + + + + + + 0)) then + editor(TMPDIR+'/text.txt') +end +mfprintf(0,'stderr output.\n'); +mfprintf(6,'stdout output.\n'); + ]]> + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + printf_conversion + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mfscanf.xml b/modules/fileio/help/ja_JP/mfscanf.xml new file mode 100755 index 000000000..220c339cd --- /dev/null +++ b/modules/fileio/help/ja_JP/mfscanf.xml @@ -0,0 +1,472 @@ + + + + + + + + + mscanf + + + + 標準入力から入力を読み込む (C言語の scanf + + 関数へのインターフェイス) + + + + + + + + mfscanf + + + + ストリームへのポインタから入力を読み込む (C言語の + + fscanf 関数へのインターフェイス) + + + + + + + + msscanf + + + + 文字列から入力を読み込む (C言語の + + sscanf 関数へのインターフェイス) + + + + + + + + 呼び出し手順 + + + + [n, v_1,..., v_m] = mfscanf([niter,]fd, format) + + L = mfscanf([niter,] fd,format) + + + + [n, v_1,..., v_m] = mscanf([niter,] format) + + L = mscanf([niter,]format) + + + + [n, v_1,..., v_m] = msscanf([niter,]str, format) + + L = msscanf([niter,] str, format) + + + + + + + + 引数 + + + + + + format + + + + + + 残りのオペランドを書き込む際に使用されるフォーマットを記述する + + Scilab 文字列. formatオペランドは, + + scanf_conversionに記述された + + C 言語のprintfのフォーマット記述子にできるだけ + + 近くなるよう作成されています. + + + + + + + + + + fd + + + + + + mopenにより返された + + ファイル記述子. + + 値 -1 は直近にオープンされたファイルを指します. + + + + + + + + + + str + + + + Scilab 文字列または文字列ベクトル. + + + + + + + + niter + + + + 整数, フォーマットの使用回数. + + + + + + + + n + + + + + + 整数: 読み込まれたデータの数または + + データを読み込む前にEOLに達した場合は -1. + + + + + + + + + + v_i + + + + + + 各関数は文字を読み込み,formatに基づき解釈し, + + 結果をその出力引数に保存します. + + n個より多くの出力引数が指定された場合, + + 最後の変数v_n+1, ..., v_mが空の行列に設定されます. + + + + + + + + + + L + + + + + + 全てのデータが同種である場合, + + 戻り値の一つのベクトルに保存されます. + + そうでない場合,同じデータ型のシーケンスは + + 行列に保存され, 作成された全ての行列を含む + + (cblock型を有する)mlist + + が返されます. + + + + + + + + + + + + + + 説明 + + + + mfscanf関数はストリームfd + + から文字を読み込みます. + + + + + + mfscanf関数は Scilabウインドウから + + 文字を読み込みます. + + + + + + mfscanf関数はScilab文字列 + + strから文字を読み込みます. + + + + + + オプション引数niterは + + フォーマットの反復使用回数を指定します. + + 1回の反復は出力行列に1つの行を出力します. + + niter==-1の場合, + + 関数はファイル終端まで反復処理を行ないます. + + niterのデフォルト値は 1です. + + + + 精度に関するコメント : + + + + mfscanfは,Cの関数fscanfに基づいています. + + '%f', + + '%g', '%e' + + をフォーマットに指定した場合, + + データはfloatにキャストされ,Scilab変数に出力されます. + + + + + + このScilab変数がdoubleの場合,精度が劣化する可能性があります. + + このような場合は, '%lg'フォーマットを使用する方が良いでしょう. + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + scanf_conversion + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mget.xml b/modules/fileio/help/ja_JP/mget.xml new file mode 100755 index 000000000..610b95063 --- /dev/null +++ b/modules/fileio/help/ja_JP/mget.xml @@ -0,0 +1,485 @@ + + + + + + + + + mget + + + + 指定したバイナリ形式で + + バイトまたはワードを読み込み, double に変換 + + + + + + + + mgeti + + + + 指定したバイナリ形式で + + バイトまたはワードを読み込み, int型に変換 + + + + + + + + 呼び出し手順 + + + + x = mget([n, type, fd]) + + x = mgeti([n, type, fd]) + + + + + + + + 引数 + + + + + + n + + + + 正のスカラー: 読み込むデータの数. + + + + + + + + fd + + + + + + スカラー: + + mopenにより返されたファイル記述子. + + -1は直近にオープンされたファイルを意味します. + + デフォルト値は-1です. + + + + + + + + + + type + + + + + + 文字列: xの全エントリを書き込むために使用する + + バイナリフォーマットを指定. + + + + + + + + + + x + + + + 浮動小数点数または整数値のベクトル + + + + + + + + + + + + 説明 + + + + mget 関数は, + + ストリームパラメータfdにより指定された入力の + + データを読み込み,浮動小数点数データのベクトルを返します. + + + + + + mgeti 関数は, + + ストリームパラメータfdにより指定された入力の + + データを読み込み,整数データのベクトルを返します. + + + + + + ファイルポインタが現在指している場所からデータが読み込まれ, + + 適当にインジケータが進まされます. + + + + + + typeパラメータは変換指定子で, + + 以下のフラグ文字のどれか (デフォルト値は"l")を設定できます: + + + + + + + + Windowsにおけるデフォルトの動作では,バイト13 + + (0x0D)をスキップします. + + 'b'を指定してmopenを + + コールする必要があります. + + 例えば, 例外なく全てのバイトを読み込むには, + + fd1 = mopen(file1,'rb') とします. + + + + + + データ型: + + + + + + d + + + + double + + + + + + + + f + + + + float + + + + + + + + l + + + + long + + + + + + + + i + + + + int + + + + + + + + s + + + + short + + + + + + + + c + + + + character + + + + + + + + オプションのフラグ: + + + + + + u.. + + + + 符号なし (上記の型のどれかと組み合わせます) + + + + + + + + ..l + + + + リトルインディアン (上記の型のどれかと組み合わせます) + + + + + + + + ..b + + + + ビッグインディアン (上記の型のどれかと組み合わせます) + + + + + + + + + + (little=endianステータスをチェックすることにより) + + 読み込まれたバイトは必要に応じて自動的にスワップされます. + + + + + + このデフォルトのスワップ動作は + + mopen関数にフラグを追加することにより抑制することが + + できます. + + + + + フォーマット "l", "d" + + および "f" は, mget + + 関数でのみ有効です. + + + + + + + + + + mget(1,'ull',fd1) + write(%io(2),'Bug'); +end + +fd2=mopen(file2,'rb'); +if 1996<>mget(1,'ull',fd2) + write(%io(2),'Bug'); +end + +mclose(fd1); +mclose(fd2); + ]]> + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mgetl + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputl + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mgetl.xml b/modules/fileio/help/ja_JP/mgetl.xml new file mode 100755 index 000000000..ea9e8f7a5 --- /dev/null +++ b/modules/fileio/help/ja_JP/mgetl.xml @@ -0,0 +1,203 @@ + + + + + + + + + mgetl + + アスキーファイルから行を読み込む + + + + + + 呼び出し手順 + + txt = mgetl(file_desc [,m]) + + + + + + 引数 + + + + + + file_desc + + + + + + ファイル名を指定する文字列またはmopen + + により返された論理ユニットを指定する整数 + + + + + + + + + + m + + + + 整数スカラー: 読み込む行の数. デフォルト値は -1です. + + + + + + + + txt + + + + 文字列の列ベクトル + + + + + + + + + + + + 説明 + + + + mgetl関数はアスキーファイルから行を読み込みます. + + + + + + mが省略されるか -1 の場合, + + ファイルの終わりまで全ての行が読み込まれます. + + + + + + mが指定された場合, + + mgetlは正しくm行を読み込もうとします. + + このオプションはファイルの一部を連続的に読み込む場合に有用です. + + この際, m行が読み込まれる前にファイル終端(EOF)に + + 到達した場合,読み込まれた行が返されます + + (meof関数によりEOFに達したかどうかを調べることができます). + + + + + + mgetlは, Unix, Windows, または Mac + + オペレーティングシステムからファイルを読み込むことができます. + + + + + + + + + + + + + + + + 参照 + + + + + + mputl + + + + + + mclose + + + + + + mfscanf + + + + + + mget + + + + + + mput + + + + + + mgetstr + + + + + + mopen + + + + + + read + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mgetstr.xml b/modules/fileio/help/ja_JP/mgetstr.xml new file mode 100755 index 000000000..33a9a3ee1 --- /dev/null +++ b/modules/fileio/help/ja_JP/mgetstr.xml @@ -0,0 +1,256 @@ + + + + + + + + + mgetstr + + ファイルから文字列を読み込む + + + + + + 呼び出し手順 + + str = mgetstr(n [,fd]) + + + + + + 引数 + + + + + + n + + + + + + 非負の整数: 読み込む文字数. + + + + + + + + + + fd + + + + + + 整数:mopen + + から返され, 文字を読み込むファイル記述子. + + -1は, + + 直近にオープンされたファイルを意味します. + + + + + + + + + + str + + + + 読み込まれた文字列 + + + + + + + + + + + + 説明 + + + + mgetstr関数は, + + ファイルから最大n文字を + + 読込みます. + + n文字を読み込む前に + + ファイル終端に達した場合, + + mgetstrは + + 適切に読み込まれた値のみを返します. + + この結果, mgetstrコール時に + + リードカーソルが既にファイル終端にあった場合, + + nの設定値によらず + + 空の文字列が返されます. + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mopen.xml b/modules/fileio/help/ja_JP/mopen.xml new file mode 100755 index 000000000..48610f334 --- /dev/null +++ b/modules/fileio/help/ja_JP/mopen.xml @@ -0,0 +1,632 @@ + + + + + + + + + mopen + + ファイルをオープン + + + + + + 呼び出し手順 + + [fd, err] = mopen(file [, mode, swap ]) + + + + + + 引数 + + + + + + file + + + + オープンするファイルのパスを有する文字列. + + + + + + + + mode + + + + + + ファイルにリクエストするアクセスモードを指定する文字列. + + + + + + + + + + swap + + + + + + スカラー. swap が存在し, + + swap = 0の場合, + + 自動バイトスワップは無効になります. + + + + デフォルト値は 1です. + + + + + + + + err + + + + スカラー. エラーインジケータ. + + + + + + エラー値: + + エラーメッセージ: + + + + + + 0 + + エラー無し + + + + + + -1 + + 論理ユニットがなくなりました + + + + + + -2 + + ファイルをオープンできませんでした + + + + + + -3 + + メモリがなくなりました + + + + + + -4 + + 名前が無効 + + + + + + -5 + + 無効なステータス + + + + + + + + + + + + fd + + + + + + スカラー: ファイル記述子(正の整数). + + + + + + + + + + + + + + 説明 + + + + mopenは,C言語のfopen + + プロシージャと互換の方法でfileをオープンするために + + 使用できます. + + swap引数が指定されない場合, + + ファイルが"リトルインディアン IEEE 形式"でコード化されていると + + 仮定されます. + + プロセッサのIEEE形式と一致させる必要がある場合, + + データはスワップされます. + + + + + + modeパラメータは,ストリームにリクエストされる + + アクセス型を制御します. + + パラメータには以下の値の一つを指定することができます: + + + + + + r + + + + + + 読み込み用にオープン(デフォルト). + + ファイルは存在する必要があり,そうでない場合は失敗します. + + + + + + + + + + w + + + + + + 書き込み用にオープン. + + ファイルが存在する場合,その内容は破棄されます. + + + + + + + + + + a + + + + + + 追記用にオープン. + + ファイルが存在しない場合は作成されます. + + + + + + + + + + r+ + + + + + + 読込みおよび書き込み両方でオープン. + + ファイルは存在する必要があり,そうでない場合は失敗します. + + + + + + + + + + w+ + + + + + + 読込みおよび書き込み両方でオープン. + + ファイルが存在する場合,その内容は破棄されます. + + + + + + + + + + a+ + + + + + + 読込みおよび書き込み両方でオープン. + + ファイルが存在しない場合は作成されます. + + + + + + + + + + + + + + 加えて, ファイルの型を指定するために以下の文字を使用できます: + + + + + + t + + + + テキストファイル. + + + + + + + + b + + + + バイナリファイル (デフォルト). + + + + + + + + + + + + デフォルトのアクセスモードは 'rb' + + (バイナリファイル読込み)です. + + + + + + + + 注意: Windowsでは, テキストファイルモードで, CR (復改) - LF (ラインフィード) + + の組は読込み次にLFに変換され, + + LFは書き込み時に CR-LF の組に変換されます. + + + + + + + + 更新用にファイルをオープンする際, + + 結果のストリームに入力および出力の両方の処理を行うことができます. + + しかし,ファイル中の位置決め処理(mseek関数)を行わずに + + 出力処理を入力処理の直後に行うことはできません. + + また,入力処理がファイルの終端に達しない限り, + + ファイルの位置決め処理を中断せずに + + 入力処理を出力処理の直後に行うことはできません. + + + + + + ファイルを追記用にオープンする場合(つまり,modeパラメータが + + aまたはa+の場合), + + ファイルにすでにある情報を上書きすることは + + できません. mseek関数により, + + ファイルの任意の位置にファイルポインタを移動することができますが, + + 出力をファイルに書き込む際に,カレントのファイルポインタは無視されます. + + 全ての出力はファイルの終端に書き込まれ, + + ファイル位置は出力の末尾に移動されます. + + + + + + Fortran関数と互換性のある方法でファイルをオープンするには, + + file関数を使用してください. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + merror + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetl + + + + + + mgetstr + + + + + + mprintf + + + + + + mput + + + + + + mputl + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/movefile.xml b/modules/fileio/help/ja_JP/movefile.xml new file mode 100755 index 000000000..f76b24ad9 --- /dev/null +++ b/modules/fileio/help/ja_JP/movefile.xml @@ -0,0 +1,201 @@ + + + + + + + + + movefile + + ファイルまたはディレクトリを移動する + + + + + + 呼び出し手順 + + movefile(source, destination) + + [status, message] = movefile(source, destination) + + + + + + + + 引数 + + + + + + source + + + + + + 文字列. + + + + + + + + + + destination + + + + + + 文字列. + + + + + + + + + + status + + + + + + 整数: 処理ステータス. + + + + + + + + + + message + + + + + + 文字列: エラーに関するメッセージ. + + + + + + + + + + + + + + 説明 + + + + movefile(source, destination)は, + + ファイルまたはディレクトリ + + source(およびサブディレクトリ)を + + をファイルまたはディレクトリdestination + + に移動します. + + + + + + sourceがディレクトリの場合, + + destinationにファイルを指定することは + + できません. + + + + movefile + + は,警告を発生せずに既存のファイルを置換します. + + + + + + + + [status, message] = movefile(source, destination)は, + + sourceからdestination + + に移動し,statusmessageを返します. + + + + + + どのようなオペレーティングシステムであろうと, + + 移動に成功した場合,statusは1となり, + + messageは空になります ; + + 移動に失敗した場合, + + statusは0となり,messageは空でなくなります. + + + + + + + + + + + + + + + + 参照 + + + + + + copyfile + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mput.xml b/modules/fileio/help/ja_JP/mput.xml new file mode 100755 index 000000000..a864c0a80 --- /dev/null +++ b/modules/fileio/help/ja_JP/mput.xml @@ -0,0 +1,330 @@ + + + + + + + + + mput + + 指定したバイナリ形式でバイトまたはワードを書き込む + + + + + + 呼び出し手順 + + mput(x [, type, fd]) + + + + + + 引数 + + + + + + x + + + + 浮動小数点数または整数型の数値のベクトル + + + + + + + + fd + + + + + + スカラー: mopen関数により返された + + ファイル記述子. + + -1は,直近にオープンされたファイルを意味します. + + デフォルト値は-1です. + + + + + + + + + + type + + + + + + 文字列: xの全エントリを書き込む際に + + 使用されるバイナリ形式を指定. + + + + + + + + + + + + + + 説明 + + + + mput 関数は, + + ストリームパラメータfdで指定した出力先にデータを + + を書き込みます. + + データはポインタのカレントの位置に書き込まれ, + + ポインタのインジケータは前に適当に前に移動されます. + + + + + + typeパラメータは変換指定子で, + + 以下のフラグ文字(デフォルト値 "l") + + のどれかを指定します: + + + + + + + + "l", "i", "s", "ul", "ui", "us", "d", "f", "c", "uc" + + + + + + それぞれ long long, int (long int), short, unsigned long long int, + + unsigned int (long int), unsigned short, + + double, float, char, unsigned char を書き込みます. + + 書き込んだバイトは,(リトルインディアンモードで)マシンに + + 依存するバイナリファイルを出力するために + + (リトルインディアンステータスを確認することにより) + + 必要に応じて自動的にスワップされます. + + このデフォルトのスワップモードは,mopen関数に + + フラグswap = 0を追加することにより抑制できます. + + + + + + + + + + "..l" または "..b" + + + + + + "l"または"b"文字を + + type指定子の末尾に追加することにより, + + リトルインディアンまたはビッグインディアンモードで書き込むことも可能です. + + 例えば,"db"はビッグインディアンモードでdoubleを書き込みます. + + + + + + + + + + + + + + + + mget(1,'l') then pause,end +if 1996<>mget(1,'i') then pause,end +if 1996<>mget(1,'s') then pause,end +if 98<>mget(1,'c') then pause,end +// リトルインディアンを強制 +if 1996<>mget(1,'ll') then pause,end +if 1996<>mget(1,'il') then pause,end +if 1996<>mget(1,'sl') then pause,end +if 98<>mget(1,'cl') then pause,end +// ビッグインディアンを強制 +if 1996<>mget(1,'lb') then pause,end +if 1996<>mget(1,'ib') then pause,end +if 1996<>mget(1,'sb') then pause,end +if 98<>mget(1,'cb') then pause,end +mclose(); + ]]> + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetl + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mputl + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mputl.xml b/modules/fileio/help/ja_JP/mputl.xml new file mode 100755 index 000000000..0283fd195 --- /dev/null +++ b/modules/fileio/help/ja_JP/mputl.xml @@ -0,0 +1,195 @@ + + + + + + + + + mputl + + テキストファイルに文字列を書き込む + + + + + + 呼び出し手順 + + r = mputl(txt, file_desc) + + + + + + 引数 + + + + + + r + + + + + + 関数がファイルに正しく書き込んだかどうかをチェックするために + + %tまたは%fを返します. + + + + + + + + + + file_desc + + + + + + ファイル名を指定する文字列または + + + + + + 整数スカラー: + + mopen関すから返されたファイル記述子. + + + + + + + + + + txt + + + + 文字列のベクトル. + + + + + + + + + + + + 説明 + + + + mputl関数により,文字列ベクトルを + + 一連の行としてテキストファイルに書き込むことができます. + + + + + + mputl は,ANSI/アスキー および UTF-8 + + でエンコードされた文字列をサポートします. + + + + + + + + + + + + + + + + 参照 + + + + + + mget + + + + + + mgetl + + + + + + mclose + + + + + + mfprintf + + + + + + mput + + + + + + mputstr + + + + + + mopen + + + + + + write + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mputstr.xml b/modules/fileio/help/ja_JP/mputstr.xml new file mode 100755 index 000000000..54fa3e2df --- /dev/null +++ b/modules/fileio/help/ja_JP/mputstr.xml @@ -0,0 +1,215 @@ + + + + + + + + + mputstr + + ファイルに文字列を書き込む + + + + + + 呼び出し手順 + + mputstr(str [, fd]); + + + + + + 引数 + + + + + + fd + + + + + + スカラー: mopen関数により返されたファイル記述子. + + -1は直近にオープンされたファイルを意味します. + + デフォルト値は-1です. + + + + + + + + + + str + + + + 文字列. + + + + + + + + + + + + 説明 + + + + mputstr 関数により文字列strを + + バイナリファイルに書き込むことが可能です. + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mseek.xml b/modules/fileio/help/ja_JP/mseek.xml new file mode 100755 index 000000000..b4d859d88 --- /dev/null +++ b/modules/fileio/help/ja_JP/mseek.xml @@ -0,0 +1,283 @@ + + + + + + + + + mseek + + バイナリファイルの中でカレントの位置を設定する. + + + + + + 呼び出し手順 + + mseek(n [,fd, flag]) + + + + + + 引数 + + + + + + n + + + + スカラー: オフセット(単位:バイト数). + + + + + + + + fd + + + + + + スカラー: mopen関数により返されたファイル記述子. + + -1は直近にオープンされたファイルを意味します. + + デフォルト値は-1です. + + + + + + + + + + flag + + + + + + 文字列: 原点を指定. デフォルト値 'set'. + + + + + + + + + + + + + + 説明 + + + + 関数 mseekは,ストリームfd上での + + 次の入力または出力処理の位置を設定します. + + 新たな位置は,符号付きの位置を表すバイト数nで指定した位置となります. + + この値の意味は, flag の値,つまり, + + 'set', 'cur' または 'end' + + に基づき,先頭位置から,または,現在位置から,または,ファイル終端からとなります. + + これが, flag'set'の場合に + + nを正としなければならない理由です. + + + + + + mseek により + + ファイルの既存のデータの終端より後の部分にファイル位置インジケータを + + 設定することができるようになります. + + データがこのような場所に書き込まれた時, + + 隙間にあるデータが読み込まれた場合に, + + 隙間に実際に書き込まれたデータに達するまでは + + 0 が返されます. + + mseekは,それ自体では, + + ファイルの大きさを拡張しません. + + + + + + + + + + res then + write(%io(2),'Bug'); +end +mseek(0,fd1,'set'); + +// 保存されたデータより多くのデータを読み込む +res1=mget(100,'d',fd1); +if res1<>res then + write(%io(2),'Bug'); +end +meof(fd1) +mclearerr(fd1) +mclose(fd1); + ]]> + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/mtell.xml b/modules/fileio/help/ja_JP/mtell.xml new file mode 100755 index 000000000..5cfed12bb --- /dev/null +++ b/modules/fileio/help/ja_JP/mtell.xml @@ -0,0 +1,210 @@ + + + + + + + + + mtell + + ファイル先頭基準でカレントバイトのオフセットを返す + + + + + + 呼び出し手順 + + mtell([fd]) + + + + + + 引数 + + + + + + fd + + + + + + スカラー: mopen関数により返されたファイル記述子. + + -1は直近にオープンされたファイルを意味します. + + デフォルト値は-1です. + + + + + + + + + + + + + + 説明 + + + + 関数 mtell は, + + 名前付きのストリームfdが指すファイルの先頭を基準として + + カレントのバイトのオフセットを返します. + + + + + + + + + + + + + + + + 参照 + + + + + + mclose + + + + + + meof + + + + + + mfprintf + + + + + + fprintfMat + + + + + + mfscanf + + + + + + fscanfMat + + + + + + mget + + + + + + mgetstr + + + + + + mopen + + + + + + mprintf + + + + + + mput + + + + + + mputstr + + + + + + mscanf + + + + + + mseek + + + + + + mtell + + + + + + mdelete + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/newest.xml b/modules/fileio/help/ja_JP/newest.xml new file mode 100755 index 000000000..950cd8116 --- /dev/null +++ b/modules/fileio/help/ja_JP/newest.xml @@ -0,0 +1,132 @@ + + + + + + + + + newest + + ファイルの集合の中で最新のファイルを返す + + + + + + 呼び出し手順 + + k = newest(paths) + + k = newest(path1, path2, ..., pathn) + + + + + + + + 引数 + + + + + + k + + + + 整数: 最新のファイルの添字 + + + + + + + + paths + + + + + 文字列ベクトル, paths(i)i番目のファイルの名前 + + + + + + + + + pathi + + + + + 文字列, i番目のファイルのパス名 + + + + + + + + + + + + + 説明 + + + + パス名の集合を指定すると,newestは, + + 最新のファイルの添字を返します. + + 存在しないファイルは最も古いと仮定されます. + + + + + + + + + + + + + + + + 参照 + + + + + + fileinfo + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/CHAPTER b/modules/fileio/help/ja_JP/path_filename/CHAPTER new file mode 100755 index 000000000..7475b052d --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/CHAPTER @@ -0,0 +1,2 @@ +title = Paths - Filenames + diff --git a/modules/fileio/help/ja_JP/path_filename/basename.xml b/modules/fileio/help/ja_JP/path_filename/basename.xml new file mode 100755 index 000000000..e5aea04d0 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/basename.xml @@ -0,0 +1,84 @@ + + + + + basename + ファイル名からディレクトリと接尾辞を取り除く + + + 呼び出し手順 + files= basename(files[,flag [,flagexpand]]) + + + パラメータ + + + files + + ファイル名の集合を指定する文字列行列. + + + + flag,flagexpand + + オプションの論理値パラメータ. (デフォルト値 + %t). + + + + + files + + 文字列行列. + + + + + + 説明 + + basename は指定したファイル名の + エントリの基本部分を返します. + + + flag が真の場合,ファイルは + getos() == 'Windows'変数で指定した目標型にまず変換されます. + さらに, flagexpandが真の場合, + HOME, SCI または ~ + のような基準となる変数は環境変数により展開されます. + + + + + + + + 参照 + + + listfiles + + + pathconvert + + + fileparts + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/dirname.xml b/modules/fileio/help/ja_JP/path_filename/dirname.xml new file mode 100755 index 000000000..76b0bf4eb --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/dirname.xml @@ -0,0 +1,91 @@ + + + + + dirname + ファイル名からディレクトリを得る + + + 呼び出し手順 + dirs = dirname(files[,flag [,flagexpand]]) + + + パラメータ + + + files + + ファイル名の集合を指定する文字列行列. + + + + flag, flagexpand + + + オプションの論理値パラメータ. (デフォルト値 %t). + + + + + files, dirs + + 文字列行列. + + + + + + 説明 + + dirnamefiles で指定したファイルエントリの + ディレクトリ名を返します. + + + flag が真の場合, files は + getos() == 'Windows'変数で指定した目標型にまず + 変換されます. + 更に, flagexpand が真の場合, + HOME, SCI または ~ + のような接頭文字列は環境変数を用いて展開されます. + + + dirname(files,%f) は, + files に指定したパス名が + getos() == 'Windows'変数により指定される変換に従わない + 場合に間違った結果を出力することがあるため,注意を要します. + + + + + + + + 参照 + + + basename + + + listfiles + + + pathconvert + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/fileext.xml b/modules/fileio/help/ja_JP/path_filename/fileext.xml new file mode 100755 index 000000000..1beaa8c94 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/fileext.xml @@ -0,0 +1,62 @@ + + + + + fileext + ファイルパスの拡張子を返す + + + 呼び出し手順 + extension = fileext(fullpath) + + + パラメータ + + + fullpath + + 文字列, 指定するファイルパス + + + + extension + + 文字列, 拡張子部または '' + + + + + + 説明 + + extension=fileext(fullpath) は + フルパス文字列をドットを含む拡張子部に分割します. + + + + + + + + 参照 + + + fileparts + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/fileparts.xml b/modules/fileio/help/ja_JP/path_filename/fileparts.xml new file mode 100755 index 000000000..5550cba75 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/fileparts.xml @@ -0,0 +1,100 @@ + + + + + fileparts + ファイルパスのパス,ファイル名,拡張子を返す + + + 呼び出し手順 + [path,fname,extension]=fileparts(fullpath) + v=fileparts(fullpath,sel) + + + + パラメータ + + + fullpath + + 文字列, 指定したファイルパス + + + + sel + + オプションの文字列セレクタ, 以下の値を指定可能: + 'path', 'fname' または 'extension' + + + + + path + + 文字列, フルパスで指定したディレクトリパス + + + + fname + + 文字列, ファイル名または '' + + + + extension + + 文字列, 拡張子部または '' + + + + value + + + 文字列, selの値に依存 + + + + + + + 説明 + + [path,fname,extension]=fileparts(fullpath) は + フルパスの文字列を以下の3つの部分に分割します: + ディレクトリを指すパス, ファイル名の部分, + ドットを含む拡張子の部分. + + + + + + + + 参照 + + + pathconvert + + + basename + + + fullfile + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/filesep.xml b/modules/fileio/help/ja_JP/path_filename/filesep.xml new file mode 100755 index 000000000..0f558e4b3 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/filesep.xml @@ -0,0 +1,48 @@ + + + + + filesep + カレントのプラットフォームにおけるディレクトのリセパレータを返す + + + + 呼び出し手順 + s = filesep() + + + パラメータ + + + s + + a string + + + + + + 説明 + rディレクトのリセパレータを返します. + ( GNU/Linuxでは'/', Windowsでは'\' ) + + + + rei + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/fullfile.xml b/modules/fileio/help/ja_JP/path_filename/fullfile.xml new file mode 100755 index 000000000..104db0c18 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/fullfile.xml @@ -0,0 +1,70 @@ + + + + + fullfile + パーツから完全なファイル名を構築 + + + 呼び出し手順 + f = fullfile(varargin) + + + パラメータ + + + varargin + + + 完全なファイル名を構築するために使用される全てのディレクトリとファイル名 + (少なくとも一つのディレクトリおよびファイル名) + + + + + f + + 完全なファイル名 + + + + + + 説明 + + f= fullfile(varargin) は, + 実行されるプラットフォームを考慮した + 完全なファイル名を構築します. + この際,ディレクトリがディレクトリセパレータで + 開始または終了するケースを処理します. + + + + + + + + 参照 + + + pathconvert + + + fileparts + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/fullpath.xml b/modules/fileio/help/ja_JP/path_filename/fullpath.xml new file mode 100755 index 000000000..943672516 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/fullpath.xml @@ -0,0 +1,76 @@ + + + + + fullpath + + 指定した相対パス名に関する完全なパス名を作成する. + + + + 呼び出し手順 + res = fullpath(relative_path) + + + 引数 + + + res + + 文字列または文字列の行列 + + + + + + relative_path + + 文字列または文字列の行列 + + + + + + 説明 + + fullpath(relative_path)は, + 指定した相対パス名に関する完全なパス名を作成します. + + + + + + + + 履歴 + + + 5.4.0 + 管理された文字列の行列 (SEP 72) + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/get_absolute_file_path.xml b/modules/fileio/help/ja_JP/path_filename/get_absolute_file_path.xml new file mode 100755 index 000000000..f2b857cf4 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/get_absolute_file_path.xml @@ -0,0 +1,88 @@ + + + + + get_absolute_file_path + + Scilabでオープンしたファイルの絶対パス名を出力します. + + + + 呼び出し手順 + pathname = get_absolute_file_path(filename) + + + パラメータ + + + filename + + 文字列 : ファイル名 + + + + pathname + + 文字列 : 絶対パス名 + + + + + + 説明 + + Scilabですでにオープンしている + ファイルの絶対パス名を出力します. + + get_absolute_file_path は + Scilabで現在オープンしているファイルの内部リストの中で + filename を検索し,そのパスを返します. + + "get_absolute_file_path" は, + Scilabが現在オープンしているファイルの内部リストの中で + "filename" を検索し,そのパスを出力します. + + オープンされていない場合,エラーを返します. + 警告 : 以前のバージョン (scilab 5.0.x) では, + ファイルが見つからない場合, + カレントのディレクトが返されていました. + + この関数は, + Scilabスクリプトを実行する(パス)を見つけるために + 使用することができます. + + + + + + + + 参照 + + + getshortpathname + + + getlongpathname + + + pwd + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/getdrives.xml b/modules/fileio/help/ja_JP/path_filename/getdrives.xml new file mode 100755 index 000000000..5d06ecdca --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/getdrives.xml @@ -0,0 +1,55 @@ + + + + + getdrives + + コンピュータのファイルシステムにマウントされている全ての + ドライブ名を取得する. + + + + 呼び出し手順 + drives = getdrives() + + + パラメータ + + + drives + + 文字列の行列 + + + + + + 説明 + コンピュータのファイルシステムにマウントされている全てのドライブ名を取得します. + + コンピュータのファイルシステムにマウントされている全てのルートを + 文字列の行列として返します. + + Linuxでは, + このリストはただ一つのルートディレクトリ / により構成されます. + this list consists solely of the root directory, / . + + + + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/getlongpathname.xml b/modules/fileio/help/ja_JP/path_filename/getlongpathname.xml new file mode 100755 index 000000000..58304d4d6 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/getlongpathname.xml @@ -0,0 +1,73 @@ + + + + + getlongpathname + ロングパス名を取得 (Windows専用) + + + 呼び出し手順 + longpath=getlongpathname(shortpath) + [longpath,bOK]=getlongpathname(shortpath) + + + + パラメータ + + + shortpath + + ショートパスの文字列または文字列行列 + + + + longpath + + ロングパスの文字列または文字列行列 + + + + bOK + + パスが変換された場合は論理値 %T または論理値の行列, + そうでない場合は %F + + + + + + + 説明 + getlongpathname プリミティブは, + 指定されたパスをそのロング名に変換します. + ロングパス名が見つからない場合, + このプリミティブは指定した名前を返します. + + + + + + + + 参照 + + + getshortpathname + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/getrelativefilename.xml b/modules/fileio/help/ja_JP/path_filename/getrelativefilename.xml new file mode 100755 index 000000000..c8a9b42e2 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/getrelativefilename.xml @@ -0,0 +1,88 @@ + + + + + getrelativefilename + 絶対ディレクトリおよび絶対ファイル名を指定すると, + 相対ファイル名を返す. + + + + 呼び出し手順 + rel_file = getrelativefilename(abs_dir,abs_file) + + + パラメータ + + + abs_dir + + 文字列 : 絶対ディレクトリ + + + + abs_file + + 文字列 : 絶対ファイル名 + + + + rel_file + + 文字列 : 相対ファイル名 + + + + + + 説明 + 絶対ディレクトリおよび絶対ファイル名を指定すると, + 相対ファイル名を返します. + + 例えば, カレントのディレクトが C:\scilab\bin の場合,ファイル名 + C:\scilab\modules\helptools\readme.txt が指定されると, + getrelativefilename は ..\modules\helptools\readme.txt を返します. + + + + + + + + 参照 + + + getshortpathname + + + getlongpathname + + + pwd + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/getshortpathname.xml b/modules/fileio/help/ja_JP/path_filename/getshortpathname.xml new file mode 100755 index 000000000..f0e2489b6 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/getshortpathname.xml @@ -0,0 +1,71 @@ + + + + + getshortpathname + ショートパス名を取得 (Windows専用) + + + Calling Sequence + shortpath=getshortgpathname(longpath) + [shortpath,bOK]=getshortpathname(longpath) + + + + パラメータ + + + longpath + + ロングパスの文字列または文字列行列 + + + + shortpath + + ショートパスの文字列または文字列行列 + + + + bOK + + パスが変換された場合は論理値 %T または論理値行列 + そうでない場合は %F + + + + + + + 説明 + getshortpathname プリミティブは指定したパスを + そのショート形式に変換します. + + + + + + + + 参照 + + + getlongpathname + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/is_absolute_path.xml b/modules/fileio/help/ja_JP/path_filename/is_absolute_path.xml new file mode 100755 index 000000000..31ddd3684 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/is_absolute_path.xml @@ -0,0 +1,68 @@ + + + + + is_absolute_path + 引数が絶対パスかどうか調べる + + + 呼び出し手順 + r = is_absolute_path(path) + + + 引数 + + + path + + 文字列または文字列の行列: ディレクトリパス名. + + + + r + + + 論理値: path が絶対パスの場合に + %t + + + + + + + 説明 + + r = is_absolute_path(path) は + pathが絶対パスかどうかを調べます. + + + + + + + + 参照 + + + get_absolute_file_path + + + fileparts + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/pathconvert.xml b/modules/fileio/help/ja_JP/path_filename/pathconvert.xml new file mode 100755 index 000000000..01300ff3a --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/pathconvert.xml @@ -0,0 +1,112 @@ + + + + + pathconvert + POSIXおよびwindowsの間でパス名を変換. + + + 呼び出し手順 + paths=pathconvert(paths [,flagtrail [,flagexpand [,type]]]) + + + パラメータ + + + paths + + パス名を指定する文字列行列 + + + + flagtrail + + オプションの論理値パラメータ.デフォルト値は TRUE. + + + + flagexpand + + オプションの論理値パラメータ. デフォルト値はMSDOS変数に依存. + + + + type + + + 文字列 'u' または 'w'. + + + + + + + 説明 + + pathconvert は, + (文字列行列 pathsで指定した) + パス名の集合を + windowsネーティブなファイル名からPOSIX形式のファイル名に変換したり, + 戻すことができます. + 変換後の形式はオプションの文字列typeで指定でき, + Unixの場合は 'u',Windowsの場合は'w' + を指定できます. + デフォルトの形式はgetos() == "Windows"の値に基づき設定されます. + getos() == "Windows"が TRUE (またはFALSE) の場合, + デフォルトの形式は 'w' (または 'u')となります. + + + name:で始まる + Windows のパス名は cygwinの表記法に基づき + /cygdrive/name/で始まるパス名に変換されます. + + + flagtrail はオプションの論理値パラメータです. + その値をTRUE (デフォルト値)にした時, + 末尾セパレータ + ('\' または '/') + が抜けている場合にパスの最後に追加されます. + flagtrail が FALSE に設定されている場合, + 末尾セパレータは削除されます. + + + flagexpand はオプションの論理値パラメータです. + この値が TRUEの場合, + HOME, SCI または ~ + のような先頭文字列は環境変数により展開されます. + + + + + + + + 参照 + + + basename + + + listfiles + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/pathsep.xml b/modules/fileio/help/ja_JP/path_filename/pathsep.xml new file mode 100755 index 000000000..e08ca8426 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/pathsep.xml @@ -0,0 +1,44 @@ + + + + + pathsep + カレントのプラットフォームのパスセパレータを返す + + + 呼び出し手順 + s = pathsep() + + + パラメータ + + + s + + 文字列 + + + + + + 説明 + パスセパレータを返します. ( Linuxでは ':', Windows では ';' ) + + + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/splitURL.xml b/modules/fileio/help/ja_JP/path_filename/splitURL.xml new file mode 100755 index 000000000..31567b6be --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/splitURL.xml @@ -0,0 +1,144 @@ + + + + + splitURL + URL (HTTP, HTTPS, FTP...) を分解 + + + 呼び出し手順 + [proto, server, path, query, username, port, fragment] = splitURL(URL); + + + + 引数 + + + URL + + 文字列: URL. サポート/テスト済み: HTTP, HTTPS, FTP (IPv4 および IPv6) + + + + proto + + + 文字列: プロトコル (例: http, ftp, 等) + + + + + server + + + 文字列: サーバー (例: www.scilab.org) + + + + + path + + + 文字列: パス (例: /products/scilab) + + + + + query + + + 文字列: クエリ (例: ?SearchText=plot3d) + + + + + username + + + 文字列: ユーザ名 (例: username:pass) + + + + + port + + + int: ポート (例: 80) + + URLにポートが指定されない場合, 値は 0となることに注意してください. + + + + fragment + + + 文字列: フラグメント (例: #chapter1) + + フラグメントはアンカーとも呼ばれ, + HTML文書内にブックマークを作成する際に使用されます. + + + + + + + 説明 + URLを要素毎に分解します. + + この関数は libxml2ライブラリ + (特に, 関数 xmlParseURI) + + に基づいています. + + + + + + [proto, server, path, query, username, port, fragment] = splitURL("http://xmlsoft.org/html/libxml-uri.html#xmlParseURI") + [proto, server, path] = splitURL("ftp://ftp.free.fr/pub/Distributions_Linux/debian/README") + [a,b,c,d]=splitURL("http://www.scilab.org/content/search?SearchText=plot") + + + + + 参照 + + + getURL + + + + + 履歴 + + + 5.5.0 + この関数はScilab 5.5.0で追加されました + + + + diff --git a/modules/fileio/help/ja_JP/path_filename/tempname.xml b/modules/fileio/help/ja_JP/path_filename/tempname.xml new file mode 100755 index 000000000..f12ea54c4 --- /dev/null +++ b/modules/fileio/help/ja_JP/path_filename/tempname.xml @@ -0,0 +1,74 @@ + + + + + tempname + + ユニークなファイル名を有するファイルを作成 + + + + 呼び出し手順 + tmp_name = tempname([prefix]) + + + 引数 + + + tmp_name + + 文字列 + + + + + + prefix + + 文字列: ファイル名の接頭辞(Windowsでは,最大3文字). + + + + + + 説明 + + tempnameは, + ユニークなファイル名を有するファイルをTMPDIR ディレクトリに作成します. + + + tmp_name = tempname() は,テンポラリなファイル名として使用可能な + ユニークな文字列, tmp_nameを返します. + + + + + + + + 履歴 + + + 5.4.0 + + 関数tempnameが導入されました. + + + + + diff --git a/modules/fileio/help/ja_JP/save_format.xml b/modules/fileio/help/ja_JP/save_format.xml new file mode 100755 index 000000000..ea1d55e31 --- /dev/null +++ b/modules/fileio/help/ja_JP/save_format.xml @@ -0,0 +1,1595 @@ + + + + + + + save_format + + "save"で作成されるファイルの形式 + + + + + + 概要 + + 本文書の目的はデータをScilabでデータ保存に使用されるHDF5形式について規定することです. + + + + この形式はSOD (Scilab Open Data) と呼ばれます. + + SODの最初の公開リリースは Scilab 5.4.0で行われました. + + + + + + 動機 + + + + 相互運用性は近代的なソフトウエアの主要な特性の一つです. + + この特性をより改善するため, このSEPにおいて HDF5 形式の標準定義 + + が提案されました. + + + + + + Scilab 5.2.0以降, + + エキスポート/インポート機能が開発され, データ交換用に管理されています. + + これは, 既にデータを保存および交換するためのXcosの基本要素の一つです. + + + + + + + + サポートされるデータ型 + + 全てのScilabデータ型がサポートされます. 例えば: + + + + + + + + + + 名前 + + + + + + Scilabにおける例 + + + + + + + + + + double + + + + + + A=32; + + b=[32,2]; + + c=[2,2;3,4]; + + d=rand(10,10); + + + + + + + + + + string + + + + + + a="my string"; + + b=["string 1";"my string 2"]; + + + + + + + + + + boolean + + + + + + a=%t; + + b=[%t, %f]; + + + + + + + + + + integer + + + + + + + + int8([1 -120 127 312]) + + x=int32(-200:100:400) + + + + + + + + + + + + polynomial + + + + + + + + s=poly([2 3],"s") + + poly(1:4,'s','c') + + + + + + + + + + + + sparse + + + + + + + + sp=sparse([1,2;4,5;3,10],[1,2,3]) + + + + + + + + + + + + boolean sparse + + + + + + + + dense=[%F, %F, %T, %F, %F + + %T, %F, %F, %F, %F + + %F, %F, %F, %F, %F + + %F, %F, %F, %F, %T]; + + sp=sparse(dense) + + + + + + + + + + + + list + + + + + + + + l = list(1,["a" "b"]) + + + + + + + + + + + + tlist + + + + + + + + t = tlist(["listtype","field1","field2"], [], []); + + + + + + + + + + + + mlist + + + + + + + + M=mlist(['V','name','value'],['a','b';'c' 'd'],[1 2; 3 4]); + + + + + + + + + + + + + + 複数の"types"は,tlist または mlist + + に基づいています. + + これは, + + rational, state-space, + + hypermat, cell および + + structの場合です. + + これらは透過的に保存されます. + + + + + + voidおよび undefinedは, + + リスト管理において特別な場合を管理するために作成された特殊な要素です. + + これらはこの文書にて後述します. + + + + + + + + HDF5ファイルの構造 + + Scilab HDF5 アーキテクチャは非常に簡単です. + + General + + + + 各Scilab変数について, ルート位置におけるデータセットが宣言されます. + + データセットの名前はScilab変数の名前です. + + + + 例, 以下のコード: + + + + emptyuint32matrix = uint32([]); + + uint32scalar = uint32(1); + + uint32rowvector = uint32([1 4 7]); + + uint32colvector = uint32([1;4;7]); + + uint32matrix = uint32([1 4 7;9 6 3]); + + save("uint32.sod","emptyuint32matrix","uint32scalar","uint32rowvector","uint32colvector","uint32matrix"); + + + + produces: + + + + + + + + + + + + + + 各ルートデータセットはSCILAB_Classと呼ばれる + + 属性を有します.この属性は, HDF5ファイルに保持される変数の型を定義します. + + + + + + 変数がプリミティブ型で関連する複合値がない場合, + + データは直接データセットに保存されます. + + それ以外の場合, データセットは実際のデータへのリファレンスを有します. + + + + 各 SOD ファイルは2つの固有の変数を有します: + + + + + + + + SCILAB_scilab_version ? + + SODファイルに保存する際に使用された Scilabのバージョンを記述します. + + + + 例えば, Scilab 5.4.0の場合, このデータは以下となります: + + + + SCILAB_scilab_version = scilab-5.4.0 + + + + + + + + SCILAB_sod_version ? + + SODファイルに保存する際に使用された SOD規約のバージョンを記述します. + + + + 例えば, Scilab 5.4.0の場合, このデータは以下となります: + + + + SCILAB_sod_version = 2 + + + + + + + + + + データがデータセット内で直線的に保存される型 + + + + + + + + + + + + Scilab 型 + + + + + + HDF5 Scilab 型属性 + + + + + + HDF5 属性 + + + + + + HDF データ型マッピング + + + + + + + + + + string + + + + + + SCILAB_Class = string + + + + + + + + + + + + String + + + + + + + + + + boolean + + + + + + SCILAB_Class = boolean + + + + + + + + + + + + 32ビット 整数 + + + + + + + + + + integer + + + + + + SCILAB_Class = integer + + + + + + SCILAB_precision = {8, 16, 32, u8, u16, u32} + + + + + + 8 = 8ビット文字 + + 16 = 16ビット整数 + + 32 = 32ビット整数 + + u8 = 8ビット符号無し文字 + + u16 = 16ビット符号無し整数 + + u32 = 32ビット符号無し整数 + + + + + + + + + + + + これらの型について, Scilabにおける場合と同様に, + + データは1次元配列に保存されます.データは列方向に保存されます. + + + + + + 行列, ベクトルまたはスカラーを再構築するために, + + 2つの属性が列と行の数を指定します. + + + + + + 5.4.0リリースおよび SOD v2以降, + + SCILAB_cols およびSCILAB_rows は + + double, 整数, 多項式および文字列の行列ではもはや使用されなくなりました. + + SOD はネーティブな多次元HDF5機能を使用します. + + + + + + + + + + + + 宣言の保存: int32([1 -4 7;-9 6 -3]) は,hdfviewで以下のように表示されます: + + + + + + + + + + + + + + metadataは以下のようになります: + + + + int32matrix (800, 2) + + 32-bit integer, 3 x 2 => the size of the variable + + Number of attributes = 2 + + SCILAB_Class = integer + + SCILAB_precision = 32 + + + + + + + + スカラー値は1行1列の行列に保存されます. + + + + + + + + 空の変数 ([]) はtrueに設定された属性SCILAB_emptyを有します. + + + + + + データが専用のグループに保存される型 + + + + + + Scilabデータ型の多くはグループで保存されます. + + これにより,値の分離を明確にでき,アクセスも容易になります. + + + + + + グループは"#"で括られた変数から命名されます.例えば, + + matrixofdoubleと呼ばれるdoubleの行列の場合, + + ルートデータセットの名前は matrixofdoubleとなり, + + 関連するグループの名前は + + #matrixofdouble#となります. + + + + + + 再帰的なデータ型(list, mlist, tlist, etc)の場合, + + サブグループの名前が以下のように構築されます: + + + + + この # によりユニークなIDを作成できるようになります. + + 最初の#の数は深さのレベルを示します. + + 例えば, サブリスト ###listnested#_#2##_#1##は, + + 2番目のレベ得るに位置することを示します. + + + + + + アンダースコア "_" は深さを表す手段です. + + 通常, "/" 文字がこのような場合に使用されますが, + + HDF5規約では予約済みキーワードとなっています. + + + + + + 名前で使用される整数は, + + カレントの構造における位置と親要素に関する位置の両方の意味で + + データ構造における位置を表します. + + 例えば, + + ###listnested#_#2##_#1##, + + は,親要素の3番目の構造の2番目の要素として扱われることを示します + + (要素は0から番号付けられます). + + + + + + 例えば, ###listnested#_#2##_#1##という名前のグループは, + + 以下の例では値 [32, 42] を指します: + + + + + + listnested=list(2,%i,'f',ones(3,3)) + + listnested(3) = list( %t, [32,42]); + + + + + + 疎行列 + + + + + + Scilab 型: sparse + + + + + + HDF5 Scilab 型属性: SCILAB_Class = sparse + + + + + + HDF5 属性: + + + + SCILAB_rows = <int> + + 行数 + + + + SCILAB_cols = <int> + + + + 列数 + + + + SCILAB_items = <int> + + + + 疎行列における要素数を定義 + + + + ルートデータセットの値: + + + + + + 最初の値 (#0#): + + このデータ構造の各要素は各行の非ヌル要素の数を示します. + + つまり, 最初の要素は疎行列の最初の行の要素数を示します. + + + + + + 2番目の値 (#1#): + + 疎行列の各要素の列の位置を示します. + + + + + + 3番目の値 (#2#): + + 疎行列における要素の実際の値へのリファレンスを保存します + + (この値は専用のグループに保存されます). + + + + 例えば, この行列を考えると: + + + + 0. 1. 0. 0. 0. 0. 0. 0. 0. 0. + + 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. + + 0. 0. 0. 0. 0. 0. 0. 0. 0. 3. + + 0. 0. 0. 0. 2. 0. 0. 0. 0. 0. + + + + これは以下の関数で生成されます: + + + + sparse([1,2;4,5;3,10],[1,2,3]) + + + + + + これは以下となります: + + + + + + #0# は,1;0;1;1を有します + + + + + + #1# は,2;10;5を有します + + + + + + #2# は,1.0; 3.0; 2.0を有する + + double(この例では複素数ではありません)の行列を参照します + + + + + + 論理値疎行列 + + + + + + Scilab型: boolean sparse + + + + + + HDF5 Scilab 型属性: SCILAB_Class = boolean sparse + + + + + + HDF5属性: + + + + + + SCILAB_rows = <int> + + + + 行数 + + + + SCILAB_cols = <int> + + + + 列数 + + + + SCILAB_items = <int> + + + + 疎行列の要素数を定義 + + + + ルートデータセットの値: 疎行列は3つのデータセットを有しますが, + + 論理値疎行列は2つのみです.これは定義される値は自動的にtrueとみなされるためです. + + + + + + 最初の値 (#0#): このデータ構造の各要素は各行の非ゼロ要素の数を示します. + + + + + + つまり, 最初の要素は疎行列の最初の行の要素数を示します. + + + + + + 2番目の値 (#1#): + + 疎行列の各要素の列の位置を示します. + + + + 以下の論理値疎行列について: + + + + dense=[%F, %F, %T, %F, %F + + %T, %F, %F, %F, %F + + %F, %F, %F, %F, %F + + %F, %F, %F, %F, %T]; + + + + + + #0#1;1;0;1を有します. + + + + + + #1#3;1;5を有します. + + + + + + 論理値疎行列を再生するために必要な情報は2つのみです. + + + + HDFデータ型マッピング: + + 32ビット整数 + + + + Double + + + + + + Scilab 型: double + + + + + + HDF5 Scilab 型属性: SCILAB_Class = double + + + + + + ルートデータセットの値: + + 実数および複素数の値は共に#<variable name>#と + + 呼ばれるグループに保存されます. + + + + + + 最初の値: 実数値へのリファレンス. 名前は#0#. + + + + + + 行列が複素数の場合, 2番目の値は複素数の値へのリファレンスとなります. 名前は#1#. + + + + + + HDF データ型マッピング: 64-bit floating-point + + + + + + 多項式 + + + + + + Scilab 型: polynomial + + + + + + HDF5 Scilab 型属性: SCILAB_Class = polynomial + + + + + + HDF5 属性: + + + + SCILAB_Class = polynomial + + SCILAB_varname = <string> + + シンボル変数の名前 + + + + SCILAB_Complex = <boolean> + + + + 多項式が複素数の場合 (そうでない場合は設定されません) + + + + ルートデータセットの値: + + + + + + 係数はdoubleの行列の形式で(double記憶領域の関連部分に)保存されます. + + 係数は,複素数にできるため,複素数の行列に保存されることに注意してください. + + (サブ)グループとデータセットの命名規則は + + 本章の先頭に記述されています. + + + + + + HDF データ型マッピング: Object reference + + + + + + list + + + + + + Scilab 型: list + + + + + + HDF5 Scilab 型属性: + + + + SCILAB_Class = list + + + + HDF5 属性: SCILAB_items = <リストの要素数> + + + + + + ルートデータセットの値: + + + + + + ルートデータセットに関連して,このデータセットで保存される値は + + リストに保存された値へのリファレンスです. + + 値は#<variable name>#と呼ばれるグループに保存されます. + + この #<variable name># グループにおいて, + + データは任意の型とすることができます. + + これらはグループに直線的に保存されます. + + その表現は他の場合と同様で,再帰的な構造にもとづきます + + (種々の型のリストのリストのリストが保存および読込みできることを意味します). + + + + + + (サブ)グループとデータセットの命名規則は本章の先頭に記述されています. + + + + + + HDF データ型マッピング: Object reference + + + + + + tlist + + + + + + Scilab型: tlist + + + + + + HDF5 Scilab 型属性: + + + + SCILAB_Class = tlist + + + + HDF5 属性: cf list + + + + + + mlist + + + + + + Scilab type: mlist + + + + + + HDF5 Scilab 型属性: + + + + SCILAB_Class = mlist + + + + HDF5 attributes: cf list + + + + + + void + + + + + + Scilab型: void + + + + + + HDF5 Scilab 型属性: + + + + SCILAB_Class = void + + + + void値はlist, tlistおよびmlistの非常に特殊な使用法でのみ + + 現れます. + + 以下の構文で作成することができます: + + + + voidelement_ref=list(1,,3); + + + + undefined + + + + + + Scilab 型: undefined + + + + + + HDF5 Scilab 型属性: + + + + SCILAB_Class = undefined + + + + undefined 値はリストの大きさが増加し, いくつかの要素が未定義となった + + 場合に生成されます. + + これらは以下の構文で生成されます: + + + + + + undefinedelement_ref=list(2,%i,'f',ones(3,3)); + + undefinedelement_ref(6)="toto" + + + + + + + + 実際の例 + + + + これらの変数全てについてサンプルファイルがScilabディストリビューションで + + 提供されています. + + これらは,以下のディレクトリで入手可能です: + + SCI/modules/hdf5/tests/sample_scilab_data/ + + + + + + 本文書の編集時点で, + + 以下のファイルがScilabディストリビューションで提供されています: + + + + + + + + booleanmatrix.sod + + + + booleanscalar.sod + + + + booleansparse.sod + + + + emptymatrix.sod + + + + emptysparse.sod + + + + hypermatrixcomplex.sod + + + + hypermatrix.sod + + + + int16.sod + + + + int32.sod + + + + int8.sod + + + + listnested.sod + + + + list.sod + + + + matricedoublecomplexscalar.sod + + + + matricedoublecomplex.sod + + + + matricedoublescalar.sod + + + + matricedouble.sod + + + + matricestringscalar.sod + + + + matricestring.sod + + + + mlist.sod + + + + polynomialscoef.sod + + + + polynomials.sod + + + + sparsematrix.sod + + + + tlist.sod + + + + uint16.sod + + + + uint32.sod + + + + uint8.sod + + + + undefinedelement.sod + + + + voidelement.sod + + + + + + + + + + フォーマットの進化 + + + + + + + + + + SOD バージョン + + + + + + Scilab バージョン + + + + + + 説明 + + + + + + + + + + 0 + + + + + + 5.2.0 + + + + + + Scilab/HDF5 形式の最初のバージョン + + + + + + + + + + 1 + + + + + + 5.4.0 alpha / beta + + + + + + 読込み/保存のデフォルト形式 + + 前の形式 (.bin) はまだサポートされます + + + + + + + + + + 2 + + + + + + 5.4.0 + + + + + + + + double, 整数, 多項式および文字列について, + + 多次元 HDF5 を使用するため, + + SCILAB_cols / SCILAB_rows + + が削除されました. + + + + + + + + + + + + + + + + + + 6.0.0 (将来) + + + + + + .bin サポートを廃止. + + + + + + + + + + + + + + 参照 + + + + + + save + + + + + + load + + + + + + listvarinfile + + + + + + type + + + + + + typeof + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/scanf.xml b/modules/fileio/help/ja_JP/scanf.xml new file mode 100755 index 000000000..7bbed5c21 --- /dev/null +++ b/modules/fileio/help/ja_JP/scanf.xml @@ -0,0 +1,156 @@ + + + + + + + + + scanf + + 標準入力を整形された入力に変換する + + + + + + 呼び出し手順 + + [v_1, ..., v_n] = scanf(format); + + + + + + 引数 + + + + + + format + + + + 文字列: フォーマット変換を指定します. + + + + + + + + v_1, ..., v_n + + + + 変換された結果. + + + + + + + + + + + + 説明 + + + + scanf関数は標準入力(%io(1))から文字データを取得し, + + これをformatに基づき解釈し,変換した結果 + + v_1, ..., v_nを返します. + + + + + + formatパラメータには入力を解釈する際に使用される変換指定子が含まれます. + + + + + + formatパラメータには空白文字(空白,タブ,改行,またはフォームフィード)を + + 含めることができ,以下の2つの場合を除き, + + 入力を次の非空白文字まで読み込みます.制御文字に一致しない限り, + + (改行文字を含む)後続の空白文字は読み込まれません. + + + + + + + + + %(パーセント記号)以外の任意の文字は, + + 入力ストリームの次の文字に一致する必要があります. + + + + + + + + 次の入力フィールドの変換を指示する変換指定子. + + 詳細は scanf_conversion 参照. + + + + + + + + + + + + 参照 + + + + + + read + + + + + + mfscanf + + + + + + scanf_conversion + + + + + + + + + diff --git a/modules/fileio/help/ja_JP/scanf_conversion.xml b/modules/fileio/help/ja_JP/scanf_conversion.xml new file mode 100755 index 000000000..f0c238900 --- /dev/null +++ b/modules/fileio/help/ja_JP/scanf_conversion.xml @@ -0,0 +1,335 @@ + + + + + + + + + scanf_conversion + + mscanf, msscanf, mfscanf 変換指定子 + + + + + + 説明 + + + + formatパラメータの各変換指定子には以下の要素が含まれます: + + + + + + + + + + %文字 (パーセント記号); + + + + + + + + + + オプションの代入抑制文字 * (アスタリスク); + + + + + + + + + + オプションの数値最大フィールド幅; + + + + + + + + + + 変換コード. + + + + + + + + + + 変換指定子は以下のような構文となります: + + + + + + [*][width][size]convcode. + + + + + + 変換の結果は,代入禁止を*(アスタリスク)で指定しない限り, + + v_i引数に代入されます. + + 代入禁止により入力フィールドをスキップできるようになります. + + 入力フィールドは非空白文字の文字列です. + + 次の不適切な文字まで,またはフィールド幅が指定された場合には + + これがあふれた場合に拡張されます. + + + + + + 変換コードは入力フィールドの解釈の方法を指定します. + + 代入禁止されたフィールドのv_iパラメータを指定する + + 必要はありません. + + 以下の変換コードを使用することが可能です: + + + + + + + + % + + + + + + ここまでは1個の% (パーセント記号)入力; 代入は行われません. + + + + + + + + + + d, i + + + + 10進整数を取得します. + + + + + + + + u + + + + 符号なしの10進整数を取得します. + + + + + + + + o + + + + 8進整数を取得します. + + + + + + + + x + + + + 16進整数を取得します. + + + + + + + + e, f, g + + + + + + 浮動小数点数を取得します. + + 次のフィールドは同時に変換され, + + 対応するパラメータは保存されます.これは, + + float へのポインタである必要があります. + + 浮動小数点数の入力形式は数値の文字列で,以下のオプションの文字を + + 指定できます: + + + + + + + + + + 以下の符号付きの値とすることができます; + + + + + + + + + + 小数点の後に指数フィールドを指定することで, + + 指数の値とすることができます,. + + 指数フィールドは,E または e + + の後に(オプションで符号付きの)整数を続けます; + + + + + + + + + + 特殊な値 + + %inf, %nanのどちらかと + + することができます; + + + + + + + + + + + + + + s + + + + 文字列を取得します. + + + + + + + + c + + + + + + 文字の値を取得します. 空白文字をまたがるスキップ処理は禁止されます. + + + + + + + + + + %lg + + + + doubleとして値を取得. + + + + + + + + + + + + 参照 + + + + + + msscanf + + + + + + mfscanf + + + + + + mscanf + + + + + + printf_conversion + + + + + + + + + diff --git a/modules/fileio/help/pt_BR/addchapter.sce b/modules/fileio/help/pt_BR/addchapter.sce new file mode 100755 index 000000000..c872c3bde --- /dev/null +++ b/modules/fileio/help/pt_BR/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Arquivos : funções de Entrada/Saída",SCI+"/modules/fileio/help/pt_BR",%T); + diff --git a/modules/fileio/help/pt_BR/directory/CHAPTER b/modules/fileio/help/pt_BR/directory/CHAPTER new file mode 100755 index 000000000..8f46dc5e9 --- /dev/null +++ b/modules/fileio/help/pt_BR/directory/CHAPTER @@ -0,0 +1,2 @@ +title= Directory + diff --git a/modules/fileio/help/pt_BR/directory/chdir.xml b/modules/fileio/help/pt_BR/directory/chdir.xml new file mode 100755 index 000000000..1b5f20bf8 --- /dev/null +++ b/modules/fileio/help/pt_BR/directory/chdir.xml @@ -0,0 +1,69 @@ + + + + chdir + muda o diretório corrente do Scilab + + + cd + muda o diretório corrente do Scilab + + + Seqüência de Chamamento + b=chdir(path) + realpath=cd(path) + cd path + + + + Parâmetros + + + b + + um booleano %t se a operação chdir estiver ok. + + + + path + + um string + + + + realpath + + um string, o nome real do endereço após a conversão do nome do + endereço (ver abaixo) + + + + + + + Descrição + Muda o diretório corrente do Scilab para aquele dado por + path. Note que a conversão de endereço é realizada e. + por exemplo SCI/modules/core/macros é um padrão válido + tanto pra Unix quanto para Windows. Se path for vazio, muda para diretório + "home". + + + + Exemplos + + + + Ver Também + + + pwd + + + + diff --git a/modules/fileio/help/pt_BR/fileinfo.xml b/modules/fileio/help/pt_BR/fileinfo.xml new file mode 100755 index 000000000..1aa8d1125 --- /dev/null +++ b/modules/fileio/help/pt_BR/fileinfo.xml @@ -0,0 +1,206 @@ + + + + + fileinfo + Fornece informações sobre um arquivo + + + Seqüência de Chamamento + [x,ierr]=fileinfo(file) + + + Parâmetros + + + file + + string, o endereço do arquivo + + + + x + + um vetor de inteiros de tamanho 13 contendo + informações ou uma matriz vazia se o arquivo não + existir. + + + + + ierr + + indicador de erro, 0, se não for encontrado nenhum + erro. + + + + + + + Descrição + x=fileinfo(file) retorna + + + x(1) + + O tamanho do arquivo + + + + x(2) + + O modo do arquivo (valor decimal) + + + + x(3) + + O id do usuário + + + + x(4) + + O id do grupo + + + + x(5) + + O número do dispositivo + + + + x(6) + + A data da última modificação + + + + x(7) + + A data da última mudança + + + + x(8) + + A data do último acesso + + + + x(9) + + O tipo de dispositivo (se o dispositivo for inode) + + + + x(10) + + O tamanho de bloco para a entrada/saída do sismtema de + arquivos (sempre 0 no Windows) + + + + + x(11) + + O número de blocos alocados (sempre 0 no Windows) + + + + x(12) + + O inode + + + + x(13) + + O número de hard links. + + + + + + Referência + Esta função é uma interface para a função C + stat. + + Permissões são tipicamente especificadas como números + octais : dec2oct(x(2)) para conversão. + + O modo numérico possui de um a quatro dígitos octais + (0-7), derivados através da soma de bits com os valores 4, 2, e 1. + Quaisquer dígitos omitidos são supostos como zeros à + esquerda. O primeiro dígito seleciona o ID de usuário (4) e + ajusta o ID do grupo (2) e atributos "sticky" (1). O segundo dígito + seleciona permissões para o usuário que possui o arquivo: + leitura (4), escrita (2), e execução (1); o terceiro dígito + seleciona permissões para os outros usuários no grupo do + arquivo, com os mesmos valores; e o quarto seleciona permissões para + outros usuários que não estão no grupo do arquivo, com os + mesmos valores. + + + + Exemplos + 0) then + disp('PERIMISSÃO DE ESCRITA neste arquivo.'); +else + disp('NÃO HÁ PERIMISSÃO DE ESCRITA neste arquivo.'); +end + ]]> + + + Ver Também + + + getdate + + + file + + + dispfiles + + + newest + + + isdir + + + + + Autores + S. Steer INRIA + A.C + + diff --git a/modules/fileio/help/pt_BR/getmd5.xml b/modules/fileio/help/pt_BR/getmd5.xml new file mode 100755 index 000000000..50553c867 --- /dev/null +++ b/modules/fileio/help/pt_BR/getmd5.xml @@ -0,0 +1,54 @@ + + + + getmd5 + retorna soma de verificao md5 + + + Seqncia de Chamamento + res=getmd5(filename) + res=getmd5(ParamString,'string') + + + + Parmetros + + + res + + resultado md5 (string) + + + + filename + + nome do arquivo (string ou matrizes de strings) + + + + ParamString + + string ou matrizes de strings + + + + + + Descrio + + getmd5(...) retorna a soma de verificao md5 de + um arquivo ou um string. + + + + Exemplos + + + diff --git a/modules/fileio/help/pt_BR/newest.xml b/modules/fileio/help/pt_BR/newest.xml new file mode 100755 index 000000000..f61be24fe --- /dev/null +++ b/modules/fileio/help/pt_BR/newest.xml @@ -0,0 +1,73 @@ + + + + + newest + retorna o arquivo mais novo de um conjunto de + arquivos + + + + Seqncia de Chamamento + k=newest(paths) + k=newest(path1,path2,...,pathn) + + + + Parmetros + + + k + + o ndice do arquivo mais novo + + + + paths + + vetor de strings, paths(i) o endereo do i-simo + arquivo + + + + + pathi + + string, o endereo do i-simo arquivo + + + + + + Descrio + Dado um conjunto de endereos, newest retorna o ndice do mais novo. + Arquivos no existentes so supostos como mais antigos. + + + + Exemplos + + + + Ver Tambm + + + fileinfo + + + + diff --git a/modules/fileio/help/pt_BR/path_filename/CHAPTER b/modules/fileio/help/pt_BR/path_filename/CHAPTER new file mode 100755 index 000000000..7475b052d --- /dev/null +++ b/modules/fileio/help/pt_BR/path_filename/CHAPTER @@ -0,0 +1,2 @@ +title = Paths - Filenames + diff --git a/modules/fileio/help/pt_BR/path_filename/get_absolute_file_path.xml b/modules/fileio/help/pt_BR/path_filename/get_absolute_file_path.xml new file mode 100755 index 000000000..a9efb583c --- /dev/null +++ b/modules/fileio/help/pt_BR/path_filename/get_absolute_file_path.xml @@ -0,0 +1,85 @@ + + + + + get_absolute_file_path + fornece o nome de endereço absoluto de um arquivo aberto no + Scilab + + + + Seqüência de Chamamento + pathname = get_absolute_file_path(filename) + + + Parâmetros + + + filename + + string : nome do arquivo + + + + pathname + + string : o nome de endereço absoluto + + + + + + Descrição + Fornece o nome de endereço absoluto de um arquivo já aberto no + Scilab. + + get_absolute_file_path procura na lista interna de arquivos abertos + correntemente do Scilab, filename e retorna seu endereço. + + Se o arquivo não for aberto, um erro é retornado. + Aviso : na versão anterior (Scilab 5.0.x) o diretório corrente era + retornado se o arquivo não fosse encontrado. + + Esta função pode ser utilizada para encontrar de onde (endereço) um + script Scilab é executado. + + + + Exemplos + + + + Ver Também + + + getshortpathname + + + getlongpathname + + + pwd + + + + + Autores + Allan CORNET + + diff --git a/modules/fileio/help/pt_BR/path_filename/getrelativefilename.xml b/modules/fileio/help/pt_BR/path_filename/getrelativefilename.xml new file mode 100755 index 000000000..d52da7fc5 --- /dev/null +++ b/modules/fileio/help/pt_BR/path_filename/getrelativefilename.xml @@ -0,0 +1,88 @@ + + + + + getrelativefilename + dado um nome de diretrio absoluto e um nome de arquivo + relativo, retorna um nome de arquivo relativo. + + + + Seqncia de Chamamento + rel_file = getrelativefilename(abs_dir,abs_file) + + + Parmetros + + + abs_dir + + string : o diretrio absoluto + + + + abs_file + + string : o nome de arquivo absoluto + + + + rel_file + + string : o nome de arquivo relativo + + + + + + Descrio + dado um nome de diretrio absoluto e um nome de arquivo relativo, + retorna um nome de arquivo relativo. + + Por exemplo, se o diretrio corrente C:\scilab\bin e o nome de + arquivo C:\scilab\modules\helptools\readme.txt dado, getrelativefilename + retornar ..\modules\helptools\readme.txt. + + + + Exemplos + + + + Ver Tambm + + + getshortpathname + + + getlongpathname + + + pwd + + + + diff --git a/modules/fileio/help/ru_RU/addchapter.sce b/modules/fileio/help/ru_RU/addchapter.sce new file mode 100755 index 000000000..cada2dff5 --- /dev/null +++ b/modules/fileio/help/ru_RU/addchapter.sce @@ -0,0 +1,11 @@ +// Scilab ( http://www.scilab.org/ ) - This file is part of Scilab +// Copyright (C) 2009 - DIGITEO +// +// This file must be used under the terms of the CeCILL. +// This source file is licensed as described in the file COPYING, which +// you should have received as part of this distribution. The terms +// are also available at +// http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt + +add_help_chapter("Файлы: функции ввода/вывода",SCI+"/modules/fileio/help/ru_RU",%T); + diff --git a/modules/fileio/help/ru_RU/copyfile.xml b/modules/fileio/help/ru_RU/copyfile.xml new file mode 100755 index 000000000..3f21444be --- /dev/null +++ b/modules/fileio/help/ru_RU/copyfile.xml @@ -0,0 +1,95 @@ + + + + + $LastChangedDate$ + + + + copyfile + копирование файла + + + Последовательность вызова + + copyfile(source, destination) + [status, message] = copyfile(source, destination) + + + + Аргументы + + + source + + + символьная строка: имя файла или директории (источник). + + + + + destination + + + символьная строка: имя директории (назначение). + + + + + + + Описание + + copyfile(source, destination) копирует файл или + директорию source в файл или директорию + destination (и поддиректории). + + + Если источник является директорией, то назначение не может быть файлом. + + copyfile замещает существующие файлы без предупреждения. + + + + [status, message] = copyfile(source,destination) + копирует из источника source в назначение destination, + возвращая статус status и сообщение message. + + + Для любой операционной системы, если копирование завершилось успешно, то + статус status равен 1, а сообщение message пустое; если же копирование завершилось неудачно, то статус status равен 0 и сообщение message не пустое. + + + Временная отметка у файла назначения такая же, как временная отметка исходного файла. + + + + Примеры + + copyfile(SCI+"/etc/scilab.start",TMPDIR+"/scilab.start") + [status,message] = copyfile(SCI+"/etc/scilab.start",TMPDIR); + + + + Смотрите также + + + movefile + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/deletefile.xml b/modules/fileio/help/ru_RU/deletefile.xml new file mode 100755 index 000000000..210d65ce4 --- /dev/null +++ b/modules/fileio/help/ru_RU/deletefile.xml @@ -0,0 +1,62 @@ + + + + + deletefile + удаляет файл + + + Последовательность вызова + f = deletefile(filename) + + + Аргументы + + + filename + + строка, имя файла (существующего или нет) + + + + f + + + логическое значение: %t или %f + + + + + + + Описание + + Эта функция удаляет файл filename. Если файл filename удалён, то она возвращает + %t, а иначе %f. + + + + Примеры + []) then +deletefile(TMPDIR+'/filetodelete.txt') +end + +deletefile(TMPDIR+'/notexistingfile') + ]]> + + + diff --git a/modules/fileio/help/ru_RU/directory/CHAPTER b/modules/fileio/help/ru_RU/directory/CHAPTER new file mode 100755 index 000000000..cdae3cb74 --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/CHAPTER @@ -0,0 +1,2 @@ +title= Директория + diff --git a/modules/fileio/help/ru_RU/directory/chdir.xml b/modules/fileio/help/ru_RU/directory/chdir.xml new file mode 100755 index 000000000..abdfe1d86 --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/chdir.xml @@ -0,0 +1,98 @@ + + + + + $LastChangedDate$ + + + chdir + меняет текущую директорию Scilab'а + + + cd + меняет текущую директорию Scilab'а + + + Последовательность вызова + b=chdir(path) + realpath=cd(path) + cd path + + + + Аргументы + + + b + + + логическое значение: %t, если работа chdir завершилась успешно + + + + + path + + символьная строка: путь + + + + realpath + + + символьная строка: настоящее название пути после преобразования + имени пути (см. ниже) + + + + + + + Описание + + Изменение текущей директории Scilab'а на ту, которая указана в + path. Обратите внимание, что выполняется преобразование + пути и, например, SCI/modules/core/macros является + корректным как для Unix, так и для Windows. Если путь path не указан (пуст), + то производится смена на "домашнюю" директорию. + + + + Примеры + + + + Смотрите также + + + pwd + + + SCI + + + SCIHOME + + + TMPDIR + + + + + diff --git a/modules/fileio/help/ru_RU/directory/createdir.xml b/modules/fileio/help/ru_RU/directory/createdir.xml new file mode 100755 index 000000000..f80801a56 --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/createdir.xml @@ -0,0 +1,80 @@ + + + + + $LastChangedDate$ + + + createdir + создаёт новую директорию + + + Последовательность вызова + + createdir(dirname) + status = createdir(dirname) + + + + Аргументы + + + dirname + + символьная строка: имя директории. + + + + status + + логическое значение: статус. + + + + + + Описание + + createdir(dirname) создаёт директорию + dirname в текущей директории. Если + dirname находится не в текущей директории, то + определите относительный путь к текущей директории, либо + полный путь для dirname. + + + [status] = createdir(dirname) создаёт директорию dirname в существующей директории, возвращая статус status. Здесь status равен %T в случае успеха, иначе %F. + + + createdir используется mkdir. + + + + Примеры + + + + Смотрите также + + + mkdir + + + rmdir + + + + + diff --git a/modules/fileio/help/ru_RU/directory/dir.xml b/modules/fileio/help/ru_RU/directory/dir.xml new file mode 100755 index 000000000..0e6791b97 --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/dir.xml @@ -0,0 +1,122 @@ + + + + + dir + получает список файлов + + + Последовательность вызова + dir path + S=dir([path]) + + + + Аргументы + + + path + + + строковая матрица, указывающая путь до директории (обычно + заканчивающаяся маской *). Значение по + умолчанию . (точка). + + + + + S + + + типизированный список tlist типа + dir с полями: + name, date, bytes и isdir. + + + + + + + Описание + + dir может использоваться для получения + файлов, которые соответствуют шаблонам, указанным аргументом + path. Шаблоны указываются для команды Unix + ls либо для команды Windows + dir для того, чтобы получить информацию о + файлах. Таким образом, чтобы написать переносимый Scilab-сценарий, + требуется указать шаблоны для обеих ОС. Заметьте, что + выполняется преобразование имени пути, например, + SCI/modules/core/macros/*.sci является + корректным шаблоном как для Unix, так и для Windows. + + + Поле name возвращаемой переменной является + вектор-столбцом имён файлов. + + + Поле date возвращаемой переменной является вектор-столбцом + целых чисел, содержащих дату последней модификации, кодированную + в секундах от 1 Янв 1970. + + + Поле bytes возвращаемой переменной является вектор-столбцом + целых чисел, содержащих размер файлов в байтах. + + + Поле isdir возвращаемой переменной является вектор-столбцом + логического значения ИСТИНА, если соответствующее имя расположено в директории. + + + Возвращаемая структура по умолчанию отображается в виде списка файлов, + форматированного в виде столбца. Это можно изменить, + переопределив функцию %dir_p. + + + Начиная с Scilab 5.3.1, завершение "/" или "\" (см. filesep) отображается для каждой директории. + + + + Примеры + + + + Смотрите также + + + listfiles + + + findfiles + + + ls + + + fileinfo + + + date + + + + + diff --git a/modules/fileio/help/ru_RU/directory/isdir.xml b/modules/fileio/help/ru_RU/directory/isdir.xml new file mode 100755 index 000000000..6dfdbceef --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/isdir.xml @@ -0,0 +1,75 @@ + + + + + isdir + проверяет является ли аргумент путём до директории + + + Последовательность вызова + r=isdir(path) + + + Аргументы + + + path + + символьная строка или матрица строк: имя пути до директории + + + + r + + + логическое значение: %t, если path является путём до директории. + + + + + + + Описание + + r = isdir(path) проверяет является ли путь path путём до директории. + + + + Сcылка + + Эта функция основана на C-функции stat. Можно + использовать краткие обозначения SCI и + ~ для директории Scilab'а и домашней директории. + + + + Примеры + + + + Смотрите также + + + isfile + + + fileinfo + + + + + diff --git a/modules/fileio/help/ru_RU/directory/ls.xml b/modules/fileio/help/ru_RU/directory/ls.xml new file mode 100755 index 000000000..03f8de61e --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/ls.xml @@ -0,0 +1,103 @@ + + + + + ls + показывает файлы + + + Последовательность вызова + + files = ls [path] + files = ls( [path] ) + + + + Аргументы + + + path + + + матрица строк, указывающая путь к директории (обычно + заканчивающаяся шаблоном, содержащим *). Значение по умолчанию . (точка). + + + + + files + + + вектор-столбец строковых значений. По умолчанию он содержит вывод, отформатированный в столбец. + + + + + + + Описание + + Функция ls может быть использована для + составления списка файлов, которые соответствуют шаблонам, + заданным аргументом path. Шаблоны указываются + Unix-команде ls или Windows-команде + dir для получения информации о файлах. Таким + образом, чтобы написать переносимый Scilab-сценарий, необходимо + указать допустимые символы замещения в шаблонах для обоих ОС. + Заметьте, что выполняется преобразование имени пути, и, например, + SCI/modules/core/macros/*.sci является + допустимым шаблоном как для Unix, так и для Windows. + + + Если вы хотите получить вектор всех файлов, соответствующих + шаблону, то лучше использовать функцию listfiles + или функцию dir. + + + + Пожалуйста, заметьте, что, начиная с версии 5.0 Scilab'а, + второй входной аргумент удалён (последовательность строк, + которую можно добавить в Unix-системах: опции Unix-команды + ls). Эта опция была удалена, главным + образом, по причинам безопасности и переносимости. + + + + + Примеры + + + + Смотрите также + + + listfiles + + + findfiles + + + dir + + + fileinfo + + + + + diff --git a/modules/fileio/help/ru_RU/directory/mkdir.xml b/modules/fileio/help/ru_RU/directory/mkdir.xml new file mode 100755 index 000000000..54c76ce0e --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/mkdir.xml @@ -0,0 +1,176 @@ + + + + + mkdir + создаёт новую директорию + + + Последовательность вызова + + mkdir(dirname) + mkdir(parentdir, dirname) + status = mkdir( ... ) + [status, msg] = mkdir( ... ) + + + + Аргументы + + + dirname + + + символьная строка: имя директории, которую требуется создать. + + + + + parentdir + + + символьная строка: имя директории в которой будет создана новая + директория dirname. + + + + + status + + + целое число: статус работы. + + + + + msg + + + символьная строка: сообщение об ошибке. + + + + + + + Описание + + Инструкция mkdir(dirname) создаёт директорию + dirname в текущей директории, если + dirname представляет относительный путь. + Иначе, dirname представляет абсолютный путь и + функция mkdir пытается создать директорию с + абсолютным именем dirname. + + + Инструкция mkdir(parentdir, dirname) создаёт + директорию dirname в директории + parentdir (если parentdir + не существует, то она будет создана), где + parentdir -- абсолютное или относительное имя. + + + Инструкция [status,msg] = mkdir(parentdir, dirname) + создаёт директорию dirname в существующей + директории parentdir, возвращая статус работы + status и сообщение об ошибке + msg. + + + + + + status + + + msg + + + + + -2 + + + mkdir: Произошла ошибка: Файл с таким именем уже существует в dirname + + + + + + 0 + + + mkdir: Произошла ошибка: Невозможно создать каталог dirname + + + + + + 1 + + + + + + + + + 2 + + + mkdir: Произошла ошибка: Этот каталог уже существует в dirname + + + + + + + В любой операционной системе, если создание директории удалось, то статус status равен 1, а сообщение msg пустое. + + + + Примеры + + + + + + Смотрите также + + + chdir + + + dir + + + rmdir + + + + + diff --git a/modules/fileio/help/ru_RU/directory/pwd.xml b/modules/fileio/help/ru_RU/directory/pwd.xml new file mode 100755 index 000000000..25e3eaeea --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/pwd.xml @@ -0,0 +1,36 @@ + + + + pwd + получает текущую директорию Scilab'а + + + Последовательность вызова + pwd + x = pwd() + + + + Описание + + pwd возвращает в ans текущую директорию Scilab'а. + x = pwd() возвращает в x текущую директорию Scilab'а. + + + + Примеры + + + + Смотрите также + + + chdir + + + + + diff --git a/modules/fileio/help/ru_RU/directory/removedir.xml b/modules/fileio/help/ru_RU/directory/removedir.xml new file mode 100755 index 000000000..969b3700c --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/removedir.xml @@ -0,0 +1,86 @@ + + + + + removedir + удаляет директорию + + + Последовательность вызова + + removedir(dirname) + [status] = removedir(dirname) + + + + Аргументы + + + dirname + + символьная строка: имя директории, которую нужно удалить. + + + + status + + логическое значение: статус. + + + + + + Описание + + removedir(dirname) удаляет директорию + dirname из текущей директории. Если директория не + пуста, то файлы и поддиректории удаляются. Если + dirname не является текущей директорией, то укажите + относительный путь к текущей директории или абсолютный путь для + dirname. + + + [status] = removedir(dirname) удаляет директорию + dirname и всё её содержимое, возвращая статус + status. Здесь status равен + %T в случае успеха и %F в + случае ошибки. + + + Функция removedir используется в rmdir. + + + + Примеры + + + + Смотрите также + + + createdir + + + mkdir + + + rmdir + + + + + diff --git a/modules/fileio/help/ru_RU/directory/rmdir.xml b/modules/fileio/help/ru_RU/directory/rmdir.xml new file mode 100755 index 000000000..ae022f7be --- /dev/null +++ b/modules/fileio/help/ru_RU/directory/rmdir.xml @@ -0,0 +1,102 @@ + + + + + rmdir + удаляет директорию + + + Последовательность вызова + + rmdir(dirname) + rmdir(dirname,'s') + [status, message] = rmdir(dirname,'s') + + + + Аргументы + + + dirname + + символьная строка: имя директории. + + + + 's' + + + признак удаления директории dirname с поддиректориями. + + + + + status + + логическое значение: статус. + + + + message + + + символьная строка: сообщение об ошибке. + + + + + + + Описание + + rmdir(dirname) удаляет директорию + dirname из текущей директории. Если директория не + пуста, вы должны использовать аргумент 's'. Если + dirname нет в текущей директории, то укажите + относительный путь до текущей директории или полный путь для + dirname. + + + rmdir(dirname,'s') удаляет директорию dirname и всё её содержимое из текущей директории. + + + [status, message] = rmdir(dirname,'s') удаляет директорию dirname и всё её содержимое из текущей директории, возвращая статус status и сообщение message. Здесь status равен 1 в случае успеха и равен 0 в случае ошибки. + + + В любой операционной системе, если создание директории удалось, то статус status равен 1, а сообщение message пустое. + + + + Примеры + + + + Смотрите также + + + createdir + + + mkdir + + + removedir + + + + + diff --git a/modules/fileio/help/ru_RU/dispfiles.xml b/modules/fileio/help/ru_RU/dispfiles.xml new file mode 100755 index 000000000..e66b80162 --- /dev/null +++ b/modules/fileio/help/ru_RU/dispfiles.xml @@ -0,0 +1,62 @@ + + + + + dispfiles + выводит на экран свойства открытых файлов + + + Последовательность вызова + dispfiles([units]) + + + Аргументы + + + units + + + вектор целых чисел: номера логических блоков. По умолчанию + все открытые файлы. + + + + + + + Описание + + Функция dispfiles выводит на экран свойства файлов, + открытых на данный момент. + + + + Примеры + + + + Смотрите также + + + file + + + mopen + + + + + diff --git a/modules/fileio/help/ru_RU/fileinfo.xml b/modules/fileio/help/ru_RU/fileinfo.xml new file mode 100755 index 000000000..2a1cdd288 --- /dev/null +++ b/modules/fileio/help/ru_RU/fileinfo.xml @@ -0,0 +1,229 @@ + + + + + fileinfo + предоставляет информацию о файле + + + Последовательность вызова + [x,ierr] = fileinfo(files) + + + Аргументы + + + files + + + символьная строка или вектор-столбец строк, имя файла и + путь до него + + + + + x + + + вектор целых чисел размером 13 элементов, содержащий + информацию, либо пустую матрицу, если файла не существует. + + + Если files является вектор-столбцом + строк, то x будет матрицей размером + m x 13. + + + Если файла с указанным именем не существует, то в качестве + выходной информации будет возвращена строка из 13 элементов и в каждом элементе Nan. + + + + + ierr + + + указатель ошибки, 0, если ошибки не произошло. + + + + + + + Описание + + x = fileinfo(file) возвращает: + + + + x(1) + + Размер файла + + + + x(2) + + Режимный код файла (десятичное значение) + + + + x(3) + + Идентификатор пользователя + + + + x(4) + + Идентификатор группы + + + + x(5) + + Номер устройства + + + + x(6) + + Дата последнего изменения данных + + + + x(7) + + Дата последнего изменения статуса файла + + + + x(8) + + Дата последнего доступа + + + + x(9) + + Тип устройства (если инодное устройство) + + + + x(10) + + + Размер блока для ввода/вывода файловой системы (в Windows всегда 0) + + + + + x(11) + + Количество распределённых блоков (в Windows всегда 0) + + + + x(12) + + Индексный дескриптор + + + + x(13) + + Количество жёстких ссылок + + + + + + Ссылки + + Эта функция является интерфейсом к C-функции stat. + + + Права обычно определяются в виде восьмеричных чисел: используйте + для преобразования dec2oct(x(2)). + + + Числовой режим представляет собой от одной до четырёх восьмеричных цифр + (0-7), полученных добавлением битов со значениями 4, 2 и + 1. Любые опущенные цифры предполагаются предварёнными + нулями. Первая цифра выбирает набор атрибутов идентификатора пользователя + (4), группы пользователя (2) и sticky-бита (1). Вторая цифра + выбирает права пользователя, который владеет файлом: чтение (4), + запись (2) и исполнение (1); третье число выбирает права для + других пользователей в группе файлов с теми же самыми значениями. + + + So, to check permissions, it is necessary to use masks. Let us take an example: + In octal, x(2)=1664, so first digit corresponds to sticky attributes. The second + indicates that file owner has permission of writing and reading. It is the same + for other users in the file's group. Finally, others users has just right to read. + To apply a mask, it is simpler to look at this octal in binary. + So: x(2)= 1 110 110 100. + To check if the owner has write permission, we must take a look at the second triplet: 110 + and compare it with write permission 010. So, the operation is: 110 000 000 & 010 000 000. + If result is not null (it is the case here), owner has write permission. + + + + Примеры + 0) then + disp('Для этого файла есть ПРАВО НА ЗАПИСЬ.'); +else + disp('Для этого файла НЕТ ПРАВА НА ЗАПИСЬ.'); +end + +FILES = [SCI;SCIHOME;'несуществующий_файл';TMPDIR] +[X,ERRS] = fileinfo(FILES) + ]]> + + + Смотрите также + + + getdate + + + file + + + dispfiles + + + newest + + + isdir + + + + + diff --git a/modules/fileio/help/ru_RU/findfiles.xml b/modules/fileio/help/ru_RU/findfiles.xml new file mode 100755 index 000000000..55961cfac --- /dev/null +++ b/modules/fileio/help/ru_RU/findfiles.xml @@ -0,0 +1,78 @@ + + + + + findfiles + + поиск всех файлов с указанным уточнением файла + + + + Последовательность вызова + f = findfiles() + f = findfiles(path) + f = findfiles(path,filespec) + + + + Аргументы + + + path + + символьная строка, путь. + + + + filespec + + + символьная строка, уточнение файла, например, + "*.sce". + + + + + f + + вектор-столбец строк, имена файлов. + + + + + + Описание + + Поиск всех файлов с указанным уточнением файла + filespec. + + + + Примеры + + + + Смотрите также + + + listfiles + + + + + diff --git a/modules/fileio/help/ru_RU/fprintfMat.xml b/modules/fileio/help/ru_RU/fprintfMat.xml new file mode 100755 index 000000000..3f2e44dd9 --- /dev/null +++ b/modules/fileio/help/ru_RU/fprintfMat.xml @@ -0,0 +1,150 @@ + + + + + fprintfMat + записывает матрицу в файл + + + Последовательность вызова + fprintfMat(file, M [,format, text]) + + + Аргументы + + + file + + строка, путь к файлу, который нужно записать + + + + M + + матрица вещественных чисел + + + + format + + + символьная строка, задающая формат. Это необязательный + параметр, значение по умолчанию "%lf". + + + Поддерживаемый формат: + %[width].[precision]type или + %type, где: + + + width: необязательное число, которое + определяет минимальное количество символов на выходе; + + + precision: необязательное число, + которое определяет максимальное количество символов, + напечатанных для всего или части выходного поля, или + минимальное количество цифр, печатаемых для целых значений; + + + type: lf, lg, d, i, e, f, g (см. scanf_conversion). + + + + + text + + + вектор-строка или вектор-столбец строк, указывающий + нечисловые комментарии в начале файла. + + + + + + + Описание + + Функция fprintfMat записывает матрицу в + форматированном файле. Каждая строка матрицы даёт строчку в + файле. Если указан text, то его элементы + вносятся (поэлементно) в начало файла, один элемент на строку. + + + + Примеры + + + + Смотрите также + + + scanf_conversion + + + mclose + + + meof + + + mfprintf + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/fscanfMat.xml b/modules/fileio/help/ru_RU/fscanfMat.xml new file mode 100755 index 000000000..9284d5458 --- /dev/null +++ b/modules/fileio/help/ru_RU/fscanfMat.xml @@ -0,0 +1,188 @@ + + + + + fscanfMat + считывает матрицу из текстового файла + + + Последовательность вызова + M = fscanfMat(filename[, fmt]); + [M, text] = fscanfMat(filename [, fmt]); + + + + Аргументы + + + filename + + + символьная строка, указывающая имя файла, который + необходимо просканировать. + + + + + fmt + + + символьная строка, указывающая формат. Это необязательный + параметр. Значение по умолчанию "%lg". + + + Поддерживаемый формат: + %[width].[precision]type или + %type, где: + + + width: необязательное число, которое + определяет минимальное количество знаков на выходе; + + + precision: необязательное число, + которое определяет максимальное количество знаков, + выводимых для всех или части выходных полей, или + минимальное количество цифр, выводимых для целочисленных значений. + + + type: lf, lg, d, i, e, f, g (см. scanf_conversion). + + + + + M + + + выходная переменная. Матрица вещественных чисел. + + + + + text + + + выходная переменная. Вектор-столбец строк. Это комментарии + в начале файла с именем filename. + + + + + + + Описание + + Функция fscanfMat используется для считывания + вещественной матрицы из текстового файла с именем + filename. Первые нечисловые строчки файла + возвращаются в переменной text, если это + запрошено, а все оставшиеся строчки должны иметь одинаковое + количество столбцов (разделителем столбцов могут быть либо + пробелы либо символы табуляции, если же есть и те и другие, + то, по умолчанию, будут выбраны пробелы). Количество столбцов матрицы должно + соответствовать количеству столбцов, обнаруженных в файле + filename, а количество строк получается при + обнаружении конца файла (EOF) во входном файле. Эта функция + может быть использована для чтения числовых данных, сохранённых + с помощью функции fprintfMat (по умолчанию в + качестве разделителя используется пробел). + + + fscanfMat поддерживает файлы с кодировкой ANSI/ASCII и UTF-8. + + + Для чтения CSV-файлов, рекомендуется функция csvRead. + + + + Примеры + + fd = mopen(TMPDIR + "/Mat", "w"); + mfprintf(fd, "Какой-то текст.....\n"); + mfprintf(fd, "Ещё какой-то текст...\n"); + a = rand(6,6); + for i = 1:6 , + for j = 1:6, mfprintf(fd, "%5.2f ", a(i,j));end; + mfprintf(fd, "\n"); + end + mclose(fd); + a1 = fscanfMat(TMPDIR + "/Mat") + + A = ones(5,5) + 0.1; + fprintfMat(TMPDIR + "/Matrix.txt", A, "%lg"); + B = fscanfMat(TMPDIR + "/Matrix.txt", "%lg"); + A == B + + C = [%nan, %inf, -%inf, 1]; + fprintfMat(TMPDIR + "/MatrixNANINF.txt", C); + D = fscanfMat(TMPDIR + '/MatrixNANINF.txt') + + + + + Смотрите также + + + scanf_conversion + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + csvRead + + + + + diff --git a/modules/fileio/help/ru_RU/getmd5.xml b/modules/fileio/help/ru_RU/getmd5.xml new file mode 100755 index 000000000..94aba13b0 --- /dev/null +++ b/modules/fileio/help/ru_RU/getmd5.xml @@ -0,0 +1,66 @@ + + + + + getmd5 + получение контрольной суммы md5 + + + Последовательность вызова + + res=getmd5(filename) + res=getmd5(ParamString,'string') + + + + Аргументы + + + res + + результат, контрольная сумма md5 (строка) + + + + filename + + имя файла (строка или матрица строк) + + + + ParamString + + строка или матрица строк + + + + + + Описание + + Функция getmd5 получает контрольную сумму md5 файла filename или строки ParamString. + + + + Примеры + + + diff --git a/modules/fileio/help/ru_RU/io.xml b/modules/fileio/help/ru_RU/io.xml new file mode 100755 index 000000000..d4495205b --- /dev/null +++ b/modules/fileio/help/ru_RU/io.xml @@ -0,0 +1,67 @@ + + + + + %io + + переменная, которая хранит стандартный ввод и стандартный вывод + (дескриптор файла) + + + + Последовательность вызова + %io(1) + %io(2) + + + + Описание + + %io(1) возвращает стандартное устройство ввода (дескриптор файла 5). + + + %io(2) возвращает стандартное устройство вывода (дескриптор файла 6). + + + Дескриптор файла 0 является стандартным устройством вывода сообщений об ошибке. + + + + Примеры + + + + Смотрите также + + + write + + + mfprintf + + + file + + + dispfiles + + + + + diff --git a/modules/fileio/help/ru_RU/isfile.xml b/modules/fileio/help/ru_RU/isfile.xml new file mode 100755 index 000000000..ed46cb0e0 --- /dev/null +++ b/modules/fileio/help/ru_RU/isfile.xml @@ -0,0 +1,74 @@ + + + + + isfile + + проверяет является ли аргумент существующим файлом + + + + Последовательность вызова + x = isfile(filenames) + + + Аргументы + + + filenames + + символьная строка или матрица строк: имена файлов. + + + + x + + + матрица логических значений (%t, если имена в filenames являются именами существующих файлов). + + + + + + + Описание + + x = isfile(filenames) проверяет являются ли имена в + filenames именами существующих файлов или нет + (директория не является файлом). См. также isdir. + + + + Примеры + + filenames = ls(SCI) + + x = isfile(filenames) + + isfile(SCI + '/etc') + isdir(SCI + '/etc') + + + + Смотрите также + + + fileinfo + + + isdir + + + + + diff --git a/modules/fileio/help/ru_RU/listfiles.xml b/modules/fileio/help/ru_RU/listfiles.xml new file mode 100755 index 000000000..5c087bb3e --- /dev/null +++ b/modules/fileio/help/ru_RU/listfiles.xml @@ -0,0 +1,115 @@ + + + + + listfiles + список файлов + + + Последовательность вызова + files = listfiles(paths [,flag,flagexpand]) + + + Аргументы + + + paths + + + матрица строк, указывающая набор имён путей (обычно + оканчивающихся шаблоном, построенным с *). + + + + + flag, flagexpand + + + логические необязательные параметры (значение по умолчанию равно + %t). + + + + + files + + матрица строк. + + + + + + Описание + + Функция listfiles может быть использована для + составления списка файлов, которые соответствуют шаблонам, указанным + одним из элементов путей. Шаблоны указываются Unix-команде + ls или Windows-команде dir для + получения информации о файлах. Таким образом, чтобы написать переносимый + Scilab-сценарий, следует указывать корректные знаки шаблонов для обеих + ОС. Заметьте, что выполняется преобразование имени пути и, например, + SCI/core/macros/*.sci является корректным шаблоном + как для Unix, так и для Windows. + + + Если flag равен ИСТИНЕ, то имена пути, указанные с + помощью paths, преобразуются в соответствии со + значением getos() == 'Windows' (см. также pathconvert). + Более того, если flagexpand равен ИСТИНЕ, то + начальные строки, такие как SCIHOME, + SCI или ~ расширяются с помощью + переменных окружения. + + + Если входной путь является именем директории, то возвращаемые имена + файлов files относятся к этой директории. + + + Если входные пути содержат шаблон (например "/*", "*.c"), то к возвращаемым именам файлов files добавляется начало входного пути. + + + + Примеры + + + + + + История + + + 5.4.0 + + Если пути не являются одиночной строкой, то все возвращаемые файлы представляются единообразно в форме абсолютного пути. + + + + + + Смотрите также + + + findfiles + + + basename + + + pathconvert + + + + + diff --git a/modules/fileio/help/ru_RU/listvarinfile.xml b/modules/fileio/help/ru_RU/listvarinfile.xml new file mode 100755 index 000000000..0b345edeb --- /dev/null +++ b/modules/fileio/help/ru_RU/listvarinfile.xml @@ -0,0 +1,105 @@ + + + + listvarinfile + список переменных в файле сохранённых данных + + + Последовательность вызова + listvarinfile(filename) + [names, typs, dims, vols] = listvarinfile(filename) + + + + Аргументы + + + filename + + + символьная строка, имя файла (и путь), который следует + проинспектировать. + + + + + nams + + + матрица строк, имена переменных, сохранённых в файле filename. + + + + + dims + + + список, размерности переменных, сохранённых в файле + filename. + + + + + typs + + + числовая матрица, типы переменных, сохранённых в файле + filename. + + + + + vols + + + числовая матрица, размер (в байтах) переменных, сохранённых в файле filename. + + + + + + + Описание + + Эта служебная функция составляет список переменных (наподобие whos), + содержащихся в файле данных Scilab'а, полученного с помощью save. + + + + Гиперматрицы представляются в виде простых матричноориентированных списков (mlist); + рациональные числа и пространства состояний представляются в виде + простых типизированных списков (tlist); + графические дескрипторы не распознаются. + + + + + Примеры + + + + Смотрите также + + + whos + + + save + + + load + + + save_format + + + type + + + + + diff --git a/modules/fileio/help/ru_RU/maxfiles.xml b/modules/fileio/help/ru_RU/maxfiles.xml new file mode 100755 index 000000000..3b925612e --- /dev/null +++ b/modules/fileio/help/ru_RU/maxfiles.xml @@ -0,0 +1,66 @@ + + + + + maxfiles + + устанавливает предел количества одновременно открытых файлов + + + + Последовательность вызова + r = maxfiles(newnumbermax) + + + Аргументы + + + newnumbermax + + целое число: новое значение. + + + + r + + целое число: фактическое новое значение. + + + + + + Описание + + Функция maxfiles устанавливает предел количества одновременно открытых файлов. + + Минимум : 20. + Максимум : 100. + По умолчанию : 20. + + + Примеры + + + + Смотрите также + + + mopen + + + + + diff --git a/modules/fileio/help/ru_RU/mclearerr.xml b/modules/fileio/help/ru_RU/mclearerr.xml new file mode 100755 index 000000000..883437884 --- /dev/null +++ b/modules/fileio/help/ru_RU/mclearerr.xml @@ -0,0 +1,79 @@ + + + + + mclearerr + сбрасывает ошибки доступа к бинарному файлу + + + Последовательность вызова + mclearerr([fd]) + + + Аргументы + + + fd + + + скаляр: параметр fd возвращённый функцией + mopen. Для последнего открытого файла значение равно -1. Значение по умолчанию -1. + + + + + + + Описание + + Функция mclearerr используется для сброса индикатора ошибки и индикатора конца файла в ноль. + + + + Смотрите также + + + merror + + + mclose + + + mopen + + + mput + + + mget + + + mgetstr + + + mputstr + + + meof + + + mseek + + + mtell + + + + + diff --git a/modules/fileio/help/ru_RU/mclose.xml b/modules/fileio/help/ru_RU/mclose.xml new file mode 100755 index 000000000..24b79701c --- /dev/null +++ b/modules/fileio/help/ru_RU/mclose.xml @@ -0,0 +1,128 @@ + + + + + mclose + закрывает открытые файлы + + + Последовательность вызова + + err = mclose([fd]) + mclose('all') + + + + Аргументы + + + fd + + + скаляр: параметр fd, возвращённый функцией + mopen, используется в качестве файлового + дескриптора. + + + + + err + + скаляр: индикатор ошибки. + + + + + + Описание + + Функция mclose должна использоваться для закрытия файла, открытого функцией mopen. Если fd опущен, то mclose закрывает последний открытый файл. + + + mclose('all') закрывает все файлы, открытые с помощью + file('open',..) или mopen. + + Будьте осторожны с использованием mclose, поскольку, когда вы используете её внутри файла-сценария Scilab, то она также закроет и сам сценарий, и Scilab не выполнит команды, написанные после mclose('all'). + + + + + Примеры + + + + Смотрите также + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + file + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/mdelete.xml b/modules/fileio/help/ru_RU/mdelete.xml new file mode 100755 index 000000000..3decad59d --- /dev/null +++ b/modules/fileio/help/ru_RU/mdelete.xml @@ -0,0 +1,104 @@ + + + + + mdelete + удаляет файлы + + + Последовательность вызова + mdelete(filename) + + + Аргументы + + + filename + + + символьная строка: имя файлов (и путь), которые нужно удалить. + + + + + + + Описание + + mdelete может быть использована для удаления файла + или набора файлов, если filename содержит + метасимволы. + + + + Заметьте, что функция mdelete не спрашивает подтверждения, если вы вводите команду на удаление. Во избежание потери файлов, убедитесь, что вы точно указали файлы, которые вы хотите удалить. + + + + + Примеры + + + + Смотрите также + + + mopen + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + + + diff --git a/modules/fileio/help/ru_RU/meof.xml b/modules/fileio/help/ru_RU/meof.xml new file mode 100755 index 000000000..99b991baa --- /dev/null +++ b/modules/fileio/help/ru_RU/meof.xml @@ -0,0 +1,125 @@ + + + + + meof + проверяет достигнут ли конец файла + + + Последовательность вызова + err = meof(fd) + + + Аргументы + + + fd + + + скаляр: параметр fd, возвращённый функцией + mopen, используется в качестве файлового + дескриптора. + + + + + err + + скаляр: индикатор ошибки. + + + + + + Описание + + Функция meof вернёт ненулевое значение, если конец + файла был достигнут в предыдущем вызове mget или + mgetstr. Функция mclearerr + используется для сброса флага ошибки и флага конца файла в ноль. + + + + Examples + + + + Смотрите также + + + mclose + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/merror.xml b/modules/fileio/help/ru_RU/merror.xml new file mode 100755 index 000000000..ab6abeb64 --- /dev/null +++ b/modules/fileio/help/ru_RU/merror.xml @@ -0,0 +1,118 @@ + + + + + merror + проверяет индикатор ошибок доступа к файлу + + + Последовательность вызова + + err = merror([fd]) + [err, msg] = merror([fd]) + + + + Аргументы + + + fd + + + скаляр: параметр fd возвращённый функцией + mopen, используемый в качестве файлового + дескриптора. Для последнего открытого файла значение равно -1. + Значение по умолчанию -1. + + + + + err + + + скаляр: номер статуса ошибки самой последней операции ввода/вывода файла, связанная с указанным файлом. + + + Если самая последняя операция ввода/вывода, выполненная для + указанного файла, была успешной, то значение + msg пустое и merror + возвращает нулевое значение err. + + + + + msg + + строка: строковое сообщение об ошибке. + + + + + + Описание + + Функция merror используется для проверки индикатора ошибок доступа к файлу, возвращая ненулевое значение, если она установлена. Индикатор ошибки может быть сброшен только с помощью функции mclearerr. + + + Ненулевое значение err указывает на то, что произошла ошибка в самой последней операции ввода-вывода файла. Значение сообщения является строковым и может содержать информацию о природе ошибки. Если сообщение не помогает, то обратитесь за справкой в руководство по C-библиотекам времени запуска для вашей операционной системы. + + + + Примеры + 0) then + mprintf('Problem\n'); +end +mclose(fd); + ]]> + + + Смотрите также + + + mclearerr + + + mclose + + + mopen + + + mput + + + mget + + + mgetstr + + + mputstr + + + meof + + + mseek + + + mtell + + + + + diff --git a/modules/fileio/help/ru_RU/mfprintf.xml b/modules/fileio/help/ru_RU/mfprintf.xml new file mode 100755 index 000000000..f6cfa870b --- /dev/null +++ b/modules/fileio/help/ru_RU/mfprintf.xml @@ -0,0 +1,167 @@ + + + + + mfprintf + преобразует, форматирует и записывает данные в файл + + + Последовательность вызова + mfprintf(fd, format, a1, ..., an); + + + Аргументы + + + fd + + + скаляр, файловый дескриптор, предоставленный с помощью + mopen (это положительное число). + + + Если fd равен 0, то перенаправление в + стандартное устройство вывода сообщений об ошибках (stderr). + + + Если fd равен 6, то перенаправление в + стандартное устройство вывода (stdout). + + + УСТАРЕЛО: значение -1 относится к файлу по + умолчанию (т. е. последнему открытому файлу). + + + + + format + + + Scilab-строка, описывающая формат, который нужно использовать для + записи оставшихся операндов. Операнд format + следует как можно ближе к синтаксису операндов формата + printf в языке C. + + + + + str + + + символьная строка: строка, которую нужно отсканировать. + + + + + a1, ..., an + + + данные, которые преобразуются и распечатываются в соответствии с параметром формата. + + + + + + + Описание + + Функция mfprintf является интерфейсом для версии функции fprintf на языке C. + + + Функция mfprintf записывает форматированные + операнды в файл, указанный файловым дескриптором fd. + Операнды аргумента форматируются по управлением операнда + format. + + + Эта функция может быть использована для вывода векторов-столбцов чисел и + строковых векторов без явных циклов по элементам. В этом случае функция + проводит итерации по строкам. Наиболее короткий вектор даёт количество раз, сколько формат будет повторён. + + + Однородная последовательность параметров одинакового типа может быть + заменена матрицей. + + + + Примеры + 0)) then + editor(TMPDIR+'/text.txt') +end +mfprintf(0,'stderr output.\n'); +mfprintf(6,'stdout output.\n'); + ]]> + + + Смотрите также + + + mclose + + + meof + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + преобразование в printf + + + + + diff --git a/modules/fileio/help/ru_RU/mfscanf.xml b/modules/fileio/help/ru_RU/mfscanf.xml new file mode 100755 index 000000000..57f044309 --- /dev/null +++ b/modules/fileio/help/ru_RU/mfscanf.xml @@ -0,0 +1,259 @@ + + + + + mfscanf + + считывает входные данные из потока, указанного указателем потока (интерфейс с C-функцией fscanf) + + + + mscanf + + считывает входные данные с устройства стандартного ввода данных (интерфейс с C-функцией scanf) + + + + msscanf + + считывает свои входные данные из символьной строки (интерфейс с C-функцией sscanf) + + + + Последовательность вызова + + [n, v_1,..., v_m] = mfscanf([niter,]fd, format) + L = mfscanf([niter,] fd,format) + + [n, v_1,..., v_m] = mscanf([niter,] format) + L = mscanf([niter,]format) + + [n, v_1,..., v_m] = msscanf([niter,]str, format) + L = msscanf([niter,] str, format) + + + + Аргументы + + + format + + + Scilab-строка, описывающая формат, который нужно использовать для + записи оставшихся операндов. Операнд format + следует, как можно ближе синтаксису операндов формата C-функции + printf, как описано в + преобразовании в scanf. + + + + + fd + + + положительное целое число: файловый дескриптор, возвращённый функцией mopen. Значение -1 относится к последнему открытому файлу. + + + + + str + + Scilab-строка или вектор строк. + + + + niter + + + целое число: сколько раз использовать format. + + + + + n + + + целое число: количество данных, которое необходимо прочитать или -1, если конец файла был достигнут прежде, чем что-либо из данных было прочитано. + + + + + v_i + + + каждая из функций считывает символы, интерпретирует их в + соответствии с форматом format и сохраняет + результаты в своих выходных аргументах. Если выходных аргументов + указано больше, чем n, то последние аргументы + v_n+1, ..., v_m устанавливаются пустыми + матрицами. + + + + + L + + + если все данные однородны, то они сохраняются в уникальном + векторе, который возвращается, в противном случае + последовательности одного типа данных сохраняются в матрицах, а + возвращается матричноориентированный типизированный список mlist (с типом cblock), содержащий все построенные матрицы. + + + + + + + Описание + + Функция mfscanf считывает символы из потока + fd. + + + Функция mscanf считывает символы из окна Scilab. + + + Функция msscanf считывает символы из Scilab-строки + str. + + + Необязательный аргумент niter определяет сколько раз + использовать формат. Одна итерация формирует одну строку в выходной + матрице. Если niter==-1, то функция выполняет итерации до + конца файла. Значение niter по умолчанию равно 1. + + Комментарии о точности: + + mfscanf основана на C-функции + fscanf. Если вы используете + '%f', '%g', + '%e' в качестве формата, то ваши данные будут + приведены в тип плавающей запятой и возвращены в Scilab-переменную. + + + Если эта Scilab-переменная является числом двойной точности, то вы + можете получить некоторые ошибки по точности. В этом случае лучше + использовать формат '%lg'. + + + + Примеры + + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + + преобразование в scanf + + + + + diff --git a/modules/fileio/help/ru_RU/mget.xml b/modules/fileio/help/ru_RU/mget.xml new file mode 100755 index 000000000..c49ad6c3e --- /dev/null +++ b/modules/fileio/help/ru_RU/mget.xml @@ -0,0 +1,254 @@ + + + + + mget + + считывает байт или слово в заданном двоичном формате и преобразует в + число удвоенной точности + + + + mgeti + + считывает байт или слово в заданном двоичном формате и возвращает + целочисленное значение типа int + + + + Последовательность вызова + + x = mget([n, type, fd]) + x = mgeti([n, type, fd]) + + + + Аргументы + + + n + + положительный скаляр: количество считываемых данных. + + + + fd + + + скаляр: параметр fd, возращённый функцией mopen. Для последнего открытого файла ставится -1. Значение по умолчанию -1. + + + + + type + + + строка: двоичный формат, используемый для записи всех элементов + x. + + + + + x + + + вектор целых чисел или чисел с плавающей запятой. + + + + + + + Описание + + Функция mget считывает данные со входа, определённого параметром потока fd и возвращает вектор данных с плавающей запятой. + + + + Функция mgeti считывает данные со входа, определённого параметром потока fd и возвращает вектор целочисленных данных. + + + Данные считываются в положении, на которое в данный момент указывает указатель файла и передвигает индикатор далее соответствующим образом. + + + Параметр type является указателем преобразования, который может быть установлен в любой из следующих символов-флагов (со значением по умолчанию "l"): + + + + В Windows, поведение по умолчанию состоит в пропуске байта 13 (0x0D). + Функцию mopen следует вызывать с опцией + 'b', например, fd1 = mopen(file1,'rb'), так что все байты без исключения будут прочитаны. + + + Тип данных: + + + d + + удвоенная точность, double + + + + f + + плавающая запятая, float + + + + l + + длинное, long long + + + + i + + целочисленное, int (long int) + + + + s + + короткое, short + + + + c + + символ, character + + + + Необязательный флаг: + + + u.. + + + беззнаковый (в сочетании с одним из вышеперечисленных типов) + + + + + ..l + + + прямой порядок байтов (в сочетании с одним из вышеперечисленных + типов) + + + + + ..b + + + обратный порядок байтов (в сочетании с одним из вышеперечисленных + типов) + + + + + + Чтение байтов автоматически переключается при необходимости (с помощью проверки статуса little=endian). + + + Такое поведение переключения можно подавить, если добавить флаг в функцию mopen. + + + Форматы "l", "d" и + "f" корректны только с функцией + mget. + + + + Примеры + mget(1,'ull',fd1) + write(%io(2),'Bug'); +end + +fd2=mopen(file2,'rb'); +if 1996<>mget(1,'ull',fd2) + write(%io(2),'Bug'); +end + +mclose(fd1); +mclose(fd2); + ]]> + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/mgetl.xml b/modules/fileio/help/ru_RU/mgetl.xml new file mode 100755 index 000000000..9b70c1d71 --- /dev/null +++ b/modules/fileio/help/ru_RU/mgetl.xml @@ -0,0 +1,121 @@ + + + + + mgetl + считывает строки из текстового файла + + + Последовательность вызова + txt = mgetl(file_desc [,m]) + + + Аргументы + + + file_desc + + + символьная строка, указывающая имя файла или логический блок, возвращаемый функцией mopen. + + + + + m + + + целочисленный скаляр: количество строк, которое нужно прочитать. + Значение по умолчанию равно -1. + + + + + txt + + вектор-столбец строковых значений. + + + + + + Описание + + Функция mgetl позволяет считывать строки из + текстового файла. + + + Если m не указано или равно -1, + то будут считываться все строки до тех пор, пока не встретится конец + файла. + + + Если m указано, то функция mgetl + пытается прочитать точно m строк. Эта опция полезна + для последовательного чтения части файла. В этом случае, если конец + файла встретится прежде, чем будет прочитано m строк, + то прочитанные строки будут возвращены оформленными (можно проверять + встретился ли конец файла используя функцию meof). + + + Функция mgetl позволяет считывать файлы в + операционных системах Unix, Windows или Mac. + + + Функция mgetl поддерживает лишь кодировки UTF-8 и + ANSI. + + + + Примеры + + + + Смотрите также + + + mputl + + + mclose + + + mfscanf + + + mget + + + mput + + + mgetstr + + + mopen + + + read + + + + + diff --git a/modules/fileio/help/ru_RU/mgetstr.xml b/modules/fileio/help/ru_RU/mgetstr.xml new file mode 100755 index 000000000..c36ca2dab --- /dev/null +++ b/modules/fileio/help/ru_RU/mgetstr.xml @@ -0,0 +1,139 @@ + + + + + mgetstr + считывает символьную строку из файла + + + Последовательность вызова + str = mgetstr(n, [fd]) + + + Аргументы + + + n + + + неотрицательное целое число: количество символов, которое + необходимо прочитать. + + + + + fd + + + целое число: дескриптор файла, возвращаемый функцией + mopen, в котором необходимо + прочитать символы. Значение -1 ставится для + последнего открытого файла и оно является значением по умолчанию. + + + + + str + + символьная строка, которую нужно прочитать. + + + + + + Описание + + Функция mgetstr пытается прочитать + n символов из файла. Если конец файла достигнут + прежде, чем будут прочитаны n символов, то + mgetstr возвращает лишь те значения, которые + удалось прочитать. Как следствие, когда курсор чтения уже в конце файла, + когда вызывается функция mgetstr, то она возвращает + пустую строку, и при этом не важно какое значение указано для + n. + + + + Примеры + + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mtell + + + mdelete + + "Input/Output functions" section + + + + + + + diff --git a/modules/fileio/help/ru_RU/mopen.xml b/modules/fileio/help/ru_RU/mopen.xml new file mode 100755 index 000000000..b35cb818a --- /dev/null +++ b/modules/fileio/help/ru_RU/mopen.xml @@ -0,0 +1,349 @@ + + + + + mopen + открывает файл в Scilab'е + + + Последовательность вызова + [fd, err] = mopen(file [, mode, swap ]) + + + Аргументы + + + file + + + символьная строка, содержащая имя файла, который требуется открыть. + + + + + mode + + + символьная строка, определяющая требуемый режим доступа к файлу. + + + + + swap + + + скаляр. Если есть swap и swap = 0, тогда автоматическая перестановка байтов отключается. + + Значение по умолчанию равно 1. + + + + err + + скаляр. Индикатор ошибки. + + + значение ошибки: + сообщение об ошибке: + + + 0 + нет ошибки + + + -1 + больше нет логических модулей + + + -2 + не могу открыть файл + + + -3 + больше нет памяти + + + -4 + некорректное имя + + + -5 + некорректный статус + + + + + + fd + + + скаляр: дескриптор файла (это положительное целое число). + + + + + + + Описание + + Функция mopen может использоваться для + того, чтобы открыть файл file способом, + совместимым с C-процедурой fopen. Без + аргумента swap файл + file предполагается закодированным в + формате IEEE "с прямым порядком байтов" и байты данных + автоматически переставляются, если необходимо + соответствовать формату IEEE процессора. + + + Параметр mode управляет типом доступа к потоку. Этот параметр может иметь одно из + следующих значений: + + + + r + + + открывает файл для чтения (по умолчанию). Файл + должен существовать, в противном случае ничего + не получится. + + + + + w + + + открывает файл на запись. Если этот файл + существует, то его содержимое будет уничтожено. + + + + + a + + + открывает файл для добавления записи. Создаёт + файл если он не существует. + + + + + r+ + + + открывает файл как для чтения, так и для записи. + Файл должен существовать, иначе ничего не + получится. + + + + + w+ + + + открывает файл как для чтения, так и для записи. + Если файл существует, то его содержимое будет + уничтожено. + + + + + a+ + + + открывает файл как на чтение, так и на + добавление записи. Создаёт файл если он не + существует. + + + + + + Кроме того могут быть использованы следующие символы для определения типа файла: + + + t + + текстовый файл. + + + + b + + двоичный файл (по умолчанию). + + + + + + По умолчанию режим доступа 'rb' (чтение + двоичного файла). + + + + Заметьте: в Windows, в режиме текстового файла комбинации CR (возврат каретки) - LF (конец строки) преобразуются в LF при чтении, а LF преобразуются в комбинации CR-LF при записи. + + + + Когда вы открываете файл для обновления, вы можете выполнять операции + как ввода, так и вывода в результирующем потоке. Однако за операцией + вывода не может напрямую идти операция ввода без операции + позиционирования файла (функция mseek). Также, + за операцией ввода не может идти операция вывода без промежуточной + операции позиционирования файла пока операция ввода не встретит конец + файла. + + + Когда вы открываете файл для добавления записи (то есть, когда + параметр mode равен a или + a+), то невозможно перезаписать информацию, + которая уже есть в файле. Вы можете использовать функцию + mseek для смены положения указателя позиции в + файле в любое место файла, но, когда вывод записан в файл, текущий + указатель позиции в файле игнорируется. Весь вывод записывается в + конец файла и указатель позиции в файле перемещается в конец вывода. + + + Чтобы открыть файлы способом, совместимым с Fortran-функциями используйте функцию file. + + + + + + Примеры + + + + + + + + + + + + + + + + Смотрите также + + + file + + + mclose + + + merror + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mprintf + + + mput + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/movefile.xml b/modules/fileio/help/ru_RU/movefile.xml new file mode 100755 index 000000000..6c49b65f7 --- /dev/null +++ b/modules/fileio/help/ru_RU/movefile.xml @@ -0,0 +1,102 @@ + + + + + movefile + перемещает файл или директорию + + + Последовательность вызова + movefile(source, destination) + [status, message] = movefile(source, destination) + + + + Аргументы + + + source + + + символьная строка: источник. + + + + + destination + + + символьная строка: назначение. + + + + + status + + + целое число: статус работы. + + + + + message + + + символьная строка: сообщение об ошибке. + + + + + + + + Описание + + Инструкция movefile(source, destination) перемещает файл + или директорию source (и поддиректории) в файл или + директорию destination. + + + Если source является директорией, то + destination не может быть файлом. + + Функция movefile заменяет существующие файлы без предупреждения. + + + + Инструкция [status, message] = movefile(source, destination) перемещает источник source в + назначение destination, возвращая статус + status и сообщение message. + + + Для любой операционной системы если перемещение удалось, то статус + status будет равен 1, а сообщение message будет пустым; если же перемещение не удалось, то статус status будет равен 0, а сообщение message не будет пустым. + + + + Примеры + + + + Смотрите также + + + copyfile + + + + + diff --git a/modules/fileio/help/ru_RU/mput.xml b/modules/fileio/help/ru_RU/mput.xml new file mode 100755 index 000000000..4021d82ec --- /dev/null +++ b/modules/fileio/help/ru_RU/mput.xml @@ -0,0 +1,179 @@ + + + + + mput + + записывает байт или слово в заданном двоичном формате + + + + Последовательность вызова + mput(x [, type, fd]) + + + Аргументы + + + x + + + вектор целых чисел или чисел с плавающей запятой. + + + + + fd + + + скаляр: дескриптор файла, возвращённый функцией + mopen. Значение по умолчанию равно -1, + что означает последний файл, открытый функцией + mopen. + + + + + type + + + строка: двоичный формат, используемый для записи всех элементов x. + + + + + + + Описание + + Функция mput записывает данные в выход, + определённый параметром потока fd. Данные + записываются в место, на которое в данный момент указывает указатель + положения в файле, и передвигает указатель дальше соответствующим + образом. + + + Параметр type -- это определитель преобразования, который может быть установлен любым из следующих символов (значение по умолчанию "l"): + + + + "l", "i", "s", "ul", "ui", "us", "d", "f", "c", "uc" + + + для записи соответственно типов long long, int(long + int), short, unsigned long long, unsigned int(long int), unsigned short, double, float, char и unsigned char. Байты, которые записываются, автоматически переставляются, если нужно (это проверяется статусом прямого порядка байтов) для того, чтобы сделать двоичные файлы, независимые от машины. Режим перестановки байтов по умолчанию может быть подавлен добавлением флага swap = 0 в функции mopen. + + + + + "..l" или "..b" + + + Можно также записывать в режиме обратной и прямой последовательности байтов, добавляя символ "l" или "b" в конец указателя типа type. Например, + "db" будет записывать тип double в режиме обратного порядка байтов. + + + + + + + Примеры + mget(1,'l') then pause,end +if 1996<>mget(1,'i') then pause,end +if 1996<>mget(1,'s') then pause,end +if 98<>mget(1,'c') then pause,end + +// force little-endian +if 1996<>mget(1,'ll') then pause,end +if 1996<>mget(1,'il') then pause,end +if 1996<>mget(1,'sl') then pause,end +if 98<>mget(1,'cl') then pause,end + +// force big-endian +if 1996<>mget(1,'lb') then pause,end +if 1996<>mget(1,'ib') then pause,end +if 1996<>mget(1,'sb') then pause,end +if 98<>mget(1,'cb') then pause,end + +mclose(); + ]]> + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetl + + + mgetstr + + + mopen + + + mprintf + + + mputl + + + mputstr + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/mputl.xml b/modules/fileio/help/ru_RU/mputl.xml new file mode 100755 index 000000000..370f90afa --- /dev/null +++ b/modules/fileio/help/ru_RU/mputl.xml @@ -0,0 +1,108 @@ + + + + + mputl + записывает строки в текстовый файл + + + Последовательность вызова + r = mputl(txt, file_desc) + + + Аргументы + + + r + + + возвращает %t или %f для проверки правильно ли функция записала файл. + + + + + file_desc + + + символьная строка, указывающая имя файла или + + + целочисленный скаляр: дескриптор файла, возвращённый функцией mopen. + + + + + txt + + + вектор строк, текст для записи в файл. + + + + + + + Описание + + Функция mputl позволяет записывать вектор строковых значений в виде последовательности строк в текстовый файл. + + + Функция mputl поддерживает запись строк, закодированных в ANSI/ASCII и UTF-8. + + + + Примеры + + + + Смотрите также + + + mget + + + mgetl + + + mclose + + + mfprintf + + + mput + + + mputstr + + + mopen + + + write + + + + + diff --git a/modules/fileio/help/ru_RU/mputstr.xml b/modules/fileio/help/ru_RU/mputstr.xml new file mode 100755 index 000000000..d21de9ff3 --- /dev/null +++ b/modules/fileio/help/ru_RU/mputstr.xml @@ -0,0 +1,110 @@ + + + + + mputstr + записывает символьную строку в файл + + + Последовательность вызова + mputstr(str [, fd]); + + + Аргументы + + + fd + + + скаляр: дескриптор файла, возвращённый функцией mopen. Для последнего открытого файла ставится -1. Значение по умолчанию -1. + + + + + str + + символьная строка. + + + + + + Описание + + Функция mputstr позволяет записать символьную строку str в двоичный файл. + + + + Examples + + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mseek + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/mseek.xml b/modules/fileio/help/ru_RU/mseek.xml new file mode 100755 index 000000000..aa1bc4bcb --- /dev/null +++ b/modules/fileio/help/ru_RU/mseek.xml @@ -0,0 +1,155 @@ + + + + + mseek + устанавливает текущую позицию в двоичном файле + + + Последовательность вызова + mseek(n [,fd, flag]) + + + Аргументы + + + n + + + положительный скаляр: смещение от исходного положения в количестве байтов. + + + + + fd + + + скаляр: дескриптор файла, возвращённый функцией mopen. -1 + указывает на последний открытый файл. Значение по умолчанию равно -1. + + + + + flag + + + строка: определяет исходное положение. Значение по умолчанию -- + 'set'. + + + + + + + Описание + + Функция mseek устанавливает положение следующей + операции ввода или вывода потока fd. Новое + положение находится на расстоянии (со знаком), указанном в + n байт от начала, от текущего положения или от + конца файла в соответствии со значением flag, + которое может быть 'set', 'cur' + или 'end'. + + + Функция mseek позволяет индикатору положения в + файле быть установленным за пределами конца существующих данных в + файле. Если данные будут позднее записаны в это место, то последующее + чтение этих данных в пропущенном месте будет возвращать ноль до тех + пор, пока данные не будут действительно записаны в пропущенное место. + Функция mseek сама по себе не увеличивает + размер файла. + + + + Примеры + res then + write(%io(2),'Ошибка в программе'); +end +mseek(0,fd1,'set'); + +// попытка чтения данных более, чем сохранено +res1=mget(100,'d',fd1); +if res1<>res then + write(%io(2),'Ошибка в программе'); +end +meof(fd1) +mclearerr(fd1) +mclose(fd1); + ]]> + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mtell + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/mtell.xml b/modules/fileio/help/ru_RU/mtell.xml new file mode 100755 index 000000000..bda6c78d8 --- /dev/null +++ b/modules/fileio/help/ru_RU/mtell.xml @@ -0,0 +1,110 @@ + + + + + mtell + возвращает смещение текущего байта относительно начала файла + + + Последовательность вызова + mtell([fd]) + + + Аргументы + + + fd + + + скаляр: дескриптор файла, возвращённый функцией mopen. -1 + указывает на последний открытый файл. Значение по умолчанию равно -1. + + + + + + + Описание + + Функция mtell возвращает смещение текущего байта относительно начала файла, связанного с именованным потоком fd. + + + + Examples + + + + Смотрите также + + + mclose + + + meof + + + mfprintf + + + fprintfMat + + + mfscanf + + + fscanfMat + + + mget + + + mgetstr + + + mopen + + + mprintf + + + mput + + + mputstr + + + mseek + + + mdelete + + + + + diff --git a/modules/fileio/help/ru_RU/newest.xml b/modules/fileio/help/ru_RU/newest.xml new file mode 100755 index 000000000..1826b19e0 --- /dev/null +++ b/modules/fileio/help/ru_RU/newest.xml @@ -0,0 +1,77 @@ + + + + + newest + возвращает самый новый файл из набора файлов + + + Последовательность вызова + + k = newest(paths) + k = newest(path1, path2, ..., pathn) + + + + Аргументы + + + k + + + целое число: индекс самого нового файла. + + + + + paths + + + вектор символьных строк, paths(i) -- имя пути i-того файла. + + + + + pathi + + + символьная строка, имя пути i-того файла. + + + + + + + Описание + + Для указанного набора имён путей newest возвращает индекс самого нового файла. Несуществующие файлы считаются самыми старыми. + + + + Примеры + + + + Смотрите также + + + fileinfo + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/CHAPTER b/modules/fileio/help/ru_RU/path_filename/CHAPTER new file mode 100755 index 000000000..b0e4557b2 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/CHAPTER @@ -0,0 +1,2 @@ +title = Пути - Имена файлов + diff --git a/modules/fileio/help/ru_RU/path_filename/basename.xml b/modules/fileio/help/ru_RU/path_filename/basename.xml new file mode 100755 index 000000000..3c8e61514 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/basename.xml @@ -0,0 +1,104 @@ + + + + + basename + отсекает директорию и расширение от имён файлов + + + Последовательность вызова + processedfiles = basename(files[,flag [,flagexpand]]) + + + Аргументы + + + files + + + матрица строковых значений, указывающая набор имён файлов + + + + + flag + + + логический необязательный параметр, используемые + для преобразования указанных путей в текущей + операционной системе. Значение по умолчанию + "истина" (%t). + + + + + flagexpand + + + логический необязательный параметр, используемый + для расширения переменных, идущих впереди, в + пути. Используется только с аргументом + flag argument. Значение по + умолчанию "истина" (%t). + + + + + processedFiles + + + матрица строковых значений, содержащая имена обработанных файлов. + + + + + + + Описание + + Функция basename(files) возвращает основное имя файлов, + указанных в files. + + + Если flag равен ИСТИНЕ, то файлы files сначала преобразуются + в целевой тип, указанный переменной getos() == 'Windows'. + Более того, если flagexpand равен ИСТИНЕ, то первые + строковые значение, такие, как SCIHOME, SCI + или ~ разворачиваются с помощью переменных окружения. + + + + Примеры + + + + Смотрите также + + + listfiles + + + pathconvert + + + fileparts + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/dirname.xml b/modules/fileio/help/ru_RU/path_filename/dirname.xml new file mode 100755 index 000000000..8fccb4557 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/dirname.xml @@ -0,0 +1,115 @@ + + + + + dirname + получает имя директории из имён файлов + + + Последовательность вызова + dirs = dirname(files[, flag [,flagexpand]]) + + + Аргументы + + + files + + + матрица строк, содержащая пути к файлам. + + + + + flag + + + необязательное логическое значение, используемое для + преобразования указанных путей для текущей операционной + системы. Значение по умолчанию ИСТИНА (%t). + + + + + flagexpand + + + необязательный логическое значение, используемое для + составления пути из переменных, идущих впереди. Используется + только вместе с аргументом flag. Значение + по умолчанию ИСТИНА (%t). + + + + + dirs + + матрица строк. + + + + + + Описание + + Функция dirname возвращает путь директории, составленный + из файлов, указанных в files. + + + Если flag равен ИСТИНЕ, то пути сначала преобразуются для + текущей операционной системы (например, 'C:/Tmp/folder' будет + преобразован в Windows в 'C:\Tmp\folder'). + + + Если flagexpand равен ИСТИНЕ, то переменные в начале пути + (home, SCI, SCIHOME, + ...) расширяются для текущей операционной системы (например, 'home\tmp' + будет преобразован в GNU/Linux в 'home/<user>/tmp', + где <user> - это имя учётной записи пользователя). + + + Смотрите подробную информацию о flag и flagexpand + в разделе, посвящённому pathconvert. + + + + Примеры + + + + Смотрите также + + + basename + + + listfiles + + + pathconvert + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/fileext.xml b/modules/fileio/help/ru_RU/path_filename/fileext.xml new file mode 100755 index 000000000..ccf8c147e --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/fileext.xml @@ -0,0 +1,65 @@ + + + + + fileext + возвращает расширение файла + + + Последовательность вызова + extension = fileext(fullpath) + + + Аргументы + + + fullpath + + строковая матрица, указывающая путь до файла. + + + + extension + + строковая матрица, часть, относящаяся к расширению; + может быть любой или ''. + + + + + + + Описание + + extension = fileext(fullpath) изымает из + символьной строки часть, относящуюся к расширению, включая точку. + + + + Примеры + + + + Смотрите также + + + fileparts + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/fileparts.xml b/modules/fileio/help/ru_RU/path_filename/fileparts.xml new file mode 100755 index 000000000..f03c11c8e --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/fileparts.xml @@ -0,0 +1,110 @@ + + + + + fileparts + возвращает путь, имя файла и расширение для указанного пути к файлу + + + Последовательность вызова + [path, fname, extension] = fileparts(fullpath) + value = fileparts(fullpath, sel) + + + + Аргументы + + + fullpath + + символьная строка, указанный путь к файлу + + + + sel + + + необязательная символьная строка: выбор с возможными значениями: + 'path', 'fname' или 'extension' + + + + + path + + + символьная строка; путь к директории, указанной в fullpath. + + + + + fname + + + символьная строка; часть, относящаяся к имени файла, может быть + любой или ''. + + + + + extension + + + символьная строка; часть, относящаяся к расширению, может + быть любой или ''. + + + + + value + + + символьная строка в зависимости от значения sel. + + + + + + + Описание + + [path, fname, extension] = fileparts(fullpath) разделяет + символьную строку fullpath на три части: часть, + относящуюся к пути до директории, часть, относящуюся к имени файла и + часть, относящуюся к расширению, включая точку. + + + + Примеры + + + + Смотрите также + + + pathconvert + + + basename + + + fullfile + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/filesep.xml b/modules/fileio/help/ru_RU/path_filename/filesep.xml new file mode 100755 index 000000000..681a14706 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/filesep.xml @@ -0,0 +1,47 @@ + + + + + filesep + возвращает разделитель директорий для текущей платформы + + + Последовательность вызова + s = filesep() + + + Аргументы + + + s + + строка + + + + + + Описание + + Функция filesep возвращает разделитель директорий ('/' в GNU/Linux или '\' в Windows). + + + + Примеры + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/fullfile.xml b/modules/fileio/help/ru_RU/path_filename/fullfile.xml new file mode 100755 index 000000000..3c82fa232 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/fullfile.xml @@ -0,0 +1,75 @@ + + + + + fullfile + формирует полное имя файла из частей + + + Последовательность вызова + f = fullfile(varargin) + + + Аргументы + + + varargin + + + символьные строки, все директории и имена файлов, + используемые для формирования полного имени файла (хотя бы + одна директория и имя файла). + + + + + f + + + символьная строка или матрица строк, полное имя файла. + + + + + + + Описание + + f = fullfile(varargin) формирует полное имя + файла учитывая платформу, на которой она работает и обрабатывает + случаи, когда директории начинаются или заканчиваются + разделителем директорий. + + + + Примеры + + + + Смотрите также + + + pathconvert + + + fileparts + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/fullpath.xml b/modules/fileio/help/ru_RU/path_filename/fullpath.xml new file mode 100755 index 000000000..abbc79d72 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/fullpath.xml @@ -0,0 +1,86 @@ + + + + + fullpath + + создаёт имя полного пути для определённого имени относительного пути + + + + Последовательность вызова + res = fullpath(relative_path) + + + Аргументы + + + res + + строка или матрица строк, имя полного пути. + + + + + + relative_path + + строка или матрица строк, имя относительного пути. + + + + + + Описание + + fullpath(relative_path) создаёт имя полного + пути для определённого имени относительного пути + relative_path. + + + В GNU/Linux нужно, чтобы относительный путь + relative_path существовал. + + + + Примеры + + + + История + + + 5.4.0 + Управление матрицей строк (SEP + 72) + + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/get_absolute_file_path.xml b/modules/fileio/help/ru_RU/path_filename/get_absolute_file_path.xml new file mode 100755 index 000000000..12ed021f5 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/get_absolute_file_path.xml @@ -0,0 +1,86 @@ + + + + + get_absolute_file_path + + даёт имя абсолютного пути к файлу, открытому в Scilab'е + + + + Последовательность вызова + pathname = get_absolute_file_path(filename) + + + Аргументы + + + filename + + символьная строка: имя файла. + + + + pathname + + символьная строка: имя абсолютного пути. + + + + + + Описание + + get_absolute_file_path даёт имя абсолютного пути к файлу filename, который уже открыт в Scilab'е. + + + get_absolute_file_path ищет во внутреннем списке + файлов Scilab'а открытый в данный момент файл filename + и возвращает его путь pathname. + + Если файл не открыт, то будет возвращена ошибка. + + + В предыдущих версиях (Scilab 5.0.x) возвращалась текущая директория, если файл не был найден. + + + + Эта функция может быть использована для определения того, откуда (путь) исполняется сценарий Scilab'а. + + + + Примеры + + + + Смотрите также + + + getshortpathname + + + getlongpathname + + + pwd + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/getdrives.xml b/modules/fileio/help/ru_RU/path_filename/getdrives.xml new file mode 100755 index 000000000..7cd07e41c --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/getdrives.xml @@ -0,0 +1,57 @@ + + + + + getdrives + + получает буквы дисков всех подключенных файловых систем на компьютере + + + + Последовательность вызова + drives = getdrives() + + + Аргументы + + + drives + + матрица строк, диски. + + + + + + Описание + + Функция getdrives получает буквы дисков всех + подключенных файловых систем на компьютере. + + + Функция getdrives возвращает корневые каталоги всех + файловых систем в виде матрицы строк. + + + Для GNU/Linux этот список состоит лишь из корневой директории, /. + + + + Примеры + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/getlongpathname.xml b/modules/fileio/help/ru_RU/path_filename/getlongpathname.xml new file mode 100755 index 000000000..ac23ae994 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/getlongpathname.xml @@ -0,0 +1,85 @@ + + + + + getlongpathname + получает длинное имя пути (только для Windows) + + + Последовательность вызова + longpath = getlongpathname(shortpath) + [longpath, bOK] = getlongpathname(shortpath) + + + + Аргументы + + + shortpath + + символьная строка или матрица строк: короткое имя пути. + + + + longpath + + символьная строка или матрица строк: длинное имя пути. + + + + bOK + + + логическое значение или матрица логических значений: %T, если путь был преобразован, в противном случае -- %F. + + + + + + + Описание + + Примитив getlongpathname преобразует указанное имя + пути shortpath в его длинную форму. Если не было + найдено длинного имени пути, то этот примитив возвращает указанное имя. + + + + Примечание: если путь нельзя преобразовать (bOK равен %F), в особенности, если операционная система не Windows, то возвращаемый длинный путь идентичен входному краткому пути. + + + + + Примеры + + + + Смотрите также + + + getshortpathname + + + getrelativefilehname + + + pwd + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/getrelativefilename.xml b/modules/fileio/help/ru_RU/path_filename/getrelativefilename.xml new file mode 100755 index 000000000..8da9a84a8 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/getrelativefilename.xml @@ -0,0 +1,85 @@ + + + + + getrelativefilename + + для указанного имени полного пути к директории и абсолютного имени файла данная функция возвращает относительное имя файла + + + + Последовательность вызова + rel_file = getrelativefilename(abs_dir, abs_file) + + + Аргументы + + + abs_dir + + символьная строка: абсолютный путь к директории. + + + + abs_file + + символьная строка: абсолютное имя файла. + + + + rel_file + + символьная строка: относительное имя файла. + + + + + + Описание + + Для указанных абсолютного пути к директории abs_dir и абсолютного имени файла abs_file, функция getrelativefilename возвращает относительное имя файла rel_file. + + + Например, если текущая директория + C:\scilab\bin, а имя файла + C:\scilab\modules\helptools\readme.txt, то getrelativefilename возвратит + ..\modules\helptools\readme.txt. + + + + Примеры + + + + Смотрите также + + + getshortpathname + + + getlongpathname + + + pwd + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/getshortpathname.xml b/modules/fileio/help/ru_RU/path_filename/getshortpathname.xml new file mode 100755 index 000000000..6cd68847b --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/getshortpathname.xml @@ -0,0 +1,88 @@ + + + + + getshortpathname + получает короткое имя (только для Windows) + + + Последовательность вызова + shortpath=getshortgpathname(longpath) + [shortpath,bOK]=getshortpathname(longpath) + + + + Аргументы + + + longpath + + символьная строка или матрица строк: длинное имя пути. + + + + shortpath + + + символьная строка или матрица строк: короткое имя пути. + + + + + bOK + + + логическое значение или матрица логических значений: + %T, если путь был преобразован, в противном + случае -- %F. + + + + + + + Описание + + Примитив getshortpathname преобразует указанное имя + пути longpath в его краткую форму. + + + + Примечание: если путь нельзя преобразовать (bOK равен %F), в особенности, если операционная система не Windows, то возвращаемый короткий путь идентичен входному длинному пути. + + + + + Примеры + + + + Смотрите также + + + getlongpathname + + + getrelativefilehname + + + pwd + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/is_absolute_path.xml b/modules/fileio/help/ru_RU/path_filename/is_absolute_path.xml new file mode 100755 index 000000000..175f82f2f --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/is_absolute_path.xml @@ -0,0 +1,66 @@ + + + + + is_absolute_path + проверяет, является ли аргумент абсолютным путём + + + Последовательность вызова + r = is_absolute_path(path) + + + Аргументы + + + path + + символьная строка или матрица строк: путь до директории. + + + + r + + + логическое значение: %t, если путь path является абсолютным. + + + + + + + Описание + + r = is_absolute_path(path) проверяет, является ли путь path абсолютным. + + + + Примеры + + + + Смотрите также + + + get_absolute_file_path + + + fileparts + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/pathconvert.xml b/modules/fileio/help/ru_RU/path_filename/pathconvert.xml new file mode 100755 index 000000000..2602ba69b --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/pathconvert.xml @@ -0,0 +1,150 @@ + + + + + pathconvert + преобразование имён путей между POSIX и Windows. + + + Последовательность вызова + paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]]) + + + Аргументы + + + paths + + + матрица строк, указывающая набор путей к файлам. + + + + + flagtrail + + + необязательное логическое значение, используемое для + добавления завершающего разделителя к путям (\ + или / в зависимости от целевого формата пути). + Его значение по умолчанию равно %t. + + + + + flagexpand + + + необязательное логическое значение, используемое для составления + пути из переменных, идущих впереди. Его значение по умолчанию + ИСТИНА (%t). + + + + + type + + + необязательное строковое значение, используемое для определения + целевого формата пути: 'u' для формата пути + POSIX (GNU/Linux, ...) и 'w' формата пути Windows. + + + + + + + Описание + + Функция pathconvert используется для преобразования + набора имён путей в формат, совместимый с операционной системой. Например, + стиль путей в Windows использует / для разделителей + файлов, в то время как в других операционных системах это \. + + + По умолчанию пути преобразуются в формат путей текущей операционной + системы (но можно определить и другой формат путей с помощью + аргумента type). + + + + Заметьте: пути в Windows, начинающиеся с префикса буквы диска, + преобразуются в пути POSIX, используя соглашение cygwin (с + /cygdrive). Например: C:\tmp + будет преобразовано в /cygdrive/C/tmp. + + + + flagtrail используется для добавления или удаления + разделителя файлов (в зависимости от целевого формата пути) к концу + путей. Когда этот параметр установлен в ИСТИНУ, то заключительный + разделитель файлов добавляется. В противном случае заключительный + разделитель удаляется. + + + flagexpand используется для развёртывания + переменных окружения Scilab'а, стоящих в путях впереди. + Принимаются следующие переменные: + + + SCI + + + WSCI + + + SCIHOME + + + TMPDIR + + + home (или ~) + + + + WSCI не известна в GNU/Linux, а + ~ в значении "путь" неизвестна в + Windows. + + + + + Примеры + + + + Смотрите также + + + basename + + + listfiles + + + dirname + + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/pathsep.xml b/modules/fileio/help/ru_RU/path_filename/pathsep.xml new file mode 100755 index 000000000..e56f615d3 --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/pathsep.xml @@ -0,0 +1,47 @@ + + + + + pathsep + возвращает разделитель пути для текущей платформы + + + Последовательность вызова + s = pathsep() + + + Аргументы + + + s + + строковое значение + + + + + + Описание + + pathsep возвращает разделитель пути (':' в GNU/Linux или ';' в Windows). + + + + Примеры + + + + diff --git a/modules/fileio/help/ru_RU/path_filename/tempname.xml b/modules/fileio/help/ru_RU/path_filename/tempname.xml new file mode 100755 index 000000000..4abd9950f --- /dev/null +++ b/modules/fileio/help/ru_RU/path_filename/tempname.xml @@ -0,0 +1,78 @@ + + + + + tempname + + создаёт файл с уникальным именем + + + + Последовательность вызова + tmp_name = tempname([prefix]) + + + Аргументы + + + tmp_name + + строка: имя файла + + + + + + prefix + + + строка: префикс имени файла (в Windows максимум 3 символа). + + + + + + + Описание + + Функция tempname создаёт файл с уникальным + именем в директории TMPDIR. + + + tmp_name = tempname() возвращает уникальную строку, + tmp_name, подходящую для использования в + качестве временного файла. + + + + Примеры + + + + История + + + 5.4.0 + + Введена функция tempname. + + + + + + diff --git a/modules/fileio/help/ru_RU/save_format.xml b/modules/fileio/help/ru_RU/save_format.xml new file mode 100755 index 000000000..e42ba90d3 --- /dev/null +++ b/modules/fileio/help/ru_RU/save_format.xml @@ -0,0 +1,892 @@ + + + + + save format + формат файлов, полученных с помощью функции "save" + + + Аннотация + + Целью данного документа является определения формата HDF5, + используемого Scilab'ом для хранения своих данных. + + + Этот формат называется SOD от английского Scilab Open Data + ("открытые данные Scilab'а"). + + + Первый публичный релиз SOD был сделан в Scilab 5.4.0. + + + + Основная причина + + Интероперабельность является одним из ключевых аспектов + современного программного обеспечения. Для того, чтобы + больше и больше улучшать этот аспект был предложено + стандартное определение формата HDF5. + + + Со времён Scilab 5.2.0 была разработана возможность + экспорта/импорта, которая используется для обмена данными. + Это уже один из основных компонентов Xcos для хранения и + обмена данными. + + + + Поддерживаемые типы данных + + Поддерживаются все типы данных Scilab'а. Например: + + + + + + Имя + + + Пример в Scilab'е + + + + + double + + + A=32; + b=[32,2]; + c=[2,2;3,4]; + d=rand(10,10); + + + + + string + + + a="my string"; + b=["string 1";"my string 2"]; + + + + + boolean + + + a=%t; + b=[%t, %f]; + + + + + integer + + + + int8([1 -120 127 312]) + x=int32(-200:100:400) + + + + + + polynomial + + + + s=poly([2 3],"s") + poly(1:4,'s','c') + + + + + + sparse + + + + sp=sparse([1,2;4,5;3,10],[1,2,3]) + + + + + + boolean sparse + + + + dense=[%F, %F, %T, %F, %F + %T, %F, %F, %F, %F + %F, %F, %F, %F, %F + %F, %F, %F, %F, %T]; + sp=sparse(dense) + + + + + + list + + + + l = list(1,["a" "b"]) + + + + + + tlist + + + + t = tlist(["listtype","field1","field2"], [], []); + + + + + + mlist + + + + M=mlist(['V','name','value'],['a','b';'c' 'd'],[1 2; 3 4]); + + + + + + + Несколько "типов" основаны на tlist или + mlist. Это rational, + state-space, hypermat, + cell и struct. + Следовательно, они явно сохраняются. + + + void и undefined - + это два особых элемента, созданных для управления особыми + случаями в управлении списками. Они описаны ниже. + + + + Структура файла HDF5 + + Архитектура HDF5 Scilab'а довольно проста. + + Основные сведения + + Для каждой переменной Scilab'а декларируется набор данных в + корне. Имя набора данных - это имя переменной Scilab'а. + + + Например, следующий код: + + + emptyuint32matrix = uint32([]); + uint32scalar = uint32(1); + uint32rowvector = uint32([1 4 7]); + uint32colvector = uint32([1;4;7]); + uint32matrix = uint32([1 4 7;9 6 3]); + save("uint32.sod","emptyuint32matrix","uint32scalar","uint32rowvector","uint32colvector","uint32matrix"); + + формирует: + + + + + + + Каждый корневой набор данных имеет атрибут, именуемый + SCILAB_Class. Этот атрибут определяет + какие типы переменных хранятся в HDF5-файле. + + + Если переменная является основным типом и без связанных с + ним комплексных значений, то данные сохраняются + непосредственно в набор данных. В противном случае, набор + данных содержит ссылки на фактические данные. + + + Каждый SOD-файл содержит две особые переменные: + + + + + SCILAB_scilab_version - описывает + какая версия Scilab'а использовалась для сохранения + SOD-файла. + + + Например, для Scilab 5.4.0 эти данные будут иметь вид: + + + SCILAB_scilab_version = scilab-5.4.0 + + + + + SCILAB_sod_version - описывает + какая версия спецификации SOD использовалась для + сохранения файла. + + + Например, для Scilab 5.4.0 эти данные будут иметь вид: + + + SCILAB_sod_version = 2 + + + + + Типы, данные которых сохраняются непосредственно в набор + данных. + + + + + + Тип Scilab'а + + + Атрибут HDF5 типа Scilab'а + + + Атрибуты HDF5 + + + Расположение типов данных HDF + + + + + string + + + SCILAB_Class = string + + + + + + строковое значение + + + + + boolean + + + SCILAB_Class = boolean + + + + + + 32-битное целое число + + + + + integer + + + SCILAB_Class = integer + + + SCILAB_precision = {8, 16, 32, u8, u16, u32} + + + 8 = 8-битный символ + 16 = 16-битное целое число + 32 = 32-битное целое число + u8 = 8-битное целое беззнаковое число + u16 = 16-битное целое беззнаковое число + u32 = 32-битное целое беззнаковое число + + + + + + Для этих типов, как в Scilab'е, данные хранятся в одномерном + массиве. Данные сохраняются столбец на столбцом. + + + Для восстановления матрицы, вектора или скаляра, два + атрибута дают количество столбцов и строк. + + + Начиная с релиза 5.4.0 Scilab'а и SOD v2, SCILAB_cols и + SCILAB_rows больше не используются для + матриц типа double, integer, polynomial и string. SOD + использует родную многомерную возможность HDF5. + + + Пример + + + Сохранение декларации: int32([1 -4 7;-9 6 -3]) + будет отображено как: + + + + + + + в hdfview. + А метаданные будут отображены как: + + int32matrix (800, 2) + 32-bit integer, 3 x 2 => размер переменной + Number of attributes = 2 + SCILAB_Class = integer + SCILAB_precision = 32 + + + + Скалярное значение хранится в виде матрицы размером 1 на 1. + + + + Пустая переменная ([]) будет иметь + атрибут SCILAB_empty, установленный в + значение ИСТИНА. + + + Типы, в которых данные хранятся в + соответствующей группе + + + + Многие типы данных Scilab'а хранятся с помощью групп. Это + позволяет не только явно разделять значения, но и иметь + лёгкий доступ к ним. + + + Группы именуются по переменным, заключённым в знак "#". + Например, для матрицы значений типа double, названной + matrixofdouble, имя корневого набора данных будет + matrixofdouble, имя связанной с ней группы будет #matrixofdouble#. + + + Для рекурсивного типа данных (list, mlist, tlist и т. д.) + имена подгрупп построены следующим образом: + + + Знак # позволяет создавать уникальный + идентификатор. Количество начальных знаков + # показывает уровень глубины. + Следовательно подсписок + ###listnested#_#2##_#1## будет + указывать, что он помещён на второй уровень. + + + Символ подчёркивания "_" является способом представить + глубину. Обычно в таких случаях используется символ "/", но + это зарезервированное ключевое слово в спецификации HDF5. + + + Целые числа, используемые в названии, показывают положение в + структуре данных, оба в терминах положения в текущей + структуре, но также относительно родительского элемента. В + примере ###listnested#_#2##_#1##, 1 + показывает, что мы имеем дело со вторым элементом третьей + структуры главного элемента (элементы индексируются начиная + с 0). + + + В следующем примере, группа, названная + ###listnested#_#2##_#1##, + будет указывать на значение [32, 42]: + + + listnested=list(2,%i,'f',ones(3,3)) + listnested(3) = list( %t, [32,42]); + + + Разрежённая матрица + + + Тип Scilab'а: sparse + + + атрибут HDF5 типа + Scilab'а: + + SCILAB_Class = sparse + + + атрибуты HDF5: + + SCILAB_rows = <int> + Количество строк + + SCILAB_cols = <int> + + Количество столбцов + + SCILAB_items = <int> + + + Определение количества элементов разрежённой матрице + + + Значения корневого набора данных: + + + Первое значение (#0#): каждый элемент из + этой структуры данных показывает количество ненулевых + элементов на строку. Следовательно, первый элемент + показывает количество элементов в первой строке разрежённой + матрицы. + + + Второе значение (#1#): указывает + положение столбца каждого элемента разрежённой матрицы. + + + Третье значение (#2#): хранит ссылку на + фактические значения элементов в разрежённой матрице (каждое + будет сохранено в особой группе). + + Например, взяв такую матрицу: + + 0. 1. 0. 0. 0. 0. 0. 0. 0. 0. + 0. 0. 0. 0. 0. 0. 0. 0. 0. 0. + 0. 0. 0. 0. 0. 0. 0. 0. 0. 3. + 0. 0. 0. 0. 2. 0. 0. 0. 0. 0. + + которая формируется функцией: + + sparse([1,2;4,5;3,10],[1,2,3]) + + + будем иметь: + + + #0# содержит 1;0;1;1 + + + #1# содержит 2;10;5 + + + #2# обращается к матрице чисел типа + double (в этом примере они не комплексные), которая содержит + 1.0; 3.0; 2.0. + + + Разрежённая матрица логических значений + + + Тип Scilab'а: boolean sparse + + + атрибут HDF5 типа Scilab'а: SCILAB_Class = boolean sparse + + + атрибуты HDF5: + + + SCILAB_rows = <int> + + Количество строк + + SCILAB_cols = <int> + + Количество столбцов + + SCILAB_items = <int> + + + Определение количества элементов в разрежённой матрице + + + Значения корневого набора + данных: + + в то время как разрежённая матрица имеет + 3 набора данных, разрежённая матрица логических значений + имеет только 2, поскольку определяемые значения + автоматически рассматриваются как истинные. + + + Первое значение (#0#): каждый элемент + этой структуры данных показывает количество ненулевых + элементов в строке. + + + Следовательно, первый элемент показывает количество + элементов в первой строке разрежённой матрицы. + + + Второе значение (#1#): указывает + положение столбца каждого из элементов разрежённой матрицы. + + В разрежённой матрице логических значений: + + dense=[%F, %F, %T, %F, %F + %T, %F, %F, %F, %F + %F, %F, %F, %F, %F + %F, %F, %F, %F, %T]; + + + #0# содержит 1;1;0;1. + + + #1# содержит 3;1;5. + + + Для восстановления разрежённой матрицы логических значений + требуется только два значения. + + + Расположение типов данных + HDF + + :32-битное целое + + + Числа удвоенной точности + + + Тип Scilab'а: double + + + атрибут HDF5 типа Scilab'а: SCILAB_Class = double + + + Значения корневого набора данных: + + + Как вещественные так и комплексные значения хранятся в + группе, именуемой #<имя переменной>#. + + + Первое значение: ссылка на вещественные значения. Названо + #0#. + + + Если матрица комплексная, то второе значение будет ссылаться + на комплексные значения. Названо #1#. + + + Расположение типов данных + HDF + + 64-битное с плавающей запятой + + + Полином + + + Тип Scilab'а: polynomial + + + атрибут HDF5 типа + Scilab'а: + + SCILAB_Class = polynomial + + + атрибуты HDF5: + + SCILAB_Class = polynomial + SCILAB_varname = <string> + Имя символьной переменной + + SCILAB_Complex = <boolean> + + + Если полином комплексный (не устанавливается, если ложь). + + + Значения корневого набора + данных: + + + + Коэффициенты хранятся в виде матрицы чисел удвоенной + точности (сравни соответствующий раздел, посвящённый + хранению чисел удвоенной точности). Интересно отметить, что + коэффициенты могут быть комплексными и, следовательно, могут + храниться в виде матрицы комплексных значений. Правила + наименования (под-)групп и набора данных описаны в начале + этого раздела. + + + Расположение типов данных HDF ссылка на объект + + + Список + + + Тип Scilab'а: list + + + атрибут HDF5 типа Scilab'а: + + SCILAB_Class = list + + атрибуты HDF5: + SCILAB_items = <количество пунктов в списке> + + + Значения корневого набора данных: + + + Привязанные к корневому набору данных значения хранятся в + этом наборе и являются ссылками на значения, хранимые в + списке. Значения хранятся в группе, названной + #<имя переменной>#. В группе + #<имя переменной># данные могут + быть любого типа. Они прямо включены в группу. Их + представления те же самые, что и в других случаях, + основанных на рекурсивной структуре (имеется в виду, что + можно сохранить и загрузить список списка списка различных + типов). + + + Правила наименования (под-)групп и набора данных описаны в + начале этого раздела. + + + Расположение типов данных HDF ссылка на объект + + + Типизированный список + + + Тип Scilab'а: tlist + + + атрибут HDF5 типа Scilab'а: + + SCILAB_Class = tlist + + атрибуты HDF5: см. список + + + матричноориентированный список + + + Тип Scilab'а: mlist + + + атрибут HDF5 типа Scilab'а: + + SCILAB_Class = mlist + + атрибуты HDF5: см. список + + + Пустое значение + + + Тип Scilab'а: void + + + атрибут HDF5 типа Scilab'а: + + SCILAB_Class = void + + Пустое значение можно найти только в очень особых случаях + использования списков, типизированных списков и + матричноориентированных списков. Оно может быть создано с + помощью следующего синтаксиса: + + voidelement_ref=list(1,,3); + + Неопределённое значение + + + Тип Scilab'а: undefined + + + атрибут HDF5 типа Scilab'а: + + SCILAB_Class = undefined + + Неопределённое значение формируется, когда размер списка + увеличивается, а некоторые элементы не определены. Они будут + сформированы с помощью следующего синтаксиса: + + + undefinedelement_ref=list(2,%i,'f',ones(3,3)); + undefinedelement_ref(6)="toto" + + + + Примеры из жизни + + Файлы с образцами всех этих переменных прилагаются к + дистрибутиву Scilab'а. Они лежат в директории: + SCI/modules/hdf5/tests/sample_scilab_data/ + + + На момент редактирования этого документа были приложены + следующие файлы: + + + + booleanmatrix.sod + + booleanscalar.sod + + booleansparse.sod + + emptymatrix.sod + + emptysparse.sod + + hypermatrixcomplex.sod + + hypermatrix.sod + + int16.sod + + int32.sod + + int8.sod + + listnested.sod + + list.sod + + matricedoublecomplexscalar.sod + + matricedoublecomplex.sod + + matricedoublescalar.sod + + matricedouble.sod + + matricestringscalar.sod + + matricestring.sod + + mlist.sod + + polynomialscoef.sod + + polynomials.sod + + sparsematrix.sod + + tlist.sod + + uint16.sod + + uint32.sod + + uint8.sod + + undefinedelement.sod + + voidelement.sod + + + + + История развития формата + + + + + Версия SOD + + + Версия Scilab'а + + + Описание + + + + + 0 + + + 5.2.0 + + + Начальная версия формата Scilab/HDF5 + + + + + 1 + + + 5.4.0 alpha / beta + + + + Формат по умолчанию для загрузки и сохранения. + + + Предыдущий формат (.bin) по-прежнему поддерживается. + + + + + + 2 + + + 5.4.0 + + + + Для матриц значений тип double, integer, polynomial и string + SCILAB_cols / SCILAB_rows были + удалены, чтобы использовать многомерные HDF5. + + + + + + + + + 6.0.0 (будущая) + + + .bin не поддерживается. + + + + + + + Смотрите также + + + save + + + load + + + listvarinfile + + + type + + + typeof + + + + diff --git a/modules/fileio/help/ru_RU/scanf.xml b/modules/fileio/help/ru_RU/scanf.xml new file mode 100755 index 000000000..ca7d90ef7 --- /dev/null +++ b/modules/fileio/help/ru_RU/scanf.xml @@ -0,0 +1,79 @@ + + + + + scanf + преобразует форматированный ввод в стандартном устройстве ввода + + + Последовательность вызова + [v_1, ..., v_n] = scanf(format); + + + Аргументы + + + format + + указывает преобразование формата. + + + + v_1, ..., v_n + + результаты преобразования. + + + + + + Описание + + Функция scanf получает символьные данные в стандартном устройстве ввода (%io(1)), интерпретирует их в соответствии с форматом format и возвращает преобразованные результаты v_1, ..., v_n. + + + Параметр format содержит спецификации преобразования, используемые для интерпретации ввода. + + + Параметр format может содержать символы пробелов (пробелы, табуляторы, символы перевода строки и прогона страницы), которые, за исключением двух следующих случаев, считывают ввод до следующего символа-непробела. За исключением совпадения с управляющей строкой, завершающие пробелы (включая символы новой строки) не считываются. + + + + + Любой символ, за исключением % (знак "процент"), который должен соответствовать следующему символу входного потока. + + + + + Спецификация преобразования, которая направляет преобразование следующего входного поля. См. подробности в преобразовании scanf. + + + + + + Смотрите также + + + read + + + mfscanf + + + преобразование scanf + + + + + diff --git a/modules/fileio/help/ru_RU/scanf_conversion.xml b/modules/fileio/help/ru_RU/scanf_conversion.xml new file mode 100755 index 000000000..0b2ca33f4 --- /dev/null +++ b/modules/fileio/help/ru_RU/scanf_conversion.xml @@ -0,0 +1,158 @@ + + + + + преобразование scanf + + спецификации преобразования mscanf, msscanf, mfscanf + + + + Описание + + Каждая спецификация преобразования в параметре format содержит следующие элементы: + + + + + символ % (знак "процент"); + + + + + необязательный символ подавления присвоения * ("звёздочка"); + + + + + необязательное числовое значение максимальной ширины поля; + + + + + код преобразования. + + + + + Спецификация преобразования имеет следующий синтаксис: + + + [*][ширина][размер]код_преобразования. + + + Результаты преобразования помещаются в аргументы v_i если вы не укажете подавление присвоения с помощью символа * ("звёздочка"). Подавления присвоения предоставляет способ описать входное поле, которое следует пропустить. Входное поле является строкой символов-непробелов. Оно простирается до ближайшего некорректного символа или до тех пор, пока ширина поля, если она указана, не кончится. + + + Код преобразования указывает как интерпретировать входное поле. Вам не нужно указывать параметр v_i для подавленного поля. Вы можете использовать следующие коды преобразования: + + + + % + + + принимает отдельный символ % (знак "процент"), вводимый в этом месте; присвоение не делается. + + + + + d, i + + принимает десятичное целое число. + + + + u + + принимает беззнаковое десятичное целое число. + + + + o + + принимает восьмеричное целое число. + + + + x + + принимает шестнадцатеричное целое число. + + + + e, f, g + + + принимает число с плавающей запятой. Следующее поле преобразуется соответствующим образом и сохраняется через соответствующий параметр, который должен быть указателем на число с плавающей запятой. Формат ввода для чисел с плавающей запятой является строкой цифр со следующими необязательными характеристиками: + + + + + это может быть значение со знаком; + + + + + это может быть экспоненциальное значение, содержащее десятичную запятую, за которой следует экспоненциальное поле, которое состоит из E или e, за которым следует целое число (может быть со знаком); + + + + + это может быть одно из специальных значений %inf, %nan. + + + + + + + s + + принимает строку символов; + + + + c + + + ожидается символьное значение. Нормальный пропуск пробела подавляется. + + + + + %lg + + получает значение в виде числа удвоенной точности (double). + + + + + + Смотрите также + + + msscanf + + + mfscanf + + + mscanf + + + преобразование printf + + + + + -- cgit