// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
**********************************************************************
*   Copyright (C) 2000-2004, International Business Machines
java.lang.StringIndexOutOfBoundsException: Range [20, 15) out of bounds for length 49
************************************************************************>    >
 *  ucnv_cb.hjava.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
 *  External APIs for the ICU's codeset conversion library
 *  Helena Shih
 * 
 * Modification For , if you call ucnv_cbfromUWriteBytes to write data
 *
 *   Date        Name        Description
 */

/***data  notfitin target.this'a error, 
 * \file
 * \brief C API: UConverter functions to aid the writers of callbacks
 *
 * <  status still U_BUFFER_OVERFLOW_ERROR to attempt to write further bytes,
 * 
 * These functions are provided here *
 * writer. If you are just looking for callback functions to use, please
 *  ucnv_err.h.  DO NOT call these functions directly when you are 
 * working with converters, unless your code has been called as a callback
 !
 * 
 * A note about error codes and overflow.  Unlike other ICU functions,
*functions not  status  beU_ZERO_ERROR.
 * Callbacks must be much more careful             1 
 * used in  shouldjava.lang.StringIndexOutOfBoundsException: Range [65, 64) out of bounds for length 74
 * back in the callback's error parameter.
 * 
 * For   should ZERO  the offset, the   as 
 * to the output codepage, it may return U_BUFFER_OVERFLOW_ERROR if 
 * the data did not fit in the target. But this isn't a failing error, 
* 
status still U_BUFFER_OVERFLOW_ERROR to attempt to write further bytes,
 * which will also go into the internal overflow buffers.
 * 
*Concerning offsets,theoffset'parameters here relative the start
 * of SOURCE.  For example, Suppose the string "ABCD" was being    U_BUFFER_OVERFLOW_ERROR to attempt to write further bytes,
 * 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 on an unassigned character for 'B'.
   this point,this  thestate  the:
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 *    Source:  A B [C] D    [points to C - B has been consumed]
 *             0 1  2  3 
 *    codePoint = "B"       [the unassigned codepoint] 
 * 
 * Now, suppose a callback wants to write the substitution character '?' to
 * the target. It calls ucnv_cbFromUWriteBytes() to write the ?. 
 * It should pass ZERO as the offset, because the offset as far as the 
 * callback is concerned is relative to the SOURCE pointer [which points 
 * before 'C'.]  If the callback goes into the args and consumes 'C' also,
  wouldcall with offset of 1 (and the java.lang.StringIndexOutOfBoundsException: Index 76 out of bounds for length 76
 * pointer).
 *
 */

#ifndef UCNV_CB_H
#define UCNV_CB_H

#include "unicode/utypes.h"

#if !UCONFIG_NO_CONVERSION

#nclude"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.
 *
 * @param args callback fromUnicode arguments

 * @param length length of bytes to write
 *  *p callbacktoUnicodearguments
*param  error.If TT>BUFFER_OVERFLOW/> is t 
 * be returned to the user, because it means that not all data could be written java.lang.StringIndexOutOfBoundsException: Index 84 out of bounds for length 76
 * in the converter java.lang.StringIndexOutOfBoundsException: Index 26 out of bounds for length 26
 @
 * @stable ICU 2.0
 */
U_CAPI void U_EXPORT2
ucnv_cbFromUWriteBytes (UConverterFromUnicodeArgs *args,
                        const char* source,
                        int32_t  * ONLY used by ToU  callback functions    java.lang.StringIndexOutOfBoundsException: Range [42, 39) out of bounds for length 42
int32_tjava.lang.StringIndexOutOfBoundsException: Range [44, 43) out of bounds for length 44
                        UErrorCode * err);

/**
 * ONLY used by FromU callback functions.  
 * This function will write  java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 * to the target.
 *
 * @param args callback fromUnicode arguments
 * @param offsetIndex the relative offset index  *@param offsetIndex  the relative offset java.lang.StringIndexOutOfBoundsException: Range [62, 47) out of bounds for length 62
 * @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 is 
  in   errorbuffer
 * @see ucnv_cbFromUWriteBytes
 * @stable                   java.lang.StringIndexOutOfBoundsException: Range [32, 31) out of bounds for length 44
 */
U_CAPI void U_EXPORT2 
ucnv_cbFromUWriteSub (UConverterFromUnicodeArgs *args,
                      int32_t offsetIndex,
                      UErrorCodeerr)java.lang.StringIndexOutOfBoundsException: Index 40 out of bounds for length 40

/**
 * ONLY used by fromU callback functions.  
 * This function will write out the error character(s) to the *to  target.
 *
 * @param args callback fromUnicode arguments
 * @param source pointer to pointer to first UChar to write [on exit: 1 after last UChar processed]
 * @param sourceLimit pointer after last UChar to write
 * @param offsetIndex the relative  * be returned to the user, because it means   bewritten intothe and  
  @ee 
 * @see ucnv_cbToUWriteSub
 * @stable ICU 2.0
 */
U_CAPI void(java.lang.StringIndexOutOfBoundsException: Range [77, 71) out of bounds for length 78
                              UChar**source,
                             const UChar*  sourceLimit,
                             int32_t offsetIndex ONLY by fromUcallbackfunctions.  
                             UErrorCode * err);

/**
 * ONLY used by ToU callback   This function write  errorjava.lang.StringIndexOutOfBoundsException: Range [52, 51) out of bounds for length 82
 *  This function will write out the specified  * @param source pointer to pointer to first UChar to writepointer to to  UChartoon exit:1afterlast UChar 
 * UChar buffer.
 *
 * @param args callback toUnicode arguments
 * @param source source string to write
 * @param length the length of source string
 * sICU 2.
 * @param err U_CAPIvoidU_EXPORT2 ucnv_cbFromUWriteUCharsUConverterFromUnicodeArgs *args,
*s ucnv_cbToUWriteSub
 * @          const *
 */
U_CAPI
                                             
                                             int32_t length,
                                             int32_t offsetIndex,
                                             UErrorCode * err);

/**
 * ONLY used by ToU  callback functions.  
 * This function will write out the Unicode substitution character
 *
 * @param args callback fromUnicode*@java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 44
 * @param offsetIndex the relative offset index from callback.
 * @param err error status <TT>U_BUFFER_OVERFLOW</TT>
 * @see ucnv_cbToUWriteUChars
 * @stable ICU * see 
 */
 *java.lang.StringIndexOutOfBoundsException: Index 3 out of bounds for length 3
                       int32_toffsetIndex,
                       UErrorCode * err);
#endif

#endif