|
3035
|
1 Summary of changes for version 2.1.x: |
|
2993
|
2 ------------------------------------ |
|
|
3 |
|
2977
|
4 * Octave's expression parser is more general and consistent. It is |
|
|
5 now possible to access structure elements and index arbitrary |
|
|
6 values. For example, expressions like |
|
|
7 |
|
|
8 my_home_dir = getpwuid (getuid ()) . dir; |
|
|
9 |
|
|
10 and |
|
|
11 |
|
|
12 svd (x) (1:5) |
|
|
13 |
|
|
14 now work. |
|
|
15 |
|
2958
|
16 * New built-in variable `print_rhs_assign_val' controls what is |
|
|
17 printed when an assignment expression is evaluated. If it is |
|
|
18 zero, the value of the variable on the left hand side (after the |
|
2983
|
19 assignment) is printed. If it is nonzero, the value of the right |
|
|
20 hand side (i.e., the result of the expression) is printed. The |
|
|
21 default value of is zero, so the behavior is the same as in |
|
|
22 previous versions of Octave. |
|
2958
|
23 |
|
2938
|
24 * tmpnam now takes two optional arguments, DIR, and PREFIX. For |
|
|
25 example, tmpnam ("/foo", "bar-") returns a file name like |
|
|
26 "/foo/bar-10773baa". If DIR is omitted or empty, the value of the |
|
|
27 environment variable TMPDIR, or /tmp is used. If PREFIX is |
|
|
28 omitted, "oct-" is used. |
|
|
29 |
|
2958
|
30 * The built-in variable `PWD' has been removed. If you need to get |
|
2930
|
31 the value of the current working directory, use the pwd() function |
|
|
32 instead. |
|
|
33 |
|
2918
|
34 * New operators. Octave's parser now recognizes the following |
|
|
35 operators: << >> += -= *= /= .+= .-= .*= ./= &= |= <<= >>=. So |
|
|
36 far, there are only a few operations defined that actually use |
|
|
37 them (this should change before 2.1 is released). |
|
|
38 |
|
|
39 * New built-in data types: |
|
|
40 |
|
|
41 logical: |
|
|
42 |
|
|
43 A true value is represented by 1, and false value by 0. |
|
|
44 Comparison operations like <, <=, ==, >, >=, and != now return |
|
|
45 logical values. Indexing operations that use zero-one style |
|
|
46 indexing must now use logical values. You can use the new |
|
|
47 function logical() to convert a numeric value to a logical |
|
|
48 value. This avoids the need for the built-in variable |
|
|
49 `prefer_zero_one_indexing', so it has been removed. Logical |
|
|
50 values are automatically converted to numeric values where |
|
|
51 appropriate. |
|
|
52 |
|
|
53 file: |
|
|
54 |
|
|
55 A file object represents an open Octave stream object. The |
|
|
56 fopen function now returns a file object instead of an integer. |
|
|
57 File objects can be converted to integers automatically, and the |
|
|
58 other functions that work with file ids still work with |
|
|
59 integers, so this change should be backward compatible. |
|
|
60 |
|
|
61 The binary left-shift operator `<<' has been defined to work as |
|
|
62 in C++ for file objects and built-in types. For example, |
|
|
63 |
|
|
64 my_stream = fopen ("foo", "w"); |
|
|
65 my_stream << "x = " << pi << " marks the spot\n"; |
|
|
66 |
|
2922
|
67 writes `x = 3.1416 marks the spot' in the file foo. |
|
2918
|
68 |
|
|
69 The built-in variables stdin, stdout, and stderr are now also |
|
|
70 file objects instead of integers. |
|
|
71 |
|
|
72 list: |
|
|
73 |
|
|
74 A list is an array of Octave objects. It can be indexed using |
|
|
75 the normal indexing operator. For example, |
|
|
76 |
|
2993
|
77 x = list ([1,2;3,4], 1, "foo"); |
|
2918
|
78 stdout << x(2) << "\n" |
|
|
79 1 |
|
|
80 stdout << x; |
|
|
81 ( |
|
|
82 [1] = |
|
|
83 |
|
|
84 1 2 |
|
|
85 3 4 |
|
|
86 |
|
|
87 [2] = 1 |
|
|
88 [3] = foo |
|
|
89 ) |
|
|
90 |
|
|
91 There is currently no special syntax for creating lists; you |
|
2993
|
92 must use the list function. |
|
2845
|
93 |
|
2852
|
94 * Commas in global statements are no longer special. They are now |
|
|
95 treated as command separators. This removes a conflict in the |
|
2853
|
96 grammar and is consistent with the way Matlab behaves. The |
|
|
97 variable `warn_comma_in_global_decl' has been eliminated. |
|
2852
|
98 |
|
2845
|
99 * It is now possible to declare static variables that retain their |
|
|
100 values across function calls. For example, |
|
|
101 |
|
|
102 function ncall = f () static n = 0; ncall = ++n; endfunction |
|
|
103 |
|
|
104 defines a function that returns the number of times that it has |
|
|
105 been called. |
|
2800
|
106 |
|
2944
|
107 * Within user-defined functions, the new automatic variable `argn' |
|
|
108 contains the names of the arguments that were passed to the |
|
|
109 function. For example, |
|
|
110 |
|
|
111 function f (...) |
|
|
112 for i = 1:nargin |
|
|
113 stdout << "argn(" << i << ") = `" << deblank (argn(i,:)) \ |
|
|
114 << "' and its value is " << va_arg () << "\n"; |
|
|
115 endfor |
|
|
116 endfunction |
|
|
117 f (1+2, "foo", sin (pi/2)) |
|
|
118 |
|
|
119 prints |
|
|
120 |
|
|
121 argn(1) = `1 + 2' and its value is 3 |
|
|
122 argn(2) = `"foo"' and its value is foo |
|
|
123 argn(3) = `sin (pi)' and its value is 1 |
|
|
124 |
|
|
125 on the standard output stream. If nargin is zero, argn is not defined. |
|
2800
|
126 * Functions like quad, fsolve, and lsode can take either a function |
|
|
127 name or a simple function body as a string. For example, |
|
|
128 |
|
|
129 quad ("sqrt (x)", 0, 1) |
|
|
130 |
|
|
131 is equivalent to |
|
|
132 |
|
|
133 function y = f (x) y = sqrt (x); endfunction |
|
|
134 quad ("f", 0, 1) |
|
|
135 |
|
2815
|
136 * If the argument to eig() is symmetric, Octave uses the specialized |
|
|
137 Lapack subroutine for symmetric matrices for a significant |
|
|
138 increase in performance. |
|
|
139 |
|
2851
|
140 * If the argument to lsode that names the user-supplied function is |
|
|
141 a 2-element string array, the second element is taken as the name |
|
|
142 of the Jacobian function. The named function should have the |
|
|
143 following form: |
|
|
144 |
|
|
145 JAC = f (X, T) |
|
|
146 |
|
|
147 where JAC is the Jacobian matrix of partial derivatives of the |
|
|
148 right-hand-side functions that define the set of differential |
|
|
149 equations with respect to the state vector X. |
|
|
150 |
|
3107
|
151 * Global variables are now initialized to the empty matrix, for |
|
|
152 compatibility with Matlab. |
|
|
153 |
|
|
154 * Explicit initialization of global variables only happens once. |
|
|
155 For example, after the following statements are evaluated, g still |
|
|
156 has the value 1. |
|
|
157 |
|
|
158 global g = 1 |
|
|
159 global g = 2 |
|
|
160 |
|
|
161 This is useful for initializing global variables that are used to |
|
|
162 maintain state information that is shared among several functions. |
|
|
163 |
|
2930
|
164 * Structure elements completion on the command line actually works |
|
|
165 now. |
|
|
166 |
|
3105
|
167 * The new built-in variable `fixed_point_format' controls whether |
|
|
168 Octave uses a scaled fixed-point format for displaying matrices. |
|
|
169 The default value is 0 unless you use --traditional. |
|
|
170 |
|
|
171 * The function sumsq now computes sum (x .* conj (x)) for complex values. |
|
|
172 |
|
2930
|
173 * New configure option, --enable-readline. |
|
|
174 |
|
3035
|
175 * New configure option, --enable-static. |
|
|
176 |
|
|
177 Summary of changes for version 2.0.7: |
|
|
178 ------------------------------------ |
|
|
179 |
|
|
180 This is a bug-fixing release. There are no new user-visible features. |
|
|
181 |
|
|
182 Summary of changes for version 2.0.6: |
|
|
183 ------------------------------------ |
|
|
184 |
|
|
185 This is primarily a bug-fixing release. There are only a few new |
|
|
186 user-visible features. |
|
|
187 |
|
|
188 * The new built-in variable default_eval_print_flag controls whether |
|
|
189 Octave prints the results of commands executed by eval() that do |
|
|
190 not end with semicolons. The default is 1. |
|
|
191 |
|
|
192 * The new built-in constant OCTAVE_HOME specifies the top-level |
|
|
193 directory where Octave is installed. |
|
|
194 |
|
|
195 * Octave no longer includes functions to work with NPSOL or QPSOL, |
|
|
196 because they are not free software. |
|
|
197 |
|
2745
|
198 Summary of changes for version 2.0.5: |
|
|
199 ------------------------------------ |
|
|
200 |
|
2767
|
201 * A `switch' statement is now available. See the Statements chapter |
|
|
202 in the manual for details. |
|
|
203 |
|
2745
|
204 * Commands like ls, save, and cd may now also be used as formal |
|
|
205 parameters for functions. |
|
|
206 |
|
|
207 * More tests. |
|
|
208 |
|
2702
|
209 Summary of changes for version 2.0.4: |
|
|
210 ------------------------------------ |
|
|
211 |
|
|
212 * It is now possible to use commands like ls, save, and cd as simple |
|
|
213 variable names. They still cannot be used as formal parameters |
|
|
214 for functions, or as the names of structure variables. Failed |
|
|
215 assignments leave them undefined (you can recover the orginal |
|
2704
|
216 function definition using clear). |
|
|
217 |
|
|
218 * Is is now possible to invoke commands like ls, save, and cd as |
|
|
219 normal functions (for example, load ("foo", "x", "y", "z")). |
|
2702
|
220 |
|
2666
|
221 Summary of changes for version 2.0.3: |
|
|
222 ------------------------------------ |
|
|
223 |
|
|
224 * The manual has been completely revised and now corresponds much |
|
|
225 more closely to the features of the current version. |
|
|
226 |
|
|
227 * The return value for assignment expressions is now the RHS since |
|
|
228 that is more consistent with the way other programming languages |
|
|
229 work. However, Octave still prints the entire LHS value so that |
|
|
230 |
|
|
231 x = zeros (1, 2); |
|
|
232 x(2) = 1 |
|
|
233 |
|
|
234 still prints |
|
|
235 |
|
|
236 x = |
|
|
237 |
|
|
238 0 1 |
|
|
239 |
|
|
240 but an assignment like |
|
|
241 |
|
|
242 z = x(2) = 1 |
|
|
243 |
|
|
244 sets z to 1 (not [ 0, 1 ] as in previous versions of Octave). |
|
|
245 |
|
2683
|
246 * It is now much easier to make binary distributions. See the |
|
|
247 Binary Distributions section of the manual for more details. |
|
|
248 |
|
2615
|
249 Summary of changes for version 2.0.2: |
|
2613
|
250 ------------------------------------ |
|
|
251 |
|
2621
|
252 * Octave now stops executing commands from a script file if an error |
|
|
253 is encountered. |
|
|
254 |
|
|
255 * The return, and break commands now cause Octave to quit executing |
|
|
256 commands from script files. When used in invalid contexts, the |
|
|
257 break, continue, and return commands are now simply ignored |
|
|
258 instead of producing parse errors. |
|
|
259 |
|
2613
|
260 * size ("") is now [0, 0]. |
|
|
261 |
|
2634
|
262 * New functions: |
|
|
263 |
|
|
264 sleep -- pause execution for a specified number of seconds |
|
|
265 usleep -- pause execution for a specified number of microseconds |
|
|
266 |
|
2452
|
267 Summary of changes for version 2.0: |
|
|
268 ---------------------------------- |
|
|
269 |
|
2520
|
270 * The set and show commands for setting and displaying gnuplot |
|
|
271 parameters have been replaced by gset and gshow. This change will |
|
|
272 probably break lots of things, but it is necessary to allow for |
|
|
273 compatibility with the Matlab graphics and GUI commands in a |
|
|
274 future version of Octave. (For now, the old set and show commands |
|
|
275 do work, but they print an annoying warning message to try to get |
|
|
276 people to switch to using gset.) |
|
|
277 |
|
2581
|
278 * Octave has been mostly ported to Windows NT and Windows 95 using |
|
|
279 the beta 17 release of the Cygnus GNU-WIN32 tools. Not everything |
|
|
280 works, but it is usable. See the file README.WINDOWS for more |
|
|
281 information. |
|
|
282 |
|
2580
|
283 * Dynamic linking works on more systems using dlopen() and friends |
|
|
284 (most modern Unix systems) or shl_load() and friends (HP/UX |
|
|
285 systems). A simple example is provided in examples/hello.cc. |
|
|
286 For this feature to work, you must configure Octave with |
|
|
287 --enable-shared. You may also need to have a shared-library |
|
|
288 version of libg++ and libstdc++. |
|
|
289 |
|
2452
|
290 * New data types can be added to Octave by writing a C++ class. On |
|
|
291 systems that support dynamic linking, new data types can be added |
|
|
292 to an already running Octave binary. A simple example appears in |
|
|
293 the file examples/make_int.cc. Other examples are the standard |
|
|
294 Octave data types defined in the files src/ov*.{h,cc} and |
|
2580
|
295 src/op-*.cc. |
|
2452
|
296 |
|
|
297 * The configure option --enable-bounds-check turns on bounds |
|
|
298 checking on element references for Octave's internal array and |
|
|
299 matrix classes. It's enabled by default. To disable this |
|
|
300 feature, configure Octave with --disable-bounds-check. |
|
|
301 |
|
|
302 * The C-style I/O functions (fopen, fprintf, etc.) have been |
|
|
303 rewritten to be more compatible with Matlab. The fputs function |
|
|
304 has also been added. Usage of the *printf functions that was |
|
|
305 allowed in previous versions of Octave should still work. |
|
|
306 However, there is no way to make the new versions of the *scanf |
|
|
307 functions compatible with Matlab *and* previous versions of |
|
|
308 Octave. An optional argument to the *scanf functions is now |
|
|
309 available to make them behave in a way that is compatible with |
|
|
310 previous versions of Octave. |
|
|
311 |
|
2511
|
312 * Octave can now read files that contain columns of numbers only, |
|
|
313 with no header information. The name of the loaded variable is |
|
|
314 constructed from the file name. Each line in the file must have |
|
|
315 the same number of elements. |
|
|
316 |
|
2452
|
317 * The interface to the pager has changed. The new built-in variable |
|
|
318 `page_output_immediately' controls when Octave sends output to the |
|
|
319 pager. If it is nonzero, Octave sends output to the pager as soon |
|
|
320 as it is available. Otherwise, Octave buffers its output and |
|
|
321 waits until just before the prompt is printed to flush it to the |
|
|
322 pager. |
|
|
323 |
|
|
324 * Expressions of the form |
|
|
325 |
|
|
326 A(i,j) = x |
|
|
327 |
|
|
328 where X is a scalar and the indices i and j define a matrix of |
|
|
329 elements now work as you would expect rather than giving an error. |
|
|
330 I am told that this is how Matlab 5.0 will behave when it is |
|
|
331 released. |
|
|
332 |
|
|
333 * Indexing of character strings now works. |
|
|
334 |
|
|
335 * The echo command has been implemented. |
|
|
336 |
|
|
337 * The document command is now a regular function. |
|
|
338 |
|
|
339 * New method for handling errors: |
|
|
340 |
|
|
341 try |
|
|
342 BODY |
|
|
343 catch |
|
|
344 CLEANUP |
|
|
345 end_try_catch |
|
|
346 |
|
|
347 Where BODY and CLEANUP are both optional and may contain any |
|
|
348 Octave expressions or commands. The statements in CLEANUP are |
|
|
349 only executed if an error occurs in BODY. |
|
|
350 |
|
|
351 No warnings or error messages are printed while BODY is |
|
|
352 executing. If an error does occur during the execution of BODY, |
|
|
353 CLEANUP can access the text of the message that would have been |
|
|
354 printed in the builtin constant __error_text__. This is the same |
|
|
355 as eval (TRY, CATCH) (which may now also use __error_text__) but |
|
|
356 it is more efficient since the commands do not need to be parsed |
|
|
357 each time the TRY and CATCH statements are evaluated. |
|
|
358 |
|
|
359 * Octave no longer parses the help command by grabbing everything |
|
|
360 after the keyword `help' until a newline character is read. To |
|
|
361 get help for `;' or `,', now, you need to use the command |
|
|
362 `help semicolon' or `help comma'. |
|
|
363 |
|
|
364 * Octave's parser now does some simple constant folding. This means |
|
|
365 that expressions like 3*i are now evaluated only once, when a |
|
|
366 function is compiled, and the right hand side of expressions like |
|
|
367 a = [1,2;3,4] are treated as true matrix constants rather than |
|
|
368 lists of elements which must be evaluated each time they are |
|
|
369 needed. |
|
|
370 |
|
|
371 * Built-in variables that can take values of "true" and "false" can |
|
|
372 now also be set to any nonzero scalar value to indicate "true", |
|
|
373 and 0 to indicate "false". |
|
|
374 |
|
|
375 * New built-in variables `history_file', `history_size', and |
|
|
376 `saving_history'. |
|
|
377 |
|
|
378 * New built-in variable `string_fill_char' specifies the character |
|
|
379 to fill with when creating arrays of strings. |
|
|
380 |
|
|
381 * If the new built-in variable `gnuplot_has_frames' is nonzero, |
|
|
382 Octave assumes that your copy of gnuplot includes support for |
|
|
383 multiple plot windows when using X11. |
|
|
384 |
|
|
385 If the new built-in variable `gnuplot_has_multiplot' is nonzero, |
|
|
386 Octave assumes that your copy of gnuplot has the multiplot support |
|
|
387 that is included in recent 3.6beta releases. |
|
|
388 |
|
|
389 The initial values of these variables are determined by configure, |
|
|
390 but can be changed in your startup script or at the command line |
|
|
391 in case configure got it wrong, or if you upgrade your gnuplot |
|
|
392 installation. |
|
|
393 |
|
|
394 * The new plot function `figure' allows multiple plot windows when |
|
|
395 using newer versions of gnuplot with X11. |
|
|
396 |
|
|
397 * Octave now notices when the plotter has exited unexpectedly. |
|
|
398 |
|
|
399 * New built-in variable `warn_missing_semicolon'. If nonzero, Octave |
|
|
400 will warn when statements in function definitions don't end in |
|
|
401 semicolons. The default value is 0. |
|
|
402 |
|
|
403 * Octave now attempts to continue after floating point exceptions |
|
|
404 or out-of-memory errors. |
|
|
405 |
|
|
406 * If Octave crashes, it now attempts to save all user-defined |
|
|
407 variables in a file named `octave-core' in the current directory |
|
|
408 before exiting. |
|
|
409 |
|
|
410 * It is now possible to get the values of individual option settings |
|
|
411 for the dassl, fsolve, lsode, npsol, qpsol, and quad functions |
|
|
412 using commands like |
|
|
413 |
|
|
414 dassl_reltol = dassl_options ("relative tolerance"); |
|
|
415 |
|
|
416 * The svd() function no longer computes the left and right singular |
|
|
417 matrices unnecessarily. This can significantly improve |
|
|
418 performance for large matrices if you are just looking for the |
|
|
419 singular values. |
|
|
420 |
|
|
421 * The filter() function is now a built-in function. |
|
|
422 |
|
|
423 * New function randn() returns a pseudo-random number from a normal |
|
|
424 distribution. The rand() and randn() functions have separate |
|
|
425 seeds and generators. |
|
|
426 |
|
|
427 * Octave's command-line arguments are now available in the built-in |
|
|
428 variable `argv'. The program name is also available in the |
|
|
429 variables `program_invocation_name' and `program_name'. If |
|
|
430 executing a script from the command line (e.g., octave foo.m) or |
|
|
431 using the `#! /bin/octave' hack, the program name is set to the |
|
|
432 name of the script. |
|
|
433 |
|
|
434 * New built-in variable `completion_append_char' used as the |
|
|
435 character to append to successful command-line completion |
|
|
436 attempts. The default is " " (a single space). |
|
|
437 |
|
|
438 * Octave now uses a modified copy of the readline library from |
|
|
439 version 1.14.5 of GNU bash. |
|
|
440 |
|
|
441 * In prompt strings, `\H' expands to the whole host name. |
|
|
442 |
|
|
443 * New built-in variable `beep_on_error'. If nonzero, Octave will try |
|
|
444 to ring your terminal's bell before printing an error message. |
|
|
445 The default value is 0. |
|
|
446 |
|
2554
|
447 * For functions defined from files, the type command now prints the |
|
|
448 text of the file. You can still get the text reconstructed from |
|
|
449 the parse tree by using the new option -t (-transformed). |
|
|
450 |
|
2452
|
451 * New command-line argument --traditional sets the following |
|
|
452 preference variables for compatibility with Matlab: |
|
|
453 |
|
|
454 PS1 = ">> " |
|
|
455 PS2 = "" |
|
|
456 beep_on_error = 1 |
|
|
457 default_save_format = "mat-binary" |
|
|
458 define_all_return_values = 1 |
|
|
459 do_fortran_indexing = 1 |
|
|
460 empty_list_elements_ok = 1 |
|
|
461 implicit_str_to_num_ok = 1 |
|
|
462 ok_to_lose_imaginary_part = 1 |
|
|
463 page_screen_output = 0 |
|
|
464 prefer_column_vectors = 0 |
|
|
465 prefer_zero_one_indexing = 1 |
|
|
466 print_empty_dimensions = 0 |
|
|
467 treat_neg_dim_as_zero = 1 |
|
|
468 warn_function_name_clash = 0 |
|
|
469 whitespace_in_literal_matrix = "traditional" |
|
|
470 |
|
|
471 * New functions: |
|
|
472 |
|
|
473 readdir -- returns names of files in directory as array of strings |
|
|
474 mkdir -- create a directory |
|
|
475 rmdir -- remove a directory |
|
|
476 rename -- rename a file |
|
|
477 unlink -- delete a file |
|
|
478 umask -- set permission mask for file creation |
|
|
479 stat -- get information about a file |
|
|
480 lstat -- get information about a symbolic link |
|
2496
|
481 glob -- perform filename globbing |
|
|
482 fnmatch -- match strings with filename globbing patterns |
|
2452
|
483 more -- turn the pager on or off |
|
|
484 gammaln -- alias for lgamma |
|
|
485 |
|
|
486 * New audio functions from Andreas Weingessel |
|
|
487 <Andreas.Weingessel@ci.tuwien.ac.at>. |
|
|
488 |
|
2458
|
489 lin2mu -- linear to mu-law encoding |
|
|
490 loadaudio -- load an audio file to a vector |
|
|
491 mu2lin -- mu-law to linear encoding |
|
|
492 playaudio -- play an audio file |
|
|
493 record -- record sound and store in vector |
|
|
494 saveaudio -- save a vector as an audio file |
|
|
495 setaudio -- executes mixer shell command |
|
2452
|
496 |
|
|
497 * New plotting functions from Vinayak Dutt. Ones dealing with |
|
|
498 multiple plots on one page require features from gnuplot 3.6beta |
|
|
499 (or later). |
|
|
500 |
|
|
501 bottom_title -- put title at the bottom of the plot |
|
|
502 mplot -- multiplot version of plot |
|
|
503 multiplot -- switch multiple-plot mode on or off |
|
|
504 oneplot -- return to one plot per page |
|
|
505 plot_border -- put a border around plots |
|
|
506 subplot -- position multiple plots on a single page |
|
|
507 subwindow -- set subwindow position for next plot |
|
|
508 top_title -- put title at the top of the plot |
|
|
509 zlabel -- put a label on the z-axis |
|
|
510 |
|
|
511 * New string functions |
|
|
512 |
|
|
513 bin2dec -- convert a string of ones and zeros to an integer |
|
|
514 blanks -- create a string of blanks |
|
|
515 deblank -- delete trailing blanks |
|
|
516 dec2bin -- convert an integer to a string of ones and zeros |
|
|
517 dec2hex -- convert an integer to a hexadecimal string |
|
|
518 findstr -- locate occurrences of one string in another |
|
|
519 hex2dec -- convert a hexadecimal string to an integer |
|
|
520 index -- return position of first occurrence a string in another |
|
|
521 rindex -- return position of last occurrence a string in another |
|
|
522 split -- divide one string into pieces separated by another |
|
|
523 str2mat -- create a string matrix from a list of strings |
|
|
524 strrep -- replace substrings in a string |
|
|
525 substr -- extract a substring |
|
|
526 |
|
|
527 The following functions return a matrix of ones and zeros. |
|
|
528 Elements that are nonzero indicate that the condition was true for |
|
|
529 the corresponding character in the string array. |
|
|
530 |
|
|
531 isalnum -- letter or a digit |
|
|
532 isalpha -- letter |
|
|
533 isascii -- ascii |
|
|
534 iscntrl -- control character |
|
|
535 isdigit -- digit |
|
|
536 isgraph -- printable (but not space character) |
|
|
537 islower -- lower case |
|
|
538 isprint -- printable (including space character) |
|
|
539 ispunct -- punctuation |
|
|
540 isspace -- whitespace |
|
|
541 isupper -- upper case |
|
|
542 isxdigit -- hexadecimal digit |
|
|
543 |
|
|
544 These functions return new strings. |
|
|
545 |
|
2458
|
546 tolower -- convert to lower case |
|
|
547 toupper -- convert to upper case |
|
2452
|
548 |
|
|
549 * New function, fgetl. Both fgetl and fgets accept an optional |
|
|
550 second argument that specifies a maximum number of characters to |
|
|
551 read, and the function fgets is now compatible with Matlab. |
|
|
552 |
|
|
553 * Printing in hexadecimal format now works (format hex). It is also |
|
|
554 possible to print the internal bit representation of a value |
|
|
555 (format bit). Note that these formats are only implemented for |
|
|
556 numeric values. |
|
|
557 |
|
|
558 * Additional structure features: |
|
|
559 |
|
|
560 -- Name completion now works for structures. |
|
|
561 |
|
|
562 -- Values and names of structure elements are now printed by |
|
|
563 default. The new built-in variable `struct_levels_to_print' |
|
|
564 controls the depth of nested structures to print. The default |
|
|
565 value is 2. |
|
|
566 |
|
|
567 -- New functions: |
|
|
568 |
|
|
569 struct_contains (S, NAME) -- returns 1 if S is a structure with |
|
|
570 element NAME; otherwise returns 0. |
|
|
571 |
|
|
572 struct_elements (S) -- returns the names of all elements |
|
|
573 of structure S in an array of strings. |
|
|
574 |
|
|
575 * New io/subprocess functions: |
|
|
576 |
|
2458
|
577 fputs -- write a string to a file with no formatting |
|
|
578 popen2 -- start a subprocess with 2-way communication |
|
|
579 mkfifo -- create a FIFO special file |
|
|
580 popen -- open a pipe to a subprocess |
|
|
581 pclose -- close a pipe from a subprocess |
|
|
582 waitpid -- check the status of or wait for subprocesses |
|
2452
|
583 |
|
|
584 * New time functions: |
|
|
585 |
|
2458
|
586 asctime -- format time structure according to local format |
|
|
587 ctime -- equivalent to `asctime (localtime (TMSTRUCT))' |
|
|
588 gmtime -- return time structure corresponding to UTC |
|
|
589 localtime -- return time structure corresponding to local time zone |
|
|
590 strftime -- print given time structure using specified format |
|
|
591 time -- return current time |
|
2452
|
592 |
|
|
593 The `clock' and `date' functions are now implemented in M-files |
|
|
594 using these basic functions. |
|
|
595 |
|
|
596 * Access to additional Unix system calls: |
|
|
597 |
|
|
598 dup2 -- duplicate a file descriptor |
|
|
599 exec -- replace current process with a new process |
|
|
600 fcntl -- control open file descriptors |
|
|
601 fork -- create a copy of the current process |
|
|
602 getpgrp -- return the process group id of the current process |
|
|
603 getpid -- return the process id of the current process |
|
|
604 getppid -- return the process id of the parent process |
|
2475
|
605 getuid -- return the real user id of the current process |
|
|
606 getgid -- return the real group id of the current process |
|
|
607 geteuid -- return the effective user id of the current process |
|
|
608 getegid -- return the effective group id of the current process |
|
2452
|
609 pipe -- create an interprocess channel |
|
|
610 |
|
|
611 * Other new functions: |
|
|
612 |
|
2554
|
613 commutation_matrix -- compute special matrix form |
|
|
614 duplication_matrix -- compute special matrix form |
|
|
615 common_size.m -- bring arguments to a common size |
|
|
616 completion_matches -- perform command completion on string |
|
2458
|
617 tilde_expand -- perform tilde expansion on string |
|
2554
|
618 |
|
|
619 meshgrid -- compatible with Matlab's meshgrid function |
|
|
620 tmpnam -- replaces octave_tmp_file_name |
|
|
621 atexit -- register functions to be called when Octave exits |
|
|
622 putenv -- define an environment variable |
|
|
623 bincoeff -- compute binomial coefficients |
|
|
624 nextpow2 -- compute the next power of 2 greater than a number |
|
|
625 detrend -- remove a best fit polynomial from data |
|
|
626 erfinv -- inverse error function |
|
|
627 shift -- perform a circular shift on the elements of a matrix |
|
|
628 pow2 -- compute 2 .^ x |
|
|
629 log2 -- compute base 2 logarithms |
|
|
630 diff -- compute differences of matrix elements |
|
|
631 vech -- stack columns of a matrix below the diagonal |
|
|
632 vec -- stack columns of a matrix to form a vector |
|
|
633 xor -- compute exclusive or |
|
2452
|
634 |
|
2459
|
635 * Functions for getting info from the password database on Unix systems: |
|
|
636 |
|
|
637 getpwent -- read entry from password-file stream, opening if necessary |
|
|
638 getpwuid -- search for password entry with matching user ID |
|
|
639 getpwnam -- search for password entry with matching username |
|
|
640 setpwent -- rewind the password-file stream |
|
|
641 endpwent -- close the password-file stream |
|
|
642 |
|
2484
|
643 * Functions for getting info from the group database on Unix systems: |
|
|
644 |
|
|
645 getgrent -- read entry from group-file stream, opening if necessary |
|
|
646 getgrgid -- search for group entry with matching group ID |
|
|
647 getgrnam -- search for group entry with matching group name |
|
|
648 setgrent -- rewind the pgroup-file stream |
|
|
649 endgrent -- close the group-file stream |
|
|
650 |
|
2452
|
651 * The New function octave_config_info returns a structure containing |
|
|
652 information about how Octave was configured and compiled. |
|
|
653 |
|
|
654 * New function getrusage returns a structure containing system |
|
|
655 resource usage statistics. The `cputime' function is now defined |
|
|
656 in an M-file using getrusage. |
|
|
657 |
|
|
658 * The info reader is now a separate binary that runs as a |
|
|
659 subprocess. You still need the info reader distributed with |
|
|
660 Octave though, because there are some new command-line arguments |
|
|
661 that are not yet available in the public release of Info. |
|
|
662 |
|
|
663 * There is a new built-in variable, INFO_PROGRAM, which is used as |
|
|
664 the name of the info program to run. Its initial value is |
|
|
665 $OCTAVE_HOME/lib/octave/VERSION/exec/ARCH/info, but that value can |
|
|
666 be overridden by the environment variable OCTAVE_INFO_PROGRAM, or |
|
|
667 the command line argument --info-program NAME, or by setting the |
|
|
668 value of INFO_PROGRAM in a startup script. |
|
|
669 |
|
|
670 * There is a new built-in variable, EXEC_PATH, which is used as |
|
|
671 the list of directories to search when executing subprograms. Its |
|
|
672 initial value is taken from the environment variable |
|
|
673 OCTAVE_EXEC_PATH (if it exists) or PATH, but that value can be |
|
|
674 overridden by the the command line argument --exec-path PATH, or |
|
|
675 by setting the value of EXEC_PATH in a startup script. If the |
|
|
676 EXEC_PATH begins (ends) with a colon, the directories |
|
|
677 $OCTAVE_HOME/lib/octave/VERSION/exec/ARCH and $OCTAVE_HOME/bin are |
|
|
678 prepended (appended) to EXEC_PATH (if you don't specify a value |
|
|
679 for EXEC_PATH explicitly, these special directories are prepended |
|
|
680 to your PATH). |
|
|
681 |
|
|
682 * If it is present, Octave will now use an `ls-R' database file to |
|
|
683 speed up recursive path searching. Octave looks for a file called |
|
|
684 ls-R in the directory specified by the environment variable |
|
|
685 OCTAVE_DB_DIR. If that is not set but the environment variable |
|
|
686 OCTAVE_HOME is set, Octave looks in $OCTAVE_HOME/lib/octave. |
|
|
687 Otherwise, Octave looks in the directory $datadir/octave (normally |
|
|
688 /usr/local/lib/octave). |
|
|
689 |
|
|
690 * New examples directory. |
|
|
691 |
|
|
692 * There is a new script, mkoctfile, that can be used to create .oct |
|
|
693 files suitable for dynamic linking. |
|
|
694 |
|
|
695 * Many more bug fixes. |
|
|
696 |
|
|
697 * ChangeLogs are now kept in each subdirectory. |
|
|
698 |
|
|
699 See NEWS.1 for old news. |
