7017
|
1 ## Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2002, 2005, 2006, |
8920
|
2 ## 2007, 2009 Kurt Hornik |
3426
|
3 ## |
3922
|
4 ## This file is part of Octave. |
|
5 ## |
|
6 ## Octave is free software; you can redistribute it and/or modify it |
|
7 ## under the terms of the GNU General Public License as published by |
7016
|
8 ## the Free Software Foundation; either version 3 of the License, or (at |
|
9 ## your option) any later version. |
3426
|
10 ## |
3922
|
11 ## Octave is distributed in the hope that it will be useful, but |
3200
|
12 ## WITHOUT ANY WARRANTY; without even the implied warranty of |
|
13 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
3426
|
14 ## General Public License for more details. |
|
15 ## |
3200
|
16 ## You should have received a copy of the GNU General Public License |
7016
|
17 ## along with Octave; see the file COPYING. If not, see |
|
18 ## <http://www.gnu.org/licenses/>. |
3200
|
19 |
3453
|
20 ## -*- texinfo -*- |
|
21 ## @deftypefn {Function File} {} values (@var{x}) |
3200
|
22 ## Return the different values in a column vector, arranged in ascending |
|
23 ## order. |
6754
|
24 ## |
|
25 ## As an example, @code{values([1, 2, 3, 1])} returns the vector |
|
26 ## @code{[1, 2, 3]}. |
3453
|
27 ## @end deftypefn |
3426
|
28 |
5428
|
29 ## Author: KH <Kurt.Hornik@wu-wien.ac.at> |
3456
|
30 ## Description: Extract unique elements |
3200
|
31 |
10881
|
32 ## Deprecated in version 3.4 |
|
33 |
3200
|
34 function v = values (x) |
3426
|
35 |
10881
|
36 persistent warned = false; |
|
37 if (! warned) |
|
38 warned = true; |
|
39 warning ("Octave:deprecated-function", |
|
40 "values is obsolete and will be removed from a future version of Octave; please use unique instead"); |
|
41 endif |
|
42 |
3200
|
43 if (nargin != 1) |
6046
|
44 print_usage (); |
3200
|
45 endif |
3426
|
46 |
4030
|
47 if (! (isvector (x))) |
3456
|
48 error ("values: x must be a vector"); |
3200
|
49 endif |
|
50 |
|
51 i = any (isnan (x)); |
8506
|
52 ## HACK! |
|
53 x = x(find(!isnan (x))); |
3200
|
54 n = length (x); |
|
55 x = reshape (x, n, 1); |
|
56 s = sort (x); |
3388
|
57 v = s([1; (find (s(2:n) > s(1:n-1)) + 1)]); |
3200
|
58 if (i) |
|
59 v = [v; NaN]; |
|
60 endif |
|
61 |
|
62 endfunction |