stingray.Utf8 네임스페이스 참조

설명

엔진이 사용하는 모든 문자열은 UTF-8 인코딩 문자열입니다.

이 인터페이스는 UTF-8 인코딩 문자열을 처리하기 위한 도우미 함수를 제공합니다. 다만, UTF-8 형식에 대한 지식이 별로 필요하지 않은 상황에서는 문자열을 검사할 필요가 거의 없습니다.

기타 관련 참조 항목

Utilities

함수

location ( string, index ) : integer, integer 지정된 바이트 위치의 문자열을 검사합니다.

매개변수

string :	string	테스트할 문자열입니다.
index :	integer	문자열 검색을 위한 시작 바이트입니다.

반환하는 항목

integer	문자열에서 index 값으로 가리키는 UTF-8 문자가 시작하는 색인입니다. 이 색인은 index 값과 동일할 수도 있고, index 값이 멀티바이트 문자의 가운데 바이트를 가리키는 경우에는 보다 낮은 색인일 수도 있습니다.
integer	문자열에서 다음 번 UTF-8 문자의 색인입니다. 1바이트 문자의 경우 begin + 1입니다. 2바이트 문자의 경우 begin + 2 등입니다.

예를 들어, 엔진에서 다음과 같은 문자열이 UTF-8 형식으로 제공된다고 가정해보겠습니다.

Utf8.location("aa", 1) => 1, 2

Utf8.location("aa", 2) => 2, 3

Utf8.location("aåa", 1) => 1, 2

Utf8.location("aåa", 2) => 2, 4

Utf8.location("aåa", 3) => 2, 4

Utf8.location("aåa", 4) => 4, 5

lower ( string ) : string 문자열을 소문자로 변환하고, 결과를 반환합니다.

매개변수

string :

string

변환할 문자열입니다.

반환하는 항목

string

문자열의 소문자 버전입니다.

upper ( string ) : string 문자열을 대문자로 변환하고, 결과를 반환합니다.

매개변수

string :

string

변환할 문자열입니다.

반환하는 항목

string

문자열의 대문자 버전입니다.

이 함수는 UnicodeData.txt에서 가져온 대문자 매핑을 사용합니다. 이는 로케일 의존적이라는 의미지만 언어별 매핑을 처리하지는 않습니다. 자세한 내용은 Character Properties, Case Mappings & Names FAQ를 참조하십시오.

valid ( string ) : boolean 입력이 유효한 UTF-8 문자열인지 여부를 나타냅니다.

매개변수

string :

string

테스트할 문자열입니다.

반환하는 항목

boolean

문자열이 유효한 UTF-8 문자열이면 true를 반환하고, 문자열에 UTF-8 인코딩 문자가 아닌 문자가 포함되어 있으면 false를 반환합니다.