% -*- texinfo -*-
% @deftypefn {Function File} {} shannonfanodeco (@var{hcode},@var{dict})
%
% Returns the original signal that was Shannonfano encoded. The signal
% was encoded using @code{shannonfanoenco}. This function uses
% a dict built from the @code{shannonfanodict} and uses it to decode a signal
% list into a shannonfano list. Restrictions include hcode is expected to be a binary code;
% returned signal set that strictly belongs in the @code{range [1,N]},
% with @code{N=length(dict)}. Also dict can only be from the
% @code{shannonfanodict(...)} routine. Whenever decoding fails,
% those signal values are indicated by -1, and we successively
% try to restart decoding from the next bit that hasnt failed in
% decoding, ad-infinitum.
%
% An example use of @code{shannonfanodeco} is
% @example
% @group
% hd=shannonfanodict(1:4,[0.5 0.25 0.15 0.10])
% hcode=shannonfanoenco(1:4,hd) % [ 1 0 1 0 0 0 0 0 1 ]
% shannonfanodeco(hcode,hd) % [1 2 3 4]
%
% @end group
% @end example
% @end deftypefn
% @seealso{shannonfanoenco, shannonfanodict}