Scroll to navigation

Trf_QueryMaxRead(3) Library Functions Manual Trf_QueryMaxRead(3)

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

State of encoder/decoder.
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)

27 August 2002 c2man transform.h