/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
*
*/



//  INCLUDE FILES
#include <jutils.h>

/*
 * The following macro makes it possible to transfer data from a descriptor
 * to a java byte array
 */
#define JAVA_PTR(aPtr) reinterpret_cast< jbyte * >( const_cast< unsigned char * >( aPtr ) )


/**
* Sets an error code to the first element of given Java int array.
*
* @param aJniEnv Pointer to JNI environment.
* @param aErrorTo Java int array, where to put the error code.
* @param aErrorFrom Error code.
*
* @par Notes:
* @li The function panics if the array does not have at least one element.
*/
void STSSetJavaErrorCode(
    JNIEnv* aJniEnv,
    jintArray aErrorTo,
    const TInt& aErrorFrom);

/**
 * Creates a java string array to a native string array.
 *
 * @param aJniEnv JNI environment.
 * @param aJavaArray Java string array.
 *
 * @return Native string array, elements converted from \a aJavaArray.
 *
 * @par Notes:
 * @li It is assumed that the object array contains only jstring objects.
 * Object type is \b not checked.
 *
 * @par Leaving:
 * @li Any - internal error (probably OOM).
 */
CDesCArrayFlat* STSCreateNativeStringArrayL(
    JNIEnv* aJniEnv,
    jobjectArray aJavaArray);


/**
 * Creates Java string array from native string array.
 *
 * @param aJniEnv JNI environment.
 * @param aNativeArray Native string array.
 * @param aConvertPIMNullArrayElements If ETrue, KPIMNullArrayElement
 *        elements are converted to NULL elements; otherwise they
 *        are not handled specially.
 *
 * @return Java string array, elements converted from \a aNativeArray
 *         or NULL on error (probably OOM).
 */
jobjectArray CreateJavaStringArray(
    JNIEnv* aJniEnv,
    const CDesCArray& aNativeArray,
    TBool aConvertPIMNullArrayElements);

// End of File