1 ## Copyright (C) 2003 Motorola Inc
2 ## Copyright (C) 2003 David Bateman
4 ## This program is free software; you can redistribute it and/or modify
5 ## it under the terms of the GNU General Public License as published by
6 ## the Free Software Foundation; either version 2 of the License, or
7 ## (at your option) any later version.
9 ## This program is distributed in the hope that it will be useful,
10 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
11 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 ## GNU General Public License for more details.
14 ## You should have received a copy of the GNU General Public License
15 ## along with this program; If not, see <http://www.gnu.org/licenses/>.
18 ## @deftypefn {Function File} {[@var{s}, @var{i}] =} fsort (@var{x})
19 ## Return a copy of the fixed point variable @var{x} with the elements
20 ## arranged in increasing order. For matrices, @code{fsort} orders the
21 ## elements in each column.
27 ## fsort (fixed(4,0,[1, 2; 2, 3; 3, 1]))
34 ## The @code{fsort} function may also be used to produce a matrix
35 ## containing the original row indices of the elements in the sorted
36 ## matrix. For example,
40 ## [s, i] = sort ([1, 2; 2, 3; 3, 1])
51 ## PKG_ADD: dispatch ("sort", "fsort", "fixed scalar")
52 ## PKG_ADD: dispatch ("sort", "fsort", "fixed matrix")
53 ## PKG_ADD: dispatch ("sort", "fsort", "fixed complex")
54 ## PKG_ADD: dispatch ("sort", "fsort", "fixed complex matrix")
56 function [s, i] = fsort (x)
58 error("fsort: input argument not of fixed point type");