字符串(JNI)

从java程序中传过去的String对象在本地方法中对应的是jstring类型，jstring类型和c中的char*不同，所以如果你直接当做char*使用的话，就会出错。因此在使用之前需要将jstring转换成为c/c++中的char*，这里使用JNIEnv的方法转换.

下面是访问String的一些方法：
GetStringUTFChars将jstring转换成为UTF-8格式的char*
GetStringChars将jstring转换成为Unicode格式的char*
ReleaseStringUTFChars释放指向UTF-8格式的char*的指针
ReleaseStringChars释放指向Unicode格式的char*的指针
NewStringUTF创建一个UTF-8格式的String对象
NewString创建一个Unicode格式的String对象
GetStringUTFLengt获取 UTF-8格式的char*的长度　
GetStringLength获取Unicode格式的char*的长 度

 

JNI 支持字符串在 Unicode 和 UTF-8 两种编码之间转换。

JNIEXPORT jstring JNICALL  Java_Prompt_getLine(JNIEnv *env, jobject obj, jstring prompt) 
 { 
     char buf[128]; 
     const jbyte *str; 
     str = (*env)->GetStringUTFChars(env, prompt, NULL); 
     if (str == NULL) { //不要忘记检测，否则分配内存失败会抛出异常
         return NULL; /* OutOfMemoryError already thrown */ 
     } 
     printf("%s", str); 
     (*env)->ReleaseStringUTFChars(env, prompt, str); 
     
     /* We assume here that the user does not type more than  * 127 characters */ 
     scanf("%s", buf); 
     return (*env)->NewStringUTF(env, inbuf); 
}

(1)GetStringUTFChars可以把一个 jstring指针（指向JVM内部的Unicode字符序列）转化成一个UTF-8格式的C 字符串。
(2)从GetStringUTFChars 中获取的UTF-8字符串在本地代码中使用完毕后，要使用ReleaseStringUTFChars 告诉 JVM 这个 UTF-8 字符串不会被使用了，因为这个UTF-8字符串占用的内存会被回收。
(3)JNI 函数 NewStringUTF 在本地方法中创建一个新的java.lang.String字符串对象.这个新创建的字符串对象拥有一个与给定的
UTF-8编码的C类型字符串内容相同的 Unicode 编码字符串

UTF-8 字符串以’\0’结尾，而 Unicode 字符串不是。
如果一个jstring指向一个 UTF-8编码的字符串，为了得到这个字符串的字节长度，可以调用标准 C 函数 strlen,当然也可以用GetStringUTFLength

GetStringChars 和 GetStringUTFChars 函数中的第三个参数需要更进一步的解释：
const jchar * GetStringChars(JNIEnv *env, jstring str, jboolean *isCopy);

当从 JNI 函数 GetStringChars 中返回得到字符串B时，如果B是原始字符串java.lang.String 的拷贝，则isCopy被赋值为 JNI_TRUE。
如果B和原始字符串指向的是JVM中的同一份数据，则 isCopy被赋值为 JNI_FALSE。
当 isCopy值为JNI_FALSE时，本地代码决不能修改字符串的内容，否则JVM中的原始字符串也会被修改，这会打破 JAVA语言中字符串不可变的规则。
通常，因为你不必关心 JVM 是否会返回原始字符串的拷贝，你只需要为 isCopy传递NULL作为参数。