字符串操作
NewString
jstring NewString(JNIEnv *env, const jchar *unicodeChars,
jsize len);
利用 Unicode 字符数组构造新的 java.lang.String 对象。
参数：
env：JNI 接口指针。
unicodeChars：指向 Unicode 字符串的指针。
返回值：
Java 字符串对象。如果无法构造该字符串，则为 NULL。
抛出：
OutOfMemoryError：如果系统内存不足。
GetStringLength
jsize GetStringLength(JNIEnv *env, jstring string);
参数：
env：JNI 接口指针。
返回值：
Java 字符串的长度。
GetStringChars
const jchar * GetStringChars(JNIEnv *env, jstring string,
jboolean *isCopy);
返回指向字符串的 Unicode 字符数组的指针。该指针在调用 ReleaseStringchars() 前一直有效。
如果 isCopy 非空，则在复制完成后将 *isCopy 设为 JNI_TRUE。如果没有复制，则设为JNI_FALSE。
参数：
env：JNI 接口指针。
返回值：
指向 Unicode 字符串的指针，如果操作失败，则返回NULL。
ReleaseStringChars
void ReleaseStringChars(JNIEnv *env, jstring string,
const jchar *chars);
通知虚拟机平台相关代码无需再访问 chars。参数 chars 是一个指针，可通过 GetStringChars() 从 string 获得。
参数：
env：JNI 接口指针。
NewStringUTF
jstring NewStringUTF(JNIEnv *env, const char *bytes);
利用 UTF-8 字符数组构造新 java.lang.String 对象。
参数：
env：JNI 接口指针。如果无法构造该字符串，则为 NULL。
返回值：
Java 字符串对象。如果无法构造该字符串，则为 NULL。
抛出：
OutOfMemoryError：如果系统内存不足。
GetStringUTFLength
jsize GetStringUTFLength(JNIEnv *env, jstring string);
参数：
env：JNI 接口指针。
返回值：
返回字符串的 UTF-8 长度。
GetStringUTFChars
const char* GetStringUTFChars(JNIEnv *env, jstring string,
jboolean *isCopy);
返回指向字符串的 UTF-8 字符数组的指针。该数组在被ReleaseStringUTFChars() 释放前将一直有效。
如果 isCopy 不是 NULL，*isCopy 在复制完成后即被设为 JNI_TRUE。如果未复制，则设为 JNI_FALSE。
参数：
env：JNI 接口指针。
返回值：
指向 UTF-8 字符串的指针。如果操作失败，则为 NULL。
ReleaseStringUTFChars
void ReleaseStringUTFChars(JNIEnv *env, jstring string,
const char *utf);
通知虚拟机平台相关代码无需再访问 utf。utf 参数是一个指针，可利用 GetStringUTFChars() 从 string 获得。
参数：
env：JNI 接口指针。
数组操作
GetArrayLength
jsize GetArrayLength(JNIEnv *env, jarray array);
参数：
env：JNI 接口指针。
返回值：
数组的长度。
NewObjectArray
jarray NewObjectArray(JNIEnv *env, jsize length,
jclass elementClass, jobject initialElement);
构造新的数组，它将保存类 elementClass 中的对象。所有元素初始值均设为 initialElement。
参数：
env：JNI 接口指针。
返回值：
Java 数组对象。如果无法构造数组，则为 NULL。
抛出：
OutOfMemoryError：如果系统内存不足。
GetObjectArrayElement
jobject GetObjectArrayElement(JNIEnv *env,
jobjectArray array, jsize index);
返回 Object 数组的元素。
参数：
env：JNI 接口指针。
返回值：
Java 对象。
抛出：
ArrayIndexOutOfBoundsException：如果 index 不是数组中的有效下标。
SetObjectArrayElement
void SetObjectArrayElement(JNIEnv *env, jobjectArray array,
jsize index, jobject value);
参数：
env：JNI 接口指针。
抛出：
ArrayIndexOutOfBoundsException：如果 index 不是数组中的有效下标。
ArrayStoreException：如果 value 的类不是数组元素类的子类。
New<PrimitiveType>Array 例程
ArrayType New<PrimitiveType>Array(JNIEnv*env, jsize length);
用于构造新基本类型数组对象的一系列操作。表 4-8 说明了特定的基本类型数组构造函数。用户应把New<PrimitiveType>Array 替换为某个实际的基本类型数组构造函数例程名（见下表），然后将 ArrayType替换为该例程相应的数组类型。
表 4-8 New<PrimitiveType>Array 数组构造函数系列 |
|
|
jfloatArray |
|
参数：
env：JNI 接口指针。
返回值：
Java 数组。如果无法构造该数组，则为 NULL。
Get<PrimitiveType>ArrayElements 例程
NativeType *Get<PrimitiveType>ArrayElements(JNIEnv *env,
ArrayType array, jboolean*isCopy);
一组返回基本类型数组体的函数。结果在调用相应的 Release<PrimitiveType>ArrayElements()函数前将一直有效。由于返回的数组可能是 Java 数组的副本，因此对返回数组的更改不必在基本类型数组中反映出来，直到调用了Release<PrimitiveType>ArrayElements()。
如果 isCopy 不是 NULL，*isCopy 在复制完成后即被设为 JNI_TRUE。如果未复制，则设为 JNI_FALSE。
- 将 Get<PrimitiveType>ArrayElements 替换为表中某个实际的基本类型元素访问器例程名。
- 将 ArrayType 替换为对应的数组类型。
- 将 NativeType 替换为该例程对应的本地类型。
不管布尔数组在 Java 虚拟机中如何表示，GetBooleanArrayElements() 将始终返回一个 jbooleans 类型的指针，其中每一字节代表一个元素（开包表示）。内存中将确保所有其它类型的数组为连续的。
表4-9 Get<PrimitiveType>ArrayElements 访问器例程系列 |
||