Mercurial > octave
annotate scripts/strings/dec2hex.m @ 28693:2bb050267d74
maint: Remove trailing spaces from code base.
* NEWS, __ftp__.cc, graphics.in.h, rng.m, importdata.m, condest.m,
fieldnames.m, uninstall.m, polyfit.m, dec2bin.m, dec2hex.m:
Remove trailing spaces from code base.
author | Rik <rik@octave.org> |
---|---|
date | Tue, 08 Sep 2020 08:34:28 -0700 |
parents | f618edac2a29 |
children | 28de41192f3c |
rev | line source |
---|---|
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
1 ######################################################################## |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
2 ## |
27919
1891570abac8
update Octave Project Developers copyright for the new year
John W. Eaton <jwe@octave.org>
parents:
27918
diff
changeset
|
3 ## Copyright (C) 1996-2020 The Octave Project Developers |
27918
b442ec6dda5c
use centralized file for copyright info for individual contributors
John W. Eaton <jwe@octave.org>
parents:
26376
diff
changeset
|
4 ## |
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
5 ## See the file COPYRIGHT.md in the top-level directory of this |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
6 ## distribution or <https://octave.org/copyright/>. |
2325 | 7 ## |
2313 | 8 ## This file is part of Octave. |
9 ## | |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
10 ## Octave is free software: you can redistribute it and/or modify it |
2313 | 11 ## under the terms of the GNU General Public License as published by |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
12 ## the Free Software Foundation, either version 3 of the License, or |
22755
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
13 ## (at your option) any later version. |
2313 | 14 ## |
15 ## Octave is distributed in the hope that it will be useful, but | |
16 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
22755
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
17 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3a2b891d0b33
maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents:
22323
diff
changeset
|
18 ## GNU General Public License for more details. |
2313 | 19 ## |
20 ## You should have received a copy of the GNU General Public License | |
7016 | 21 ## along with Octave; see the file COPYING. If not, see |
24534
194eb4bd202b
maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents:
23220
diff
changeset
|
22 ## <https://www.gnu.org/licenses/>. |
27923
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
23 ## |
bd51beb6205e
update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents:
27919
diff
changeset
|
24 ######################################################################## |
2268 | 25 |
3361 | 26 ## -*- texinfo -*- |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
27 ## @deftypefn {} {} dec2hex (@var{d}) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
28 ## @deftypefnx {} {} dec2hex (@var{d}, @var{len}) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
29 ## Return a string representing the conversion of the integer @var{d} to a |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
30 ## hexadecimal (base16) number. |
20164
df437a52bcaf
doc: Update more docstrings to have one sentence summary as first line.
Rik <rik@octave.org>
parents:
19833
diff
changeset
|
31 ## |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
32 ## If @var{d} is negative, return the two's complement binary value of @var{d}. |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
33 ## If @var{d} is a matrix or cell array, return a string matrix with one row |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
34 ## for each element in @var{d}, padded with leading zeros to the width of the |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
35 ## largest value. |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
36 ## |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
37 ## The optional second argument, @var{len}, specifies the minimum number of |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
38 ## digits in the result. |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
39 ## |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
40 ## Examples: |
3426 | 41 ## |
3361 | 42 ## @example |
9051
1bf0ce0930be
Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents:
8920
diff
changeset
|
43 ## @group |
3361 | 44 ## dec2hex (2748) |
3789 | 45 ## @result{} "ABC" |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
46 ## |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
47 ## dec2hex (-2) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
48 ## @result{} "FE" |
9051
1bf0ce0930be
Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents:
8920
diff
changeset
|
49 ## @end group |
3361 | 50 ## @end example |
3789 | 51 ## |
11172
7e8ce65f73cf
Overhaul functions used to convert between number bases.
Rik <octave@nomad.inbox5.com>
parents:
10821
diff
changeset
|
52 ## @seealso{hex2dec, dec2base, dec2bin} |
3361 | 53 ## @end deftypefn |
2311 | 54 |
11172
7e8ce65f73cf
Overhaul functions used to convert between number bases.
Rik <octave@nomad.inbox5.com>
parents:
10821
diff
changeset
|
55 function h = dec2hex (d, len) |
2268 | 56 |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
57 if (nargin == 0 || nargin > 2) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
58 print_usage (); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
59 endif |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
60 |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
61 if (iscell (d)) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
62 d = cell2mat (d); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
63 endif |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
64 ## Create column vector for algorithm (output is always col. vector anyways) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
65 d = d(:); |
28693
2bb050267d74
maint: Remove trailing spaces from code base.
Rik <rik@octave.org>
parents:
28242
diff
changeset
|
66 |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
67 lt_zero_idx = (d < 0); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
68 if (any (lt_zero_idx)) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
69 ## FIXME: Need an algorithm that works with larger values such as int64. |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
70 if (any (d(lt_zero_idx) < -2^52)) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
71 error ("dec2hex: negative inputs cannot be less than -flintmax () / 2"); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
72 elseif (any (d(lt_zero_idx) < intmin ("int32"))) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
73 d(lt_zero_idx) += flintmax (); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
74 elseif (any (d < intmin ("int16"))) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
75 d(lt_zero_idx) += double (intmax ("uint32")) + 1; |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
76 elseif (any (d < intmin ("int8"))) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
77 d(lt_zero_idx) += double (intmax ("uint16"))+ 1; |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
78 else |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
79 d(lt_zero_idx) += double (intmax ("uint8")) + 1; |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
80 endif |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
81 endif |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
82 |
4492 | 83 if (nargin == 1) |
11172
7e8ce65f73cf
Overhaul functions used to convert between number bases.
Rik <octave@nomad.inbox5.com>
parents:
10821
diff
changeset
|
84 h = dec2base (d, 16); |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
85 else |
11172
7e8ce65f73cf
Overhaul functions used to convert between number bases.
Rik <octave@nomad.inbox5.com>
parents:
10821
diff
changeset
|
86 h = dec2base (d, 16, len); |
2268 | 87 endif |
2325 | 88 |
2268 | 89 endfunction |
7411 | 90 |
13167
f7cb824dc8c0
Allow cellstr inputs for dec2* conversion functions.
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
91 |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
92 %!assert (dec2hex (2748), "ABC") |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
93 %!assert (dec2hex (2748, 5), "00ABC") |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
94 %!assert (dec2hex ([2748, 2746]), ["ABC"; "ABA"]) |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
95 %!assert (dec2hex ({2748, 2746}), ["ABC"; "ABA"]) |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
96 %!assert (dec2hex ({2748, 2746}, 4), ["0ABC"; "0ABA"]) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
97 |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
98 ## Test negative inputs |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
99 %!assert (dec2hex (-3), "FD") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
100 %!assert (dec2hex (-3, 1), "FD") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
101 %!assert (dec2hex (-3, 3), "0FD") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
102 %!assert (dec2hex (-2^7 -1), "FF7F") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
103 %!assert (dec2hex (-2^15 -1), "FFFF7FFF") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
104 ## FIXME: Matlab returns longer string that begins with 'F' |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
105 %!assert (dec2hex (-2^31 -1), "1FFFFF7FFFFFFF") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
106 ## FIXME: Matlab returns longer string that begins with 'FFF' |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
107 %!assert (dec2hex (-2^52), "10000000000000") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
108 ## FIXME: Uncomment when support for int64 is added |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
109 %!#assert (dec2hex (-2^63), |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
110 %! "1000000000000000000000000000000000000000000000000000000000000000") |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
111 %!#test |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
112 %! assert (dec2hex (int64 (-2^63)), |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
113 %! "1000000000000000000000000000000000000000000000000000000000000000"); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
114 %!#test |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
115 %! assert (dec2hex (int64 (-2^63) -1), |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
116 %! "1000000000000000000000000000000000000000000000000000000000000000"); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
117 %!#test |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
118 %! assert (dec2hex (int64 (-2^63) +1), |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
119 %! "1000000000000000000000000000000000000000000000000000000000000001"); |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
120 %!assert (dec2hex ([-1, -2; -3, -4]), ["FF"; "FD"; "FE"; "FC"]) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
121 %!assert (dec2hex ([1, 2; 3, -4]), ["01"; "03"; "02"; "FC"]) |
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
122 %!assert (dec2hex ({1, 2; 3, -4}), ["01"; "03"; "02"; "FC"]) |
7411 | 123 |
19833
9fc020886ae9
maint: Clean up m-files to follow Octave coding conventions.
Rik <rik@octave.org>
parents:
19697
diff
changeset
|
124 ## Test input validation |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
125 %!error dec2hex () |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
126 %!error dec2hex (1, 2, 3) |
28242
f618edac2a29
dec2hex.m: Implement support for negative number inputs (bug #58147).
Rik <rik@octave.org>
parents:
27985
diff
changeset
|
127 %!error <negative inputs cannot be less than> dec2hex (- flintmax ()) |