Mercurial > hg > octave-nkf
annotate liboctave/oct-sort.h @ 7786:37ff0c21c17d
load-path.cc (load_path::initialize): include separator when appending sys_path
| author | Kim Hansen |
|---|---|
| date | Tue, 20 May 2008 16:49:02 -0400 |
| parents | 2467639bd8c0 |
| children | 30b952e90c29 |
| rev | line source |
|---|---|
| 4851 | 1 /* |
| 7017 | 2 Copyright (C) 2003, 2004, 2005, 2006, 2007 David Bateman |
| 4851 | 3 |
| 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 the | |
| 7016 | 8 Free Software Foundation; either version 3 of the License, or (at your |
| 9 option) any later version. | |
| 4851 | 10 |
| 11 Octave is distributed in the hope that it will be useful, but WITHOUT | |
| 12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 14 for more details. | |
| 15 | |
| 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/>. | |
| 4851 | 19 |
| 20 Code stolen in large part from Python's, listobject.c, which itself had | |
| 21 no license header. However, thanks to Tim Peters for the parts of the | |
| 22 code I ripped-off. | |
| 23 | |
| 24 As required in the Python license the short description of the changes | |
| 25 made are | |
| 26 | |
| 27 * convert the sorting code in listobject.cc into a generic class, | |
| 28 replacing PyObject* with the type of the class T. | |
| 29 | |
| 30 The Python license is | |
| 31 | |
| 32 PSF LICENSE AGREEMENT FOR PYTHON 2.3 | |
| 33 -------------------------------------- | |
| 34 | |
| 35 1. This LICENSE AGREEMENT is between the Python Software Foundation | |
| 36 ("PSF"), and the Individual or Organization ("Licensee") accessing and | |
| 37 otherwise using Python 2.3 software in source or binary form and its | |
| 38 associated documentation. | |
| 39 | |
| 40 2. Subject to the terms and conditions of this License Agreement, PSF | |
| 41 hereby grants Licensee a nonexclusive, royalty-free, world-wide | |
| 42 license to reproduce, analyze, test, perform and/or display publicly, | |
| 43 prepare derivative works, distribute, and otherwise use Python 2.3 | |
| 44 alone or in any derivative version, provided, however, that PSF's | |
| 45 License Agreement and PSF's notice of copyright, i.e., "Copyright (c) | |
| 46 2001, 2002, 2003 Python Software Foundation; All Rights Reserved" are | |
| 47 retained in Python 2.3 alone or in any derivative version prepared by | |
| 48 Licensee. | |
| 49 | |
| 50 3. In the event Licensee prepares a derivative work that is based on | |
| 51 or incorporates Python 2.3 or any part thereof, and wants to make | |
| 52 the derivative work available to others as provided herein, then | |
| 53 Licensee hereby agrees to include in any such work a brief summary of | |
| 54 the changes made to Python 2.3. | |
| 55 | |
| 56 4. PSF is making Python 2.3 available to Licensee on an "AS IS" | |
| 57 basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR | |
| 58 IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND | |
| 59 DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS | |
| 60 FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 2.3 WILL NOT | |
| 61 INFRINGE ANY THIRD PARTY RIGHTS. | |
| 62 | |
| 63 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON | |
| 64 2.3 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS | |
| 65 A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 2.3, | |
| 66 OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. | |
| 67 | |
| 68 6. This License Agreement will automatically terminate upon a material | |
| 69 breach of its terms and conditions. | |
| 70 | |
| 71 7. Nothing in this License Agreement shall be deemed to create any | |
| 72 relationship of agency, partnership, or joint venture between PSF and | |
| 73 Licensee. This License Agreement does not grant permission to use PSF | |
| 74 trademarks or trade name in a trademark sense to endorse or promote | |
| 75 products or services of Licensee, or any third party. | |
| 76 | |
| 77 8. By copying, installing or otherwise using Python 2.3, Licensee | |
| 78 agrees to be bound by the terms and conditions of this License | |
| 79 Agreement. | |
| 80 */ | |
| 81 | |
| 82 #if !defined (octave_sort_h) | |
| 83 #define octave_sort_h 1 | |
| 84 | |
| 7234 | 85 // The maximum number of entries in a MergeState's pending-runs stack. |
| 86 // This is enough to sort arrays of size up to about | |
| 87 // 32 * phi ** MAX_MERGE_PENDING | |
| 88 // where phi ~= 1.618. 85 is ridiculously large enough, good for an array | |
| 89 // with 2**64 elements. | |
| 4851 | 90 #define MAX_MERGE_PENDING 85 |
| 91 | |
| 7234 | 92 // When we get into galloping mode, we stay there until both runs win less |
| 93 // often than MIN_GALLOP consecutive times. See listsort.txt for more info. | |
| 4851 | 94 #define MIN_GALLOP 7 |
| 95 | |
| 7234 | 96 // Avoid malloc for small temp arrays. |
| 4851 | 97 #define MERGESTATE_TEMP_SIZE 1024 |
| 98 | |
| 7433 | 99 // Enum for type of sort function |
|
7463
2467639bd8c0
eliminate UNDEFINED sort mode
John W. Eaton <jwe@octave.org>
parents:
7433
diff
changeset
|
100 enum sortmode { ASCENDING, DESCENDING }; |
| 7433 | 101 |
| 4851 | 102 template <class T> |
| 103 class | |
| 104 octave_sort | |
| 105 { | |
| 4998 | 106 public: |
| 107 | |
| 4851 | 108 octave_sort (void); |
| 109 | |
| 110 octave_sort (bool (*comp) (T, T)); | |
| 111 | |
| 4998 | 112 ~octave_sort (void) { merge_freemem (); } |
| 113 | |
| 114 void set_compare (bool (*comp) (T, T)) { compare = comp; } | |
| 4851 | 115 |
| 7433 | 116 void sort (T *v, octave_idx_type elements); |
| 4851 | 117 |
| 4998 | 118 private: |
| 119 | |
| 7234 | 120 // One MergeState exists on the stack per invocation of mergesort. |
| 121 // It's just a convenient way to pass state around among the helper | |
| 122 // functions. | |
| 123 // | |
| 124 // DGB: This isn't needed with mergesort in a class, but it doesn't | |
| 125 // slow things up, and it is likely to make my life easier for any | |
| 126 // potential backporting of changes in the Python code. | |
| 4851 | 127 |
| 128 struct s_slice | |
| 129 { | |
| 130 T *base; | |
| 7433 | 131 octave_idx_type len; |
| 4851 | 132 }; |
| 133 | |
| 7234 | 134 struct MergeState |
| 4851 | 135 { |
| 7234 | 136 // This controls when we get *into* galloping mode. It's |
| 137 // initialized to MIN_GALLOP. merge_lo and merge_hi tend to nudge | |
| 138 // it higher for random data, and lower for highly structured | |
| 139 // data. | |
| 7433 | 140 octave_idx_type min_gallop; |
| 4851 | 141 |
| 7234 | 142 // 'a' is temp storage to help with merges. It contains room for |
| 143 // alloced entries. | |
| 144 T *a; // may point to temparray below | |
| 7433 | 145 octave_idx_type alloced; |
| 4851 | 146 |
| 7234 | 147 // A stack of n pending runs yet to be merged. Run #i starts at |
| 148 // address base[i] and extends for len[i] elements. It's always | |
| 149 // true (so long as the indices are in bounds) that | |
| 150 // | |
| 151 // pending[i].base + pending[i].len == pending[i+1].base | |
| 152 // | |
| 153 // so we could cut the storage for this, but it's a minor amount, | |
| 154 // and keeping all the info explicit simplifies the code. | |
| 7433 | 155 octave_idx_type n; |
| 4851 | 156 struct s_slice pending[MAX_MERGE_PENDING]; |
| 7234 | 157 }; |
| 4851 | 158 |
| 7234 | 159 bool (*compare) (T, T); |
| 4851 | 160 |
| 161 MergeState ms; | |
| 162 | |
| 163 void reverse_slice (T *lo, T *hi); | |
| 164 | |
| 165 void binarysort (T *lo, T *hi, T *start); | |
| 166 | |
| 7433 | 167 octave_idx_type count_run (T *lo, T *hi, octave_idx_type *descending); |
| 4851 | 168 |
| 7433 | 169 octave_idx_type gallop_left (T key, T *a, octave_idx_type n, octave_idx_type hint); |
| 4851 | 170 |
| 7433 | 171 octave_idx_type gallop_right (T key, T *a, octave_idx_type n, octave_idx_type hint); |
| 4851 | 172 |
| 7234 | 173 void merge_init (void); |
| 4851 | 174 |
| 7234 | 175 void merge_freemem (void); |
| 4851 | 176 |
| 7433 | 177 int merge_getmem (octave_idx_type need); |
| 4851 | 178 |
| 7433 | 179 int merge_lo (T *pa, octave_idx_type na, T *pb, octave_idx_type nb); |
| 4851 | 180 |
| 7433 | 181 int merge_hi (T *pa, octave_idx_type na, T *pb, octave_idx_type nb); |
| 4851 | 182 |
| 7433 | 183 int merge_at (octave_idx_type i); |
| 4851 | 184 |
| 7234 | 185 int merge_collapse (void); |
| 4851 | 186 |
| 7234 | 187 int merge_force_collapse (void); |
| 4851 | 188 |
| 7433 | 189 octave_idx_type merge_compute_minrun (octave_idx_type n); |
| 4851 | 190 }; |
| 191 | |
| 7433 | 192 template <class T> |
| 193 class | |
| 194 vec_index | |
| 195 { | |
| 196 public: | |
| 197 T vec; | |
| 198 octave_idx_type indx; | |
| 199 }; | |
| 4851 | 200 #endif |
| 201 | |
| 202 /* | |
| 203 ;;; Local Variables: *** | |
| 204 ;;; mode: C++ *** | |
| 205 ;;; End: *** | |
| 206 */ |