JNI 문자열 처리 함수

From Evernote:

JNI 문자열 처리 함수

Clipped from: http://docs.oracle.com/javase/7/docs/technotes/guides/jni/spec/functions.html#string_operations

문자열 생성

jstring NewString(JNIEnv *env, const jchar *unicodeChars, jsize len);
Constructs a new java.lang.String object from an array of Unicode characters.
PARAMETERS:
  • env: the JNI interface pointer.
  • unicodeChars: pointer to a Unicode string.
  • len: length of the Unicode string.

RETURNS:
Returns a Java string object, or NULL if the string cannot be constructed.
THROWS:
OutOfMemoryError: if the system runs out of memory.


문자열의 길이
jsize GetStringLength(JNIEnv *env, jstring string);
Returns the length (the count of Unicode characters) of a Java string.
PARAMETERS:
  • env: the JNI interface pointer.
  • string: a Java string object.

RETURNS:
Returns the length of the Java string.


문자열 가져오기
const jchar * GetStringChars(JNIEnv *env, jstring string, jboolean *isCopy);
Returns a pointer to the array of Unicode characters of the string. This pointer is valid until ReleaseStringchars() is called.

If isCopy is not NULL, then *isCopy is set to JNI_TRUE if a copy is made; or it is set to JNI_FALSE if no copy is made.
PARAMETERS:

  • env: the JNI interface pointer.
  • string: a Java string object.
  • isCopy: a pointer to a boolean.

RETURNS:
Returns a pointer to a Unicode string, or NULL if the operation fails.


문자열 메모리 해제
void ReleaseStringChars(JNIEnv *env, jstring string, const jchar *chars);
Informs the VM that the native code no longer needs access to chars. The chars argument is a pointer obtained from string using GetStringChars().
PARAMETERS:

  • env: the JNI interface pointer.
  • string: a Java string object.
  • chars: a pointer to a Unicode string.


문자열 생성 (UTF-8)
jstring NewStringUTF(JNIEnv *env, const char *bytes);
Constructs a new java.lang.String object from an array of characters in modified UTF-8 encoding.
PARAMETERS:

  • env: the JNI interface pointer.
  • bytes: the pointer to a modified UTF-8 string.

RETURNS:
Returns a Java string object, or NULL if the string cannot be constructed.
THROWS:
OutOfMemoryError: if the system runs out of memory.


문자열의 길이 (UTF-8)
jsize GetStringUTFLength(JNIEnv *env, jstring string);
Returns the length in bytes of the modified UTF-8 representation of a string.
PARAMETERS:
  • env: the JNI interface pointer.
  • string: a Java string object.

RETURNS:
Returns the UTF-8 length of the string.


문자열 가져오기 (UTF-8)
const char * GetStringUTFChars(JNIEnv *env, jstring string, jboolean *isCopy);
Returns a pointer to an array of bytes representing the string in modified UTF-8 encoding. This array is valid until it is released by ReleaseStringUTFChars().
If isCopy is not NULL, then *isCopy is set to JNI_TRUE if a copy is made; or it is set to JNI_FALSE if no copy is made.
PARAMETERS:
  • env: the JNI interface pointer.
  • string: a Java string object.
  • isCopy: a pointer to a boolean.

RETURNS:
Returns a pointer to a modified UTF-8 string, or NULL if the operation fails.


문자열 메모리 해제 (UTF-8)
void ReleaseStringUTFChars(JNIEnv *env, jstring string, const char *utf);
Informs the VM that the native code no longer needs access to utf. The utf argument is a pointer derived from string using GetStringUTFChars().
PARAMETERS:
  • env: the JNI interface pointer.
  • string: a Java string object.
  • utf: a pointer to a modified UTF-8 string.

부분 문자열 가져오기

void GetStringRegion(JNIEnv *env, jstring str, jsize start, jsize len, jchar *buf);
Copies len number of Unicode characters beginning at offset start to the given buffer buf.
THROWS:
StringIndexOutOfBoundsException on index overflow.


부분 문자열 가져오기 (UTF-8)
void GetStringUTFRegion(JNIEnv *env, jstring str, jsize start, jsize len, char *buf);
Translates len number of Unicode characters beginning at offset start into modified UTF-8 encoding and place the result in the given buffer buf.
THROWS:
StringIndexOutOfBoundsException on index overflow.



문자열 가져오기 / 해제하기
const jchar * GetStringCritical(JNIEnv *env, jstring string, jboolean *isCopy);
void ReleaseStringCritical(JNIEnv *env, jstring string, const jchar *carray);
The semantics of these two functions are similar to the existing Get/ReleaseStringChars functions. If possible, the VM returns a pointer to string elements; otherwise, a copy is made. However, there are significant restrictions on how these functions can be used. In a code segment enclosed by Get/ReleaseStringCritical calls, the native code must not issue arbitrary JNI calls, or cause the current thread to block.
The restrictions on Get/ReleaseStringCritical are similar to those on Get/ReleasePrimitiveArrayCritical.

댓글

댓글 쓰기

이 블로그의 인기 게시물

자바 암호화 확장 (JCE) 관련 자바 1.8.0_151 이후 변경 사항

이미지
Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 보다 강력한 암호화 운용방식을 지원하기 위해서 '자바 암호화 확장'을 다운받아 설치해야 하는데, 이전까지는 local_policy.jar , US_export_policy.jar 두 개의 파일을 <java-home>/lib/security 폴더에 저장해두는 방식이었다. 그러나, 자바 8 151 버전 이후부터는 폴더 구조가 변경되어 <java-home>/lib/security/policy 폴더가 생겼으며 그 안에 limited 와 unlimited 폴더가 있고 각각 local_policy.jar , US_export_policy.jar 두 파일이 존재하므로 오라클 사이트에서 다운로드 받을 필요가 없어졌다. 그리하여, 새로운 활성화 방법은 <java-home>/lib/security/java.security 파일을 열어 826번째 줄에서   crypto.policy=unlimited 의 주석 처리 부분을 제거한다. 또는, 자바 소스 코드에서 Security. setProperty ( "crypto.policy" , "unlimited" ) ; 라고 지정해 줄 수도 있다. 추가하여, 자바 9부터는 기본적으로 unlimited strength가 활성화되어 있다고 한다.
자세한 내용 보기

좌표 변환: 회전 이동

이미지
아래 그림에서와 같이, 원래의 좌표를 (x, y)라 하고, y축으로부터의 각도를 θ라고 하자. 또, 회전 시키고자하는 각도를 δ라 하고, 회전된 좌표를 (x', y')라고 한다. 이 때, 회전의 기준점과 원래의 좌표 사이의 거리를 r이라고 하면, 회전된 이후의 좌표와 회전 기준점 사이의 거리 또한 r로써 동일하다. 수식으로 정리하면, x = r sinθ y = r cosθ x' = r sin(θ+δ) y' = r cos(θ+δ) 삼각함수의 덧셈정리 를 이용하여 x'와 y'를 풀어보면, x' = r (sinθ cosδ + cosθ sinδ)    = r sinθ cosδ + r cosθ sinδ y' = r (cosθ cosδ - sinθ sinδ)    = r cosθ cosδ - r sinθ sinδ x = r sinθ, y = r cosθ이므로, x' = x cosδ + y sinδ y' = y cosδ - x sinδ δ가 반시계방향인 경우에는, x' = x cosδ - y sinδ y' = y cosδ + x sinδ 라는 수식으로 정리될 수 있다. 이렇게 구한 공식을 도형의 각 꼭지점에 대해서 적용하면 회전 이동한 도형을 구할 수 있다. public void rotateBy ( float d , float x0 , float y0) { float dX = x - x0 ; float dY = y - y0 ; double rad = Math . abs ( Math . toRadians (d)) ; float cosD = ( float ) Math . cos (rad) ; float sinD = ( float ) Math . sin (rad) ; if (d>= 0 ) { x = dX * cosD + dY * sinD ; y = dY * cosD
자세한 내용 보기

HTTP POST

Java를 사용한 POST 방식 데이터 전송 및 응답 처리하기 1 public static void main ( String [] args ) { 2 try { 3 //연결 4 URL url = new URL ( "http://www.example.com/post.php" ); 5 HttpURLConnection conn = ( HttpURLConnection ) url . openConnection (); 6 conn . setDoOutput ( true ); 7 conn . setRequestMethod ( "POST" ); 8 conn . setRequestProperty ( "Accept-Language" , "ko-kr,ko;q=0.8,en-us;q=0.5,en;q=0.3" ); 9 10 //데이터 11 String param = URLEncoder . encode ( "name" , "UTF-8" ) + "=" + URLEncoder . encode ( "??" , "UTF-8" ); 12 param += "&" + URLEncoder . encode ( "age" , "UTF-8" ) + "=" + URLEncoder . encode ( "??" , "UTF-8" ); 13 14 //전송 15 OutputStreamWriter osw = new OutputStreamWriter ( conn . getOutputStream ()); 16 osw . write ( param ); 17 osw . flush (); 18 19 /
자세한 내용 보기