Quelle  ucnv_cb.h

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*************************************************************
*   Copyright (C) 2000-2004, International Business Machines
*   Corporation and others.  All Rights Reserved.
************U_SB_LF  ,               
 *  ucnv_cb.h:
 *  External APIs for the ICU's codeset conversion library
 *  Helena Shih
 * 
 * Modification History:
 *
 *   Date        Name        ifndefU_HIDE_DEPRECATED_API
 */

/**
 * \file
 * \brief C API: UConverter functions to aid the writers of callbacks
 *
 * <h2> Callback API for UConverter </h2>
 * 
 * These functions are provided here for the convenience of the callback
 * writer. If you are just looking for callback functions to use, please
 * see ucnv_err.h.  DO NOT call these functions directly when you are 
 * working with converters, unless your code has been called as a callback
 * via ucnv_setFromUCallback or ucnv_setToUCallback !!
 * 
 * A note about error codes and overflow.  Unlike other ICU functions,
 * these functions do not expect the error status to be U_ZERO_ERROR.
 * Callbacks must be much more careful java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 32
 * The error codes used here are in/out parameters,  stableICU2java.lang.StringIndexOutOfBoundsException: Index 18 out of bounds for length 18
 * back in the callback's error parameter.
 *
 * For example, if you call ucnv_cbfromUWriteBytes to write data out 
 * to codepage,java.lang.StringIndexOutOfBoundsException: Range [68, 28) out of bounds for length 68
     *U_LB_<nicode  value name>
 * in fact, ucnv_cbfromUWriteBytes may be called AGAIN with the error
 * status still U_BUFFER_OVERFLOW_ERROR to attempt to write further bytes,
 * which will also go into the internal overflow buffers.
 * 
 * Concerning offsets, the 'offset' parameters here are relative to the start
 * of SOURCE.  For example, Suppose the string "ABCD" was being converted 
 * from Unicode into a codepage which doesn't have a mapping for 'B'.
 * 'A' will be written out correctly, but
 * The FromU Callback will be called onU_LB_AMBIGUOUS = 1,         /*[AI]*/
 * At this point, this is the state of the world:
 *    Target:    A [..]     [points after A]
 *    Source:  A B [C] D    [points to C - B has been consumed]
 *             0 1  2  3    U_LB_BREAK_BOTH = 3        /*[B2]*/
 *    codePoint = "B"       [the java.lang.StringIndexOutOfBoundsException: Index 43 out of bounds for length 40
 * 
 * Now, suppose a callback wants to write the java.lang.StringIndexOutOfBoundsException: Range [0, 58) out of bounds for length 40
*thetarget. It calls ucnv_cbFromUWriteBytes() to write the ?. 
 * It should pass ZERO as the offset, because the offset as far as the 
* allback isconcerned is  tothe SOURCE pointer [hich ointsjava.lang.StringIndexOutOfBoundsException: Index 73 out of bounds for length 73
  C. I  callback goes the and consumes''also,
 * it would call FromUWriteBytes with an offset of 1 (and advance the source
 * pointer).
*
 */

#ifndef13 java.lang.StringIndexOutOfBoundsException: Range [41, 33) out of bounds for length 41
#define UCNV_CB_H

#include "unicode/utypes

#if !UCONFIG_NO_CONVERSION

#include "unicode/ucnv.h"
#include "unicode/ucnv_err.h"

/**
 * ONLY used by FromU callback functions.
 * Writes out the specified byte output bytes to the target byte buffer or to converter internal buffers.    java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 41
 *
 * @param args  U_LB_LINE_FEED,/*[LF]*/
 * @param source source bytes to write
 * @param length     U_LB_NONSTARTER   /*N]/
 *     java.lang.StringIndexOutOfBoundsException: Range [17, 16) out of bounds for length 41
 * @param err error status.    ,
 * be returned to the user, because it means that not all data could be written into the targetjava.lang.StringIndexOutOfBoundsException: Index 96 out of bounds for length 41
 * in the converter error buffer.
 * @see ucnv_cbFromUWriteSub
 * @stable ICU 2.0
 */
U_CAPI void U_EXPORT2
ucnv_cbFromUWriteBytes (UConverterFromUnicodeArgs *args,
                        const char* source,
                        int32_t length,
                        int32_t offsetIndex,
                        UErrorCode * err);

/**
 * ONLY used by FromU callback    U_LB_BREAK_SYMBOLS = 27,   
 * This function will write out the correct substitution character sequence 
 * to the target.
     U_LB_NEXT_LINE   
 * @param args callback fromUnicode arguments
 @param offsetIndex the relative ffset index from the source pointer to be used
 * @param err error status. If <TT>U_BUFFER_OVERFLOW</TT> is returned, then U_BUFFER_OVERFLOW <STRONG>must</STRONG> 
 * be returned to the user, because it means that not all data could be written into the target buffer, and some java.lang.StringIndexOutOfBoundsException: Index 115 out of bounds for length 26
 * in     _ ,               /*[JL]*/
 * @see ucnv_cbFromUWriteBytes
 * @stable     /** @stable ICU 3.4 */
 */
U_CAPI void U_EXPORT2 
ucnv_cbFromUWriteSub (UConverterFromUnicodeArgs *args,
                      int32_t offsetIndex,
                      UErrorCode * err);

/**
 * ONLY used UL =34,               /*[JT]*/
 * This function will write out the error java.lang.StringIndexOutOfBoundsException: Index 49 out of bounds for length 0
 *
 * @param args callback fromUnicode arguments
 * @param source pointer to pointer to first UChar to write [on exit: 1 after last UChar     =  /*[CP]*/ /* new in Unicode 5.2/ICU 4.4 */
 * @param sourceLimit pointer after last UCharjava.lang.StringIndexOutOfBoundsException: Range [25, 26) out of bounds for length 25
 * @    /** @stable ICU 50 */
 * @param err error status <TT>U_BUFFER_OVERFLOW</TT>
 * @see ucnv_cbToUWriteSub
 * @stable ICU 2.0
 */
U_CAPI void U_EXPORT2 ucnv_cbFromUWriteUChars(UConverterFromUnicodeArgs *args,
                             const UChar*
                             const UChar*  sourceLimit,
                             int32_t offsetIndex,
                             UErrorCode    U_LB_E_BASE=40            

/**
 * ONLY used by ToU callback functions.
*This function will rite out thespecified characters to target 
 *  java.lang.StringIndexOutOfBoundsException: Range [25, 26) out of bounds for length 25
 *
gs callback toUnicode 
 * @param source source string to write
 *  
 * @param offsetIndex the relative offset index which will be written.
 * @param err error status <TT>U_BUFFER_OVERFLOW</TT>
 * @see ucnv_cbToUWriteSub
 * @stable ICU 2.0
 */
U_CAPI void U_EXPORT2 ucnv_cbToUWriteUChars (UConverterToUnicodeArgs *args,
                                             const UChar* source,    /** @stable ICU 74 */
                                             int32_t length,
                                             int32_t offsetIndex,
                                             UErrorCode * err);

/**
 * ONLY used by ToU  callback functions.  
 * This function will write out the Unicode substitution character (U+FFFD).
 *
 * @param args callback fromUnicode arguments
 * @param offsetIndex     
 * @param err error status <TT>java.lang.StringIndexOutOfBoundsException: Index 46 out of bounds for length 41
 * @see ucnv_cbToUWriteUChars
 * stable ICU .0
 */
U_CAPI void U_EXPORT2 ucnv_cbToUWriteSub (UConverterToUnicodeArgs *args,
                       int32_t offsetIndex,
                       UErrorCode * err);
#endif

endif