upc.f File Reference

Decode a character string from an integer array. More...

Go to the source code of this file.

Functions/Subroutines
subroutine	upc (CHR, NCHR, IBAY, IBIT, CNVNULL)
	Decode a character string from an integer array. More...

Detailed Description

Decode a character string from an integer array.

Author

J. Woollen

Date

1994-01-06

Definition in file upc.f.

Function/Subroutine Documentation

upc()

subroutine upc	(	character*(*)	CHR,
			NCHR,
		dimension(*)	IBAY,
			IBIT,
		logical	CNVNULL
	)

Decode a character string from an integer array.

This subroutine decodes a character string from within a specified number of bytes of an integer array, starting at the bit immediately after a specified bit within the array.

Remarks

• This subroutine is the logical inverse of subroutine pkc().
• On input, there is no requirement that IBIT must point to the first bit of a byte within IBAY. In other words, the NCHR characters to be decoded do not necessarily need to be aligned on byte boundaries within IBAY.

Parameters

[out]	CHR	- character*(*): Decoded string.
[in]	NCHR	- integer: Number of bytes of IBAY from within which to decode CHR (i.e. the number of characters in CHR).
[in]	IBAY	- integer(*): Array from which to decode CHR.
[in,out]	IBIT	- integer: Bit pointer within IBAY On input, IBIT points to the bit within IBAY after which to begin decoding CHR. On output, IBIT points to the last bit of IBAY which was decoded.
[in]	CNVNULL	- logical: .true. if null characters in IBAY should be converted to blanks within CHR; .false. otherwise

Author

J. Woollen

Date

1994-01-06

Definition at line 31 of file upc.f.

References upb().

Referenced by rdcmps(), rdtree(), readlc(), stbfdx(), stndrd(), ufbget(), ufbtab(), ufbtam(), and wrcmps().