NAME¶
Trf_QueryMaxRead - Interface for procedures to query a transformation about the
max.
SYNOPSIS¶
#include <transform.h>
int Trf_QueryMaxRead
(
Trf_ControlBlock ctrlBlock,
ClientData clientData
);
PARAMETERS¶
- Trf_ControlBlock ctrlBlock
- State of encoder/decoder.
- ClientData clientData
- Arbitrary information, as defined in Trf_TypeDefinition.clientData.
DESCRIPTION¶
Number of bytes to read in the next call to the down channel. This procedure
will be called by the generic trf layer just before reading data from the
channel below the transformation. This way a transformation is able to control
its consumption of characters. An example would be 'identity with stop after n
characters'. This would transfer at most n characters and then basically fake
higher transformations into believing that EOF occured. Then popping it would
reveal the truth. Pattern matching could be used here too (internet protocols
!).
SEE ALSO¶
Trf_Init(3), Trf_SafeInit(3), Trf_IsInitialized(3), Trf_CreateOptions(3),
Trf_DeleteOptions(3), Trf_CheckOptions(3), Trf_SetOption(3),
Trf_SetObjOption(3), Trf_QueryOptions(3), Trf_SeekQueryOptions(3),
Trf_WriteProc(3), Trf_CreateCtrlBlock(3), Trf_DeleteCtrlBlock(3),
Trf_TransformCharacter(3), Trf_TransformBuffer(3), Trf_FlushTransformation(3),
Trf_ClearCtrlBlock(3), Trf_Register(3), Trf_ConverterOptions(3),
Trf_MDStart(3), Trf_MDUpdate(3), Trf_MDUpdateBuf(3), Trf_MDFinal(3),
Trf_MDCheck(3), Trf_RegisterMessageDigest(3), Trf_LoadLibrary(3),
Trf_XorBuffer(3), Trf_ShiftRegister(3), Trf_FlipRegisterShort(3),
Trf_FlipRegisterLong(3), Trf_InitStubs(3)
