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...
자세한 내용 보기

유니코드 한글 자소 문자 처리

이미지
한글 음절 문자를 자소 단위로 분해하거나 또는 반대로 자소 문자들을 합쳐서 하나의 음절 문자로 만드는 자바 소스 코드이다. 이에 관한 간략한 배경 지식이 필요한 경우, 이 글 을 참고하기 바란다. package  kr.pe.elex.hangeul; /** * Created by Elex on 2014-07-11. */ public class  HCharacter {      //  한글 음절              protected static final char  HANGEUL_SYLLABLE_BEGIN  =  '   \uAC00 '   ;      protected static final char  HANGEUL_SYLLABLE_END  =  '   \uD7AF '   ;      //  한글 자모              protected static final char  HANGEUL_JAMO_BEGIN  =  '   \u1100   ' ;      protected static final char  HANGEUL_JAMO_END  =  '   \u11FF   ' ;      protected static final char  HANGEUL_JAMO_CHOSEONG_BEGIN  =  '   \u1100 ...
자세한 내용 보기