Mercurial > hg > octave-nkf
annotate src/utils.cc @ 11542:695141f1c05c ss-3-3-55
snapshot 3.3.55
| author | John W. Eaton <jwe@octave.org> |
|---|---|
| date | Sat, 15 Jan 2011 04:53:04 -0500 |
| parents | fd0a3ac60b0e |
| children | 7d6d8c1e471f |
| rev | line source |
|---|---|
| 1 | 1 /* |
| 2 | |
| 11523 | 3 Copyright (C) 1993-2011 John W. Eaton |
| 11012 | 4 Copyright (C) 2010 VZLU Prague |
| 1 | 5 |
| 6 This file is part of Octave. | |
| 7 | |
| 8 Octave is free software; you can redistribute it and/or modify it | |
| 9 under the terms of the GNU General Public License as published by the | |
| 7016 | 10 Free Software Foundation; either version 3 of the License, or (at your |
| 11 option) any later version. | |
| 1 | 12 |
| 13 Octave is distributed in the hope that it will be useful, but WITHOUT | |
| 14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 16 for more details. | |
| 17 | |
| 18 You should have received a copy of the GNU General Public License | |
| 7016 | 19 along with Octave; see the file COPYING. If not, see |
| 20 <http://www.gnu.org/licenses/>. | |
| 1 | 21 |
| 22 */ | |
| 23 | |
| 240 | 24 #ifdef HAVE_CONFIG_H |
| 1192 | 25 #include <config.h> |
| 1 | 26 #endif |
| 27 | |
| 3716 | 28 #include <cerrno> |
| 1343 | 29 #include <climits> |
| 1346 | 30 #include <cstring> |
| 1343 | 31 |
| 3503 | 32 #include <fstream> |
| 33 #include <iostream> | |
| 1728 | 34 #include <string> |
| 35 | |
| 1 | 36 #include <sys/types.h> |
| 37 #include <unistd.h> | |
| 367 | 38 |
| 4302 | 39 #include "quit.h" |
| 40 | |
| 3040 | 41 #include "dir-ops.h" |
| 42 #include "file-ops.h" | |
| 2926 | 43 #include "file-stat.h" |
| 4732 | 44 #include "lo-mappers.h" |
|
11006
aca961a3f387
provide gethostname function
John W. Eaton <jwe@octave.org>
parents:
10987
diff
changeset
|
45 #include "lo-utils.h" |
| 1651 | 46 #include "oct-cmplx.h" |
| 2926 | 47 #include "oct-env.h" |
| 3040 | 48 #include "pathsearch.h" |
| 1755 | 49 #include "str-vec.h" |
| 1651 | 50 |
| 4216 | 51 #include "Cell.h" |
| 2492 | 52 #include <defaults.h> |
| 1352 | 53 #include "defun.h" |
| 54 #include "dirfns.h" | |
| 55 #include "error.h" | |
| 56 #include "gripes.h" | |
| 57 #include "input.h" | |
|
10502
f13bf183a003
isvarname: keywords are not valid variable names
Judd Storrs <jstorrs@gmail.com>
parents:
10315
diff
changeset
|
58 #include "lex.h" |
| 5832 | 59 #include "load-path.h" |
| 5465 | 60 #include "oct-errno.h" |
| 1742 | 61 #include "oct-hist.h" |
| 1750 | 62 #include "oct-obj.h" |
|
10613
e103fb2182ce
use internal variable instead of warning state to control whether to allow non-integer ranges as indices
John W. Eaton <jwe@octave.org>
parents:
10605
diff
changeset
|
63 #include "ov-range.h" |
| 1352 | 64 #include "pager.h" |
|
10605
1834132fb50b
allow non-integer ranges as indices conditionally
John W. Eaton <jwe@octave.org>
parents:
10502
diff
changeset
|
65 #include "parse.h" |
| 1690 | 66 #include "sysdep.h" |
| 1750 | 67 #include "toplev.h" |
| 1 | 68 #include "unwind-prot.h" |
| 1352 | 69 #include "utils.h" |
| 70 #include "variables.h" | |
| 1 | 71 |
| 4143 | 72 // Return TRUE if S is a valid identifier. |
| 73 | |
| 74 bool | |
| 75 valid_identifier (const char *s) | |
| 76 { | |
| 5290 | 77 if (! s || ! (isalpha (*s) || *s == '_' || *s == '$')) |
| 4143 | 78 return false; |
| 79 | |
| 80 while (*++s != '\0') | |
| 5290 | 81 if (! (isalnum (*s) || *s == '_' || *s == '$')) |
| 4143 | 82 return false; |
| 83 | |
| 84 return true; | |
| 85 } | |
| 86 | |
| 87 bool | |
| 88 valid_identifier (const std::string& s) | |
| 89 { | |
| 90 return valid_identifier (s.c_str ()); | |
| 91 } | |
| 92 | |
|
8746
5dd06f19e9be
handle commands in the lexer
John W. Eaton <jwe@octave.org>
parents:
8715
diff
changeset
|
93 DEFUN (isvarname, args, , |
| 5040 | 94 "-*- texinfo -*-\n\ |
| 95 @deftypefn {Built-in Function} {} isvarname (@var{name})\n\ | |
|
11431
0d9640d755b1
Improve docstrings for all isXXX functions.
Rik <octave@nomad.inbox5.com>
parents:
11066
diff
changeset
|
96 Return true if @var{name} is a valid variable name.\n\ |
|
0d9640d755b1
Improve docstrings for all isXXX functions.
Rik <octave@nomad.inbox5.com>
parents:
11066
diff
changeset
|
97 @seealso{exist, who}\n\ |
| 4264 | 98 @end deftypefn") |
| 99 { | |
| 100 octave_value retval; | |
| 101 | |
| 102 int argc = args.length () + 1; | |
| 103 | |
| 4610 | 104 string_vector argv = args.make_argv ("isvarname"); |
| 4264 | 105 |
| 106 if (error_state) | |
| 107 return retval; | |
| 108 | |
| 109 if (argc == 2) | |
|
10502
f13bf183a003
isvarname: keywords are not valid variable names
Judd Storrs <jstorrs@gmail.com>
parents:
10315
diff
changeset
|
110 retval = valid_identifier (argv[1]) && ! is_keyword (argv[1]); |
| 4264 | 111 else |
| 5823 | 112 print_usage (); |
| 4264 | 113 |
| 114 return retval; | |
| 115 } | |
| 116 | |
| 6323 | 117 // Return TRUE if F and G are both names for the same file. |
| 118 | |
| 119 bool | |
| 120 same_file (const std::string& f, const std::string& g) | |
| 121 { | |
| 6598 | 122 return same_file_internal (f, g); |
| 6323 | 123 } |
| 124 | |
| 1 | 125 int |
| 3523 | 126 almost_match (const std::string& std, const std::string& s, int min_match_len, |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
127 int case_sens) |
| 1 | 128 { |
| 1755 | 129 int stdlen = std.length (); |
| 130 int slen = s.length (); | |
| 1 | 131 |
| 132 return (slen <= stdlen | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
133 && slen >= min_match_len |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
134 && (case_sens |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
135 ? (strncmp (std.c_str (), s.c_str (), slen) == 0) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
136 : (octave_strncasecmp (std.c_str (), s.c_str (), slen) == 0))); |
| 287 | 137 } |
| 138 | |
| 581 | 139 // Ugh. |
| 140 | |
| 287 | 141 int |
| 3523 | 142 keyword_almost_match (const char * const *std, int *min_len, const std::string& s, |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
143 int min_toks_to_match, int max_toks) |
| 287 | 144 { |
| 145 int status = 0; | |
| 146 int tok_count = 0; | |
| 147 int toks_matched = 0; | |
| 148 | |
| 1755 | 149 if (s.empty () || max_toks < 1) |
| 287 | 150 return status; |
| 151 | |
| 1755 | 152 char *kw = strsave (s.c_str ()); |
| 287 | 153 |
| 154 char *t = kw; | |
| 155 while (*t != '\0') | |
| 156 { | |
| 157 if (*t == '\t') | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
158 *t = ' '; |
| 287 | 159 t++; |
| 160 } | |
| 161 | |
| 162 char *beg = kw; | |
| 163 while (*beg == ' ') | |
| 164 beg++; | |
| 165 | |
| 166 if (*beg == '\0') | |
| 167 return status; | |
| 168 | |
| 169 | |
| 3072 | 170 const char **to_match = new const char * [max_toks + 1]; |
| 171 const char * const *s1 = std; | |
| 172 const char **s2 = to_match; | |
| 287 | 173 |
| 526 | 174 if (! s1 || ! s2) |
| 287 | 175 goto done; |
| 176 | |
| 177 s2[tok_count] = beg; | |
| 178 char *end; | |
| 526 | 179 while ((end = strchr (beg, ' ')) != 0) |
| 287 | 180 { |
| 181 *end = '\0'; | |
| 182 beg = end + 1; | |
| 183 | |
| 184 while (*beg == ' ') | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
185 beg++; |
| 287 | 186 |
| 187 if (*beg == '\0') | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
188 break; |
| 287 | 189 |
| 190 tok_count++; | |
| 191 if (tok_count >= max_toks) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
192 goto done; |
| 287 | 193 |
| 194 s2[tok_count] = beg; | |
| 195 } | |
| 526 | 196 s2[tok_count+1] = 0; |
| 287 | 197 |
| 198 s2 = to_match; | |
| 199 | |
| 200 for (;;) | |
| 201 { | |
| 202 if (! almost_match (*s1, *s2, min_len[toks_matched], 0)) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
203 goto done; |
| 287 | 204 |
| 205 toks_matched++; | |
| 206 | |
| 207 s1++; | |
| 208 s2++; | |
| 209 | |
| 210 if (! *s2) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
211 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
212 status = (toks_matched >= min_toks_to_match); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
213 goto done; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
214 } |
| 287 | 215 |
| 216 if (! *s1) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
217 goto done; |
| 287 | 218 } |
| 219 | |
| 220 done: | |
| 221 | |
| 222 delete [] kw; | |
| 223 delete [] to_match; | |
| 224 | |
| 225 return status; | |
| 1 | 226 } |
| 227 | |
| 2234 | 228 // Return non-zero if either NR or NC is zero. Return -1 if this |
| 229 // should be considered fatal; return 1 if this is ok. | |
| 230 | |
| 231 int | |
| 5275 | 232 empty_arg (const char * /* name */, octave_idx_type nr, octave_idx_type nc) |
| 2234 | 233 { |
| 4478 | 234 return (nr == 0 || nc == 0); |
| 2234 | 235 } |
| 236 | |
| 581 | 237 // See if the given file is in the path. |
| 238 | |
| 3536 | 239 std::string |
| 4243 | 240 search_path_for_file (const std::string& path, const string_vector& names) |
| 686 | 241 { |
| 3174 | 242 dir_path p (path); |
| 686 | 243 |
| 10250 | 244 return octave_env::make_absolute (p.find_first_of (names)); |
| 686 | 245 } |
| 246 | |
| 4216 | 247 // Find all locations of the given file in the path. |
| 248 | |
| 249 string_vector | |
| 4243 | 250 search_path_for_all_files (const std::string& path, const string_vector& names) |
| 4216 | 251 { |
| 252 dir_path p (path); | |
| 253 | |
| 4243 | 254 string_vector sv = p.find_all_first_of (names); |
| 4216 | 255 |
| 6379 | 256 octave_idx_type len = sv.length (); |
| 4216 | 257 |
| 6379 | 258 for (octave_idx_type i = 0; i < len; i++) |
| 10250 | 259 sv[i] = octave_env::make_absolute (sv[i]); |
| 4216 | 260 |
| 261 return sv; | |
| 262 } | |
| 263 | |
| 264 static string_vector | |
| 265 make_absolute (const string_vector& sv) | |
| 266 { | |
| 6379 | 267 octave_idx_type len = sv.length (); |
| 268 | |
| 269 string_vector retval (len); | |
| 4216 | 270 |
| 6379 | 271 for (octave_idx_type i = 0; i < len; i++) |
| 10250 | 272 retval[i] = octave_env::make_absolute (sv[i]); |
| 6379 | 273 |
| 274 return retval; | |
| 4216 | 275 } |
| 276 | |
| 3195 | 277 DEFUN (file_in_loadpath, args, , |
| 3446 | 278 "-*- texinfo -*-\n\ |
| 10840 | 279 @deftypefn {Built-in Function} {} file_in_loadpath (@var{file})\n\ |
| 4216 | 280 @deftypefnx {Built-in Function} {} file_in_loadpath (@var{file}, \"all\")\n\ |
| 3195 | 281 \n\ |
| 5448 | 282 Return the absolute name of @var{file} if it can be found in\n\ |
| 5814 | 283 the list of directories specified by @code{path}.\n\ |
|
10646
6c50b56824aa
file_in_path, file_in_loadpath: return empty string instead of empty matrix if file not found
John W. Eaton <jwe@octave.org>
parents:
10613
diff
changeset
|
284 If no file is found, return an empty character string.\n\ |
| 4216 | 285 \n\ |
| 5448 | 286 If the first argument is a cell array of strings, search each\n\ |
| 4243 | 287 directory of the loadpath for element of the cell array and return\n\ |
| 288 the first that matches.\n\ | |
| 289 \n\ | |
| 4216 | 290 If the second optional argument @code{\"all\"} is supplied, return\n\ |
| 291 a cell array containing the list of all files that have the same\n\ | |
| 292 name in the path. If no files are found, return an empty cell array.\n\ | |
| 5814 | 293 @seealso{file_in_path, path}\n\ |
| 5642 | 294 @end deftypefn") |
| 3195 | 295 { |
| 4216 | 296 octave_value retval; |
| 3195 | 297 |
| 4243 | 298 int nargin = args.length (); |
| 3195 | 299 |
| 4243 | 300 if (nargin == 1 || nargin == 2) |
| 4216 | 301 { |
| 4243 | 302 string_vector names = args(0).all_strings (); |
| 303 | |
| 304 if (! error_state && names.length () > 0) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
305 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
306 if (nargin == 1) |
|
10646
6c50b56824aa
file_in_path, file_in_loadpath: return empty string instead of empty matrix if file not found
John W. Eaton <jwe@octave.org>
parents:
10613
diff
changeset
|
307 retval = octave_env::make_absolute (load_path::find_first_of (names)); |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
308 else if (nargin == 2) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
309 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
310 std::string opt = args(1).string_value (); |
| 4243 | 311 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
312 if (! error_state && opt == "all") |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
313 retval = Cell (make_absolute |
| 10250 | 314 (load_path::find_all_first_of (names))); |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
315 else |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
316 error ("file_in_loadpath: invalid option"); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
317 } |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
318 } |
| 4216 | 319 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
320 error ("file_in_loadpath: expecting string as first argument"); |
| 4216 | 321 } |
| 3195 | 322 else |
| 5823 | 323 print_usage (); |
| 3195 | 324 |
| 325 return retval; | |
| 326 } | |
| 327 | |
| 1957 | 328 DEFUN (file_in_path, args, , |
| 3301 | 329 "-*- texinfo -*-\n\ |
| 10840 | 330 @deftypefn {Built-in Function} {} file_in_path (@var{path}, @var{file})\n\ |
| 4216 | 331 @deftypefnx {Built-in Function} {} file_in_path (@var{path}, @var{file}, \"all\")\n\ |
| 5448 | 332 Return the absolute name of @var{file} if it can be found in\n\ |
| 3301 | 333 @var{path}. The value of @var{path} should be a colon-separated list of\n\ |
| 5814 | 334 directories in the format described for @code{path}. If no file\n\ |
| 10840 | 335 is found, return an empty character string. For example:\n\ |
| 3301 | 336 \n\ |
| 337 @example\n\ | |
|
9064
7c02ec148a3c
Check grammar on all .cc files
Rik <rdrider0-list@yahoo.com>
parents:
8929
diff
changeset
|
338 @group\n\ |
| 5456 | 339 file_in_path (EXEC_PATH, \"sh\")\n\ |
| 340 @result{} \"/bin/sh\"\n\ | |
|
9064
7c02ec148a3c
Check grammar on all .cc files
Rik <rdrider0-list@yahoo.com>
parents:
8929
diff
changeset
|
341 @end group\n\ |
| 3301 | 342 @end example\n\ |
| 4216 | 343 \n\ |
| 5448 | 344 If the second argument is a cell array of strings, search each\n\ |
| 4243 | 345 directory of the path for element of the cell array and return\n\ |
| 346 the first that matches.\n\ | |
| 347 \n\ | |
| 4216 | 348 If the third optional argument @code{\"all\"} is supplied, return\n\ |
| 349 a cell array containing the list of all files that have the same\n\ | |
| 350 name in the path. If no files are found, return an empty cell array.\n\ | |
| 4249 | 351 @seealso{file_in_loadpath}\n\ |
| 3301 | 352 @end deftypefn") |
| 686 | 353 { |
| 4216 | 354 octave_value retval; |
| 686 | 355 |
| 4243 | 356 int nargin = args.length (); |
| 1755 | 357 |
| 4243 | 358 if (nargin == 2 || nargin == 3) |
| 686 | 359 { |
| 4243 | 360 std::string path = args(0).string_value (); |
| 361 | |
| 362 if (! error_state) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
363 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
364 string_vector names = args(1).all_strings (); |
| 4243 | 365 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
366 if (! error_state && names.length () > 0) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
367 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
368 if (nargin == 2) |
|
10646
6c50b56824aa
file_in_path, file_in_loadpath: return empty string instead of empty matrix if file not found
John W. Eaton <jwe@octave.org>
parents:
10613
diff
changeset
|
369 retval = search_path_for_file (path, names); |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
370 else if (nargin == 3) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
371 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
372 std::string opt = args(2).string_value (); |
| 4243 | 373 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
374 if (! error_state && opt == "all") |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
375 retval = Cell (make_absolute |
| 10250 | 376 (search_path_for_all_files (path, names))); |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
377 else |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
378 error ("file_in_path: invalid option"); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
379 } |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
380 } |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
381 else |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
382 error ("file_in_path: expecting string as second argument"); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
383 } |
| 1755 | 384 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
385 error ("file_in_path: expecting string as first argument"); |
| 686 | 386 } |
| 387 else | |
| 5823 | 388 print_usage (); |
| 686 | 389 |
| 390 return retval; | |
| 391 } | |
| 392 | |
| 3536 | 393 std::string |
| 3523 | 394 file_in_path (const std::string& name, const std::string& suffix) |
| 526 | 395 { |
| 3523 | 396 std::string nm = name; |
| 526 | 397 |
| 1755 | 398 if (! suffix.empty ()) |
| 399 nm.append (suffix); | |
| 686 | 400 |
| 10250 | 401 return octave_env::make_absolute (load_path::find_file (nm)); |
| 526 | 402 } |
| 403 | |
| 581 | 404 // See if there is an function file in the path. If so, return the |
| 405 // full path to the file. | |
| 406 | |
| 3536 | 407 std::string |
| 3523 | 408 fcn_file_in_path (const std::string& name) |
| 526 | 409 { |
| 3523 | 410 std::string retval; |
| 908 | 411 |
| 1755 | 412 int len = name.length (); |
| 413 | |
| 414 if (len > 0) | |
| 415 { | |
| 5832 | 416 if (octave_env::absolute_pathname (name)) |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
417 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
418 file_stat fs (name); |
| 5832 | 419 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
420 if (fs.exists ()) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
421 retval = name; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
422 } |
| 5832 | 423 else if (len > 2 && name [len - 2] == '.' && name [len - 1] == 'm') |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
424 retval = load_path::find_fcn_file (name.substr (0, len-2)); |
| 908 | 425 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
426 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
427 std::string fname = name; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
428 size_t pos = name.find_first_of (Vfilemarker); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
429 if (pos != std::string::npos) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
430 fname = name.substr (0, pos); |
|
7818
5640a70cbab1
Add Ffilemarker and fix for 'dbstep in'
David Bateman <dbateman@free.fr>
parents:
7789
diff
changeset
|
431 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
432 retval = load_path::find_fcn_file (fname); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
433 } |
| 908 | 434 } |
| 1755 | 435 |
| 436 return retval; | |
| 526 | 437 } |
| 438 | |
|
8041
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
439 // See if there is a directory called "name" in the path and if it |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
440 // contains a Contents.m file return the full path to this file. |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
441 |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
442 std::string |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
443 contents_file_in_path (const std::string& dir) |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
444 { |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
445 std::string retval; |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
446 |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
447 if (dir.length () > 0) |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
448 { |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
449 std::string tcontents = file_ops::concat (load_path::find_dir (dir), |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
450 std::string ("Contents.m")); |
|
8041
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
451 |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
452 file_stat fs (tcontents); |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
453 |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
454 if (fs.exists ()) |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
455 retval = octave_env::make_absolute (tcontents); |
|
8041
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
456 } |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
457 |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
458 return retval; |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
459 } |
|
a14bdf90be55
Add a search for Contents.m files to the help function
David Bateman <dbateman@free.fr>
parents:
8021
diff
changeset
|
460 |
| 5864 | 461 // See if there is a .oct file in the path. If so, return the |
| 581 | 462 // full path to the file. |
| 463 | |
| 3536 | 464 std::string |
| 3523 | 465 oct_file_in_path (const std::string& name) |
| 572 | 466 { |
| 3523 | 467 std::string retval; |
| 908 | 468 |
| 1755 | 469 int len = name.length (); |
| 470 | |
| 471 if (len > 0) | |
| 472 { | |
| 5832 | 473 if (octave_env::absolute_pathname (name)) |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
474 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
475 file_stat fs (name); |
| 5832 | 476 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
477 if (fs.exists ()) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
478 retval = name; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
479 } |
| 5832 | 480 else if (len > 4 && name [len - 4] == '.' && name [len - 3] == 'o' |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
481 && name [len - 2] == 'c' && name [len - 1] == 't') |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
482 retval = load_path::find_oct_file (name.substr (0, len-4)); |
| 908 | 483 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
484 retval = load_path::find_oct_file (name); |
| 908 | 485 } |
| 1755 | 486 |
| 487 return retval; | |
| 572 | 488 } |
| 489 | |
| 5864 | 490 // See if there is a .mex file in the path. If so, return the |
| 491 // full path to the file. | |
| 492 | |
| 493 std::string | |
| 494 mex_file_in_path (const std::string& name) | |
| 495 { | |
| 496 std::string retval; | |
| 497 | |
| 498 int len = name.length (); | |
| 499 | |
| 500 if (len > 0) | |
| 501 { | |
| 502 if (octave_env::absolute_pathname (name)) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
503 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
504 file_stat fs (name); |
| 5864 | 505 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
506 if (fs.exists ()) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
507 retval = name; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
508 } |
| 5864 | 509 else if (len > 4 && name [len - 4] == '.' && name [len - 3] == 'm' |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
510 && name [len - 2] == 'e' && name [len - 1] == 'x') |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
511 retval = load_path::find_mex_file (name.substr (0, len-4)); |
| 5864 | 512 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
513 retval = load_path::find_mex_file (name); |
| 5864 | 514 } |
| 515 | |
| 516 return retval; | |
| 517 } | |
| 518 | |
| 3103 | 519 // Replace backslash escapes in a string with the real values. |
| 520 | |
| 3536 | 521 std::string |
| 3523 | 522 do_string_escapes (const std::string& s) |
| 3103 | 523 { |
| 3523 | 524 std::string retval; |
| 3103 | 525 |
| 526 size_t i = 0; | |
| 527 size_t j = 0; | |
| 528 size_t len = s.length (); | |
| 529 | |
| 530 retval.resize (len); | |
| 531 | |
| 532 while (j < len) | |
| 533 { | |
| 534 if (s[j] == '\\' && j+1 < len) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
535 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
536 switch (s[++j]) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
537 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
538 case '0': |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
539 retval[i] = '\0'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
540 break; |
| 3893 | 541 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
542 case 'a': |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
543 retval[i] = '\a'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
544 break; |
| 3103 | 545 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
546 case 'b': // backspace |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
547 retval[i] = '\b'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
548 break; |
| 3103 | 549 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
550 case 'f': // formfeed |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
551 retval[i] = '\f'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
552 break; |
| 3103 | 553 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
554 case 'n': // newline |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
555 retval[i] = '\n'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
556 break; |
| 3103 | 557 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
558 case 'r': // carriage return |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
559 retval[i] = '\r'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
560 break; |
| 3103 | 561 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
562 case 't': // horizontal tab |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
563 retval[i] = '\t'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
564 break; |
| 3103 | 565 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
566 case 'v': // vertical tab |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
567 retval[i] = '\v'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
568 break; |
| 3103 | 569 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
570 case '\\': // backslash |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
571 retval[i] = '\\'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
572 break; |
| 3103 | 573 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
574 case '\'': // quote |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
575 retval[i] = '\''; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
576 break; |
| 3103 | 577 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
578 case '"': // double quote |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
579 retval[i] = '"'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
580 break; |
| 3103 | 581 |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
582 default: |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
583 warning ("unrecognized escape sequence `\\%c' --\ |
| 3103 | 584 converting to `%c'", s[j], s[j]); |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
585 retval[i] = s[j]; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
586 break; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
587 } |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
588 } |
| 3103 | 589 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
590 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
591 retval[i] = s[j]; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
592 } |
| 3103 | 593 |
| 594 i++; | |
| 595 j++; | |
| 596 } | |
| 597 | |
| 3105 | 598 retval.resize (i); |
| 3103 | 599 |
| 600 return retval; | |
| 601 } | |
| 602 | |
| 603 DEFUN (do_string_escapes, args, , | |
| 3446 | 604 "-*- texinfo -*-\n\ |
| 605 @deftypefn {Built-in Function} {} do_string_escapes (@var{string})\n\ | |
| 606 Convert special characters in @var{string} to their escaped forms.\n\ | |
| 607 @end deftypefn") | |
| 3103 | 608 { |
| 609 octave_value retval; | |
| 610 | |
| 611 int nargin = args.length (); | |
| 612 | |
| 613 if (nargin == 1) | |
| 614 { | |
| 615 if (args(0).is_string ()) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
616 retval = do_string_escapes (args(0).string_value ()); |
| 3103 | 617 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
618 error ("do_string_escapes: argument must be a string"); |
| 3103 | 619 } |
| 620 else | |
| 5823 | 621 print_usage (); |
| 3103 | 622 |
| 623 return retval; | |
| 624 } | |
| 625 | |
| 1755 | 626 const char * |
| 801 | 627 undo_string_escape (char c) |
| 628 { | |
| 629 if (! c) | |
| 1755 | 630 return ""; |
| 801 | 631 |
| 632 switch (c) | |
| 633 { | |
| 3893 | 634 case '\0': |
| 635 return "\\0"; | |
| 636 | |
| 801 | 637 case '\a': |
| 638 return "\\a"; | |
| 639 | |
| 640 case '\b': // backspace | |
| 641 return "\\b"; | |
| 642 | |
| 643 case '\f': // formfeed | |
| 644 return "\\f"; | |
| 645 | |
| 646 case '\n': // newline | |
| 647 return "\\n"; | |
| 648 | |
| 649 case '\r': // carriage return | |
| 650 return "\\r"; | |
| 651 | |
| 652 case '\t': // horizontal tab | |
| 653 return "\\t"; | |
| 654 | |
| 655 case '\v': // vertical tab | |
| 656 return "\\v"; | |
| 657 | |
| 658 case '\\': // backslash | |
| 659 return "\\\\"; | |
| 660 | |
| 661 case '"': // double quote | |
| 662 return "\\\""; | |
| 663 | |
| 664 default: | |
| 1755 | 665 { |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
666 static char retval[2]; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
667 retval[0] = c; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
668 retval[1] = '\0'; |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
669 return retval; |
| 1755 | 670 } |
| 801 | 671 } |
| 672 } | |
| 673 | |
| 3536 | 674 std::string |
| 3523 | 675 undo_string_escapes (const std::string& s) |
| 801 | 676 { |
| 3523 | 677 std::string retval; |
| 801 | 678 |
| 1755 | 679 for (size_t i = 0; i < s.length (); i++) |
| 680 retval.append (undo_string_escape (s[i])); | |
| 801 | 681 |
| 1755 | 682 return retval; |
| 801 | 683 } |
| 684 | |
| 1957 | 685 DEFUN (undo_string_escapes, args, , |
| 3361 | 686 "-*- texinfo -*-\n\ |
| 687 @deftypefn {Built-in Function} {} undo_string_escapes (@var{s})\n\ | |
| 688 Converts special characters in strings back to their escaped forms. For\n\ | |
| 689 example, the expression\n\ | |
| 690 \n\ | |
| 691 @example\n\ | |
| 692 bell = \"\\a\";\n\ | |
| 693 @end example\n\ | |
| 694 \n\ | |
| 695 @noindent\n\ | |
| 696 assigns the value of the alert character (control-g, ASCII code 7) to\n\ | |
| 697 the string variable @code{bell}. If this string is printed, the\n\ | |
| 698 system will ring the terminal bell (if it is possible). This is\n\ | |
| 699 normally the desired outcome. However, sometimes it is useful to be\n\ | |
| 700 able to print the original representation of the string, with the\n\ | |
| 701 special characters replaced by their escape sequences. For example,\n\ | |
| 702 \n\ | |
| 703 @example\n\ | |
|
9064
7c02ec148a3c
Check grammar on all .cc files
Rik <rdrider0-list@yahoo.com>
parents:
8929
diff
changeset
|
704 @group\n\ |
| 3361 | 705 octave:13> undo_string_escapes (bell)\n\ |
| 706 ans = \\a\n\ | |
|
9064
7c02ec148a3c
Check grammar on all .cc files
Rik <rdrider0-list@yahoo.com>
parents:
8929
diff
changeset
|
707 @end group\n\ |
| 3361 | 708 @end example\n\ |
| 709 \n\ | |
| 710 @noindent\n\ | |
| 711 replaces the unprintable alert character with its printable\n\ | |
| 712 representation.\n\ | |
| 713 @end deftypefn") | |
| 801 | 714 { |
| 2086 | 715 octave_value retval; |
| 801 | 716 |
| 717 int nargin = args.length (); | |
| 718 | |
| 3103 | 719 if (nargin == 1) |
| 720 { | |
| 721 if (args(0).is_string ()) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
722 retval = undo_string_escapes (args(0).string_value ()); |
| 3103 | 723 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
724 error ("undo_string_escapes: argument must be a string"); |
| 3103 | 725 } |
| 801 | 726 else |
| 5823 | 727 print_usage (); |
| 801 | 728 |
| 729 return retval; | |
| 730 } | |
| 731 | |
| 8229 | 732 DEFUN (is_absolute_filename, args, , |
| 733 "-*- texinfo -*-\n\ | |
| 734 @deftypefn {Built-in Function} {} is_absolute_filename (@var{file})\n\ | |
| 735 Return true if @var{file} is an absolute filename.\n\ | |
|
11431
0d9640d755b1
Improve docstrings for all isXXX functions.
Rik <octave@nomad.inbox5.com>
parents:
11066
diff
changeset
|
736 @seealso{is_rooted_relative_filename, make_absolute_filename, isdir}\n\ |
| 8229 | 737 @end deftypefn") |
| 738 { | |
| 739 octave_value retval = false; | |
| 740 | |
| 741 if (args.length () == 1) | |
| 742 retval = (args(0).is_string () | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
743 && octave_env::absolute_pathname (args(0).string_value ())); |
| 8229 | 744 else |
| 745 print_usage (); | |
| 746 | |
| 747 return retval; | |
| 748 } | |
| 749 | |
| 750 DEFUN (is_rooted_relative_filename, args, , | |
| 751 "-*- texinfo -*-\n\ | |
| 752 @deftypefn {Built-in Function} {} is_rooted_relative_filename (@var{file})\n\ | |
| 753 Return true if @var{file} is a rooted-relative filename.\n\ | |
|
11431
0d9640d755b1
Improve docstrings for all isXXX functions.
Rik <octave@nomad.inbox5.com>
parents:
11066
diff
changeset
|
754 @seealso{is_absolute_filename, make_absolute_filename, isdir}\n\ |
| 8229 | 755 @end deftypefn") |
| 756 { | |
| 757 octave_value retval = false; | |
| 758 | |
| 759 if (args.length () == 1) | |
| 760 retval = (args(0).is_string () | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
761 && octave_env::rooted_relative_pathname (args(0).string_value ())); |
| 8229 | 762 else |
| 763 print_usage (); | |
| 764 | |
| 765 return retval; | |
| 766 } | |
| 767 | |
| 768 DEFUN (make_absolute_filename, args, , | |
| 769 "-*- texinfo -*-\n\ | |
| 770 @deftypefn {Built-in Function} {} make_absolute_filename (@var{file})\n\ | |
| 771 Return the full name of @var{file}, relative to the current directory.\n\ | |
| 772 @end deftypefn") | |
| 773 { | |
| 774 octave_value retval = std::string (); | |
| 775 | |
| 776 if (args.length () == 1) | |
| 777 { | |
| 778 std::string nm = args(0).string_value (); | |
| 779 | |
| 780 if (! error_state) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
781 retval = octave_env::make_absolute (nm); |
| 8229 | 782 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
783 error ("make_absolute_filename: expecting argument to be a file name"); |
| 8229 | 784 } |
| 785 else | |
| 786 print_usage (); | |
| 787 | |
| 788 return retval; | |
| 789 } | |
| 790 | |
| 791 DEFUN (find_dir_in_path, args, , | |
| 792 "-*- texinfo -*-\n\ | |
|
9806
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
793 @deftypefn {Built-in Function} {} find_dir_in_path (@var{dir}, \"all\")\n\ |
| 8229 | 794 Return the full name of the path element matching @var{dir}. The\n\ |
| 795 match is performed at the end of each path element. For example, if\n\ | |
| 796 @var{dir} is @code{\"foo/bar\"}, it matches the path element\n\ | |
| 797 @code{\"/some/dir/foo/bar\"}, but not @code{\"/some/dir/foo/bar/baz\"}\n\ | |
| 8715 | 798 or @code{\"/some/dir/allfoo/bar\"}.\n\ |
|
9806
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
799 \n\ |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
800 The second argument is optional. If it is supplied, return a cell array\n\ |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
801 containing all the directory names that match.\n\ |
| 8229 | 802 @end deftypefn") |
| 803 { | |
| 804 octave_value retval = std::string (); | |
| 805 | |
|
9806
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
806 int nargin = args.length (); |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
807 |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
808 std::string dir; |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
809 |
|
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
810 if (nargin == 1 || nargin == 2) |
| 8229 | 811 { |
|
9806
8e345f2fe4d6
improved support for Contents.m files
John W. Eaton <jwe@octave.org>
parents:
9758
diff
changeset
|
812 dir = args(0).string_value (); |
| 8229 | 813 |
| 814 if (! error_state) | |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
815 { |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
816 if (nargin == 1) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
817 retval = load_path::find_dir (dir); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
818 else if (nargin == 2) |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
819 retval = Cell (load_path::find_matching_dirs (dir)); |
|
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
820 } |
| 8229 | 821 else |
|
10315
57a59eae83cc
untabify src C++ source files
John W. Eaton <jwe@octave.org>
parents:
10257
diff
changeset
|
822 error ("find_dir_in_path: expecting argument to be a directory name"); |
| 8229 | 823 } |
| 824 else | |
| 825 print_usage (); | |
| 826 | |
|
1bf51192fa1d
imported patch rundemos
John W. Eaton <jwe@octave.org> |