nNumber BIN2I(<cSignedInt>) nNumber BIN2L(<cSignedInt>) nNumber BIN2W(<cUnsignedInt>) bCurrentErrorHandlerERRORBLOCK([<bErrorHandler>]) cHexStr fn_Bin2I( <cBinStr> ) nValue fn_Bin2I( <cBinStr> ) nResult fn_clrbit( <nNum>, <nBit> ) nError fn_error() cBinStr fn_Hex2Bin( <cHexStr> ) cBinStr fn_I2Bin( <nValue>, [ <nLen> ] ) lInit Fn_IPXInit() lIs3X fn_is3x() lSet fn_isbit( <nNum>, <nBit> ) nStatus fn_isNet() fn_NameL( cName, nRequiredLength) => cReturn cNewStr fn_noNull( cStr ) cBinStr fn_PeekStr( <nSegment>, <nOffset>, <nLength> ) xRet fn_pfEval( xID, bBlock ) NIL fn_PokeStr( <nSegment>, <nOffset>, <cBinStr> ) nResult fn_setbit( <nNum>, <nBit> ) nOldError _fnSetErr( nErrCode ) cStrippedPath Fn_SSFromP( <cFullPath>,<@cServerName> ) nResult fn_togbit( <nNum>, <nBit> ) cBinaryInteger I2BIN(<nInteger>) cBinaryInteger L2BIN(<nExp>) nLastArgumentPos PCOUNT() nSourceLine PROCLINE([<nActivation>]) cProcedureName PROCNAME([<nActivation>]) cVersion VERSION()
fn_Bin2I( <cBinStr> ) --> cHexStr
Internally, all information is stored as a series of bytes. When performing a direct read from memory, a character string will be returned. Use this function to convert that string to its hexidecimal numeric equivalent.
<cBinStr> | is a string of bytes representing a number. |
Returns : | A string containing the hexdecimal value of <cBinStr>. |
See also : | fn_Hex2Bin() fn_Bin2I() fn_PeekStr() fn_PokeStr() |
fn_Bin2I( <cBinStr> ) --> nValue
Internally, all information is stored as a series of bytes. When performing a direct read from memory, a character string will be returned. Use this function to convert that string to its Clipper numeric equivalent.
This function only returns integer values.
<cBinStr> | is a string of bytes representing a number. |
Returns : | The decimal value of <cBinStr>. |
See also : | fn_I2Bin() fn_PeekStr() fn_PokeStr() |
fn_clrbit( <nNum>, <nBit> ) --> nResult
Clears a specified bit in a number.
fn_error() --> nError
Returns : | <nError>, a numeric error code. Details on the error codes can be found... |
See also : | _fnSetErr() |
fn_Hex2Bin( <cHexStr> ) --> cBinStr
This function converts a hexidecimal value to it binary equivalent, and is useful for doing a direct memory translation.
<cHexStr> | is a string containing hexidecimal characters. |
Returns : | A binary string representing the value passed. |
See also : | fn_Bin2Hex() fn_PeekStr() fn_PokeStr() |
fn_I2Bin( <nValue>, [ <nLen> ] ) --> cBinStr
This function converts a decimal value to it binary equivalent, and is useful for doing a direct memory translation.
<nValue> | is the integer to convert. Only positive integers may be converted. |
<nLen> | is the desired resultant string length. If omitted, it defaults to the length required to represent <nValue>. If <nLen> is larger than the length required to represent <nValue>, cBinStr is left-padded with CHR(0)'s to fill it out to the desired length. |
Returns : | A binary string representing the value passed. |
See also : | fn_Bin2I() fn_PeekStr() fn_PokeStr() |
Fn_IPXInit() --> lInit
This function initializes an array in the library with the address of the IPX services. This function must be called before any of the IPX functions in this library can be performed.
[This function is meant to be part of a larger suite but the code wasn't ready by the release date. In its present form, it can be used to determine if IPX is installed, which might be useful.]
fn_is3x() --> lIs3X
A simple function that wraps around FN_GETFSI(). Determines whether or not the current server is a NetWare 3.x server or not.
Returns : | .t. if the server is a 3.x server, .f. if it isn't |
See also : | FN_GETFSI() |
fn_isbit( <nNum>, <nBit> ) --> lSet
Determines if a specified bit in a number is set.
fn_isNet() --> nStatus
fn_isNet() provides a simple way to determine if the user running your program is logged in. if fn_isNet() == 0, she's in.
Returns : | <nStatus>, a numeric, which will be one of: 0 User has shell loaded and is logged in 1 User hasn't loaded IPX 2 User hasn't loaded a shell 3 User is not attached to a server 4 User has no connection id (?) 5 User is not logged in |
See also : | fn_netver() fn_is3x() |
fn_NameL( cName, nRequiredLength) => cReturn
There are numerous places where a character string that is sent needs to be encoded with a leading BYTE specifying the length and may also need to be padded with NULLs.
A terminating null is guaranteed.
If the Length of cName is greater than nRequiredLength -1, it is truncated to leave room for the terminator.
<cName> | - the character string to be used (shouldn't be longer than 255 characters |
<nLength> | - if specified, the String is padded with NULLs to this length |
Returns : | <cReturn> - a character string with a one byte word at the beginning which indicates the string length, including a null terminator which is added if it does not exist. |
fn_noNull( cStr ) --> cNewStr
Given a string <cStr>, fn_noNull() strips any trailing NULLs, [ chr(0) ] from the end. If there are no nulls, the entire string is returned.
fn_PeekStr( <nSegment>, <nOffset>, <nLength> ) --> cBinStr
Use this function to perform memory reads of a contiguous block of memory. The string returned contains one character for each byte of memory read.
If you plan to perform consecutive memory reads from memory, for instance in filling an array, pass <nOffset> by reference to keep it updated in the calling routine.
<nSegment> | is the memory segment to read. |
<nOffset> | is the starting offset from <nSegment> to read from. |
<nLength> | is the number of bytes to read. |
Returns : | A string containing the characters found at <nSegment>:<nOffset>. |
See also : | fn_PokeStr() |
fn_pfEval( xID, bBlock ) --> xRet
Some APIs require you to set to a preferred connection ID first before they can be executed. This call just simplifies the process of getting the old ID, setting the new one, doing something, then resetting the old ID.
This function records the state of fn_error() after evaluating the block and makes sure it stays that way before returning. Therefore, you can't really know whether or not the calls to change the preferred server back and forth are working or not, as there is no way to access their return values.
<xID> | can be numeric, or a character. If it's numeric, it is the connection ID of the server you want to set to before evaluating <bBlock>. This is is position of the server in the server name table. You can use FN_FSNAME() to find a connection ID, given a server name. If the connection ID is invalid, the current connection ID is used. If it's a character, it is the _name_ of the server you want to set to before evaluating <bBlock>. If the server name is invalid or not found, the current server is used. |
<bBlock> | is a code block to evaluate. |
Returns : | <xVal>, whatever is returned from the block when it is evaluated. |
fn_PokeStr( <nSegment>, <nOffset>, <cBinStr> ) --> NIL
Use this function to perform memory write to a contiguous block of memory.
If you plan to perform consecutive memory write to memory, for instance in copying an array of binary strings to memory, pass <nOffset> by reference to keep it updated in the calling routine.
<nSegment> | is the memory segment to write to. |
<nOffset> | is the starting offset from <nSegment> to write at. |
<cBinStr> | is a string of bytes to write. |
Returns : | Nothing. |
See also : | fn_PeekStr() |
fn_setbit( <nNum>, <nBit> ) --> nResult
Sets a bit in a number.
_fnSetErr( nErrCode ) --> nOldError
Returns : | <nOldError> |
See also : | FN_ERROR() |
Fn_SSFromP( <cFullPath>,<@cServerName> ) --> cStrippedPath
This function strips the server name from the specified path. If the path does not include a file server specification, then the function returns the original path.
Пред. | Начало | След. |
DATABASE | Уровень выше | CLIP-UI |