basic.%whex C Function/BASIC Program

basic.%whex

Command basic.%whex C Function/BASIC Program
Applicable release versions: AP/Unix
Category BASIC Program (486)
Description writes to the file specified by "file.descriptor" returned by a previous call to "%open()", "%creat()" or "dup()" a string of bytes resulting from converting the ASCII string variable into binary.

Two digits are converted into one eight bit binary character. variable is assumed to contain only hexadecimal characters '0' to '9', 'A' to 'F' or 'a' to 'f'. The function returns the number of bytes actually written or -1 if an error occurred. The size written to the file is the size of variable divided by 2. This function is the reverse of "%rdhex()".
Syntax byte.count=%whex(file.descriptor, variable)
Options
Example
* Write "EOF"x'ff' on device
n=%whex( fd, oconv("EOF","mx"):'FF' )
Purpose
Related basic.cfunction
basic.cfunc
basic.%creat
basic.%dup
basic.%rdhex
basic.%write
basic.%open