|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()".
* Write "EOF"x'ff' on device n=%whex( fd, oconv("EOF","mx"):'FF' )