/core/str

(마지막 업데이트: 2006년 2월 23일)

문자열 객체를 위한 클래스 파일입니다.

capitalize (T)S

문자열 객체의 첫번째 문자만 대문자로 하고 나머지는 모두 소문자로 변경하고 그에 대한 반환값을 돌려주게 됩니다.

T	문자열 객체
S	변환된 문자열 객체

... spush "hELLO WorlD!"
... call capitalize (T)S

"Hello world!"

center (TI)S

문자열 객체를 두번째 인자(I) 을 폭으로 하고 중앙에 정렬시킵니다. 그 중간에 채워지는 값은 space 값으로 정합니다.

T	문자열 객체
I	폭
S	변환된 문자열 객체

... spush "Welcome to KLDP.net"
... ipush 50
... call center (TI)S

"               Welcome to KLDP.net                "

center (TIC)S

문자열 객체를 두번째 인자(I) 을 폭으로 하고 중앙에 정렬시키는데, 그 중간에 채워지는 문자로 세번째 인자(C) 를 사용합니다.

T	문자열 객체
I	폭을 나타내는 정수
C	채워질 문자 ascii 값
S	변환된 문자열 객체

... spush "Hello ROVM!"
... ipush 30
... cpush 46
... call center (TIC)S

".........Hello ROVM!.........."

count (TS)I

문자열 객체 SELF 에서 두번째 인자(S) 가 몇 번 발견되는지에 대한 결과값을 반환합니다.

T	문자열 객체
S	찾을 문자열 객체
I	발견된 문자열의 횟수

... spush "Hello ROVM! Welcome to new world"
... spush "o"
... call count (TS)I

count (TSI)I

문자열 객체 SELF 에서 두번째 인자(S) 가 몇 번 발견되는지에 대한 결과값을 반환하는데, 문자열의 시작점을 세번째 인자(I)로 합니다.

T	문자열 객체
S	찾을 문자열 객체
I	문자열의 시작점
I	발견된 문자열의 횟수

... spush "Hello ROVM! Welcome to new world"
... spush "o"
... ipush 10
... call count (TSI)I

count (TSII)I

문자열 객체 SELF 에서 두번째 인자(S) 가 몇 번 발견되는지에 대한 결과값을 반환하는데, 문자열의 시작점을 세번째 인자(I)로 하고 끝점을 네번째 인자(I)로 정합니다.

T	문자열 객체
S	찾을 문자열 객체
I	문자열의 시작점
I	문자열의 끝점
I	발견된 문자열의 횟수

... spush "Hello ROVM! Welcome to new world"
... spush "o"
... ipush 10
... ipush 20
... call count (TSII)I

endswitch (TS)B

만약 문자열 객체 SELF 가 두번째 인자(S) 로 끝날 경우, True 를 반환합니다. 그렇지 않을 경우, False 를 반환합니다.

T	문자열 객체
S	찾을 접미어 (Suffix)
B	문자열 객체 SELF 가 접미어로 끝날 경우, True 를 반환하고 그렇지 않을 때는 False 를 반환

... spush "Hello ROVM"
... spush "ROVM"
... call endswith (TS)B

TRUE

endswitch (TSI)B

만약 문자열 객체 SELF 가 두번째 인자(S) 로 끝날 경우, True 를 반환합니다. 그렇지 않을 경우, False 를 반환합니다. 단, 문자열 객체의 시작점은 세번째 인자(I) 로 합니다.

T	문자열 객체
S	찾을 접미어 (Suffix)
I	문자열의 시작점
B	문자열 객체 SELF 가 접미어로 끝날 경우, True 를 반환하고 그렇지 않을 때는 False 를 반환

... spush "Hello ROVM"
... spush "ROVM"
... ipush 7
... call endswith (TSI)B

FALSE

endswitch (TSII)B

만약 문자열 객체 SELF 가 두번째 인자(S) 로 끝날 경우, True 를 반환합니다. 그렇지 않을 경우, False 를 반환합니다. 단, 문자열 객체의 시작점과 끝점을 각각 세번째 인자(I)와 네번째 인자(I)로 합니다.

T	문자열 객체
S	찾을 접미어 (Suffix)
I	문자열의 시작점
I	문자열의 끝점
B	문자열 객체 SELF 가 접미어로 끝날 경우, True 를 반환하고 그렇지 않을 때는 False 를 반환

... spush "Hello ROVM Server"
... spush "ROVM"
... ipush 1
... ipush 10
... call endswith (TSII)B

TRUE

expandtabs (T)S

문자열 객체 SELF 에 존재하는 모든 tab 문자를 space 로 변환하여 반환합니다. 기본적으로 1 tab 문자은 8 space 문자입니다.

T	S
S	Space 로 취환된 문자열 객체

... spush "Hello<tab>ROVM"
... call expandtabs (T)S

""Hello   ROVM""

expandtabs (TI)S

문자열 객체 SELF 에 존재하는 모든 tab 문자를 space 로 변환하여 반환합니다. 단, tab 의 space 수를 두번째 인자(I) 로 정합니다.

T	문자열 객체
I	Tab 크기
S	Space 로 취환된 문자열 객체

... spush "Hello        ROVM"
... ipush 16
... call expandtabs (TI)S

"Hello           ROVM"

find (TS)I

문자열 객체 SELF 에서 두번째 인자(S) 를 검색한 후 그에 대한 가장 하위 index 값을 반환합니다. 만약 발견하지 못하였다면 -1 을 반환하게 됩니다.

T	문자열 객체
S	찾을 문자열 객체
I	찾은 문자열의 가장 하위 index 값. 만약 발견 못하였을 경우, -1 을 반환

... spush "Hello ROVM Server!"
... spush "ROVM"
... call find (TS)I

find (TSI)I

문자열 객체 SELF 에서 두번째 인자(S) 를 검색한 후 그에 대한 가장 하위 index 값을 반환합니다. 단, 문자열의 시작점을 세번째 인자(I) 를 정합니다. 만약 찾고자 하는 문자열을 발견하지 못하였다면 -1 을 반환하게 됩니다.

T	문자열 객체
S	찾을 문자열 객체
I	문자열의 시작점
I	찾은 문자열의 가장 하위 index 값. 만약 발견 못하였을 경우, -1 을 반환

... spush "Hello ROVM Server!"
... spush "ROVM"
... ipush 10
... call find (TSI)I

-1

find (TSII)I

문자열 객체 SELF 에서 두번째 인자(S) 를 검색한 후 그에 대한 가장 하위 index 값을 반환합니다. 단, 문자열의 시작점과 끝점을 각각 세번째 인자(I)와 네번째 인자(I) 로 정합니다. 만약 찾고자 하는 문자열을 발견하지 못하였다면 -1 을 반환하게 됩니다.

T	문자열 객체
S	찾을 문자열 객체
I	문자열의 시작점
I	문자열의 끝점
I	찾은 문자열의 가장 하위 index 값. 만약 발견 못하였을 경우, -1 을 반환

... spush "Hello ROVM Server!"
... spush "Server"
... ipush 10
... ipush 18
... call find (TSII)I

isalnum (T)B

문자열 객체 SELF 가 알파벳과 숫자로 이루어져있을 경우, TRUE 를 그렇지 않을 경우, FALSE 를 반환합니다. 만약 다른 문자가 하나라도 있을 경우 FALSE 입니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	알파벳과 숫자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hello KLDP"
... call isalnum (T)B

FALSE

isalpha (T)B

문자열 객체 SELF 가 알파벳으로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다. 만약 이 외의 문자가 있을 경우, FALSE 입니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	알파벳으로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "HelloKLDP"
... call isalpha (T)B

TRUE

isdigit (T)B

문자열 객체 SELF 가 숫자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	숫자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "0555874171"
... call isdigit (T)B

TRUE

islower (T)B

문자열 객체 SELF 가 알파벳 소문자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	알파벳 소문자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hello"
... call islower (T)B

FALSE

isspace (T)B

문자열 객체 SELF 가 whitespace 로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	Whitespace 로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush " <tab>"
... call isspace (T)B

TRUE

istitle (T)B

문자열 객체 SELF 가 titlecased 문자열일 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다. 예를 들면 알파벳 대문자가 오고 뒤에 소문자가 오늘 경우를 말합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	Titlecased 문자열일 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hello Server"
... call istitle (T)B

TRUE

isupper (T)B

문자열 객체 SELF 가 알파벳 대문자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE 를 반환합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
B	알파벳 대문자로 이루어져 있을 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "HELLO"
... call isupper (T)B

TRUE

join (T[)S

문자열 객체 SELF 를 연결점 (concatenation) 으로 하여 두번째 인자([) 배열을 연결한 문자열을 반환합니다.

T	문자열 객체
[	문자열 배열
S	문자열 배열의 각 요수들이 SELF 로 묶인 문자열

... spush "[hi]"
... ipush 0
... newarray
... dup
... spush "a"
... call append (TS)V
... dup
... spush "b"
... call append (TS)V
... call join (T[)S

"a[hi]b"

ljust (TI)S

문자열 객체 SELF 를 폭(두번째 인자(I)) 을 기준으로 왼쪽 정렬을 합니다. 나머지 공간은 space 로 채워집니다.

T	문자열 객체
I	폭 (width)
S	폭을 기준으로 왼쪽 정렬된 상태의 문자열 객체

... spush "HELLO"
... ipush 10
... call ljust (TI)S

"HELLO     "

ljust (TIC)S

문자열 객체 SELF 를 폭(두번째 인자(I)) 을 기준으로 왼쪽 정렬을 합니다. 나머지 공간은 세번째 인자(C) 로 채워집니다.

T	문자열 객체
I	폭 (width)
C	나머지 공간을 채울 문자
S	폭을 기준으로 왼쪽 정렬된 상태의 문자열 객체

... spush "HELLO"
... ipush 10
... cpush 46
... call ljust (TIC)S

"HELLO....."

lower (T)S

문자열 객체 SELF 에서 알파벳 대문자를 모두 소문자로 변경합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
S	알파벳 대문자에서 소문자로 변경된 문자열 객체

... spush "HELLO"
... call lower (T)S

"hello"

lstrip (T)S

문자열 객체 SELF 에서 첫 부분이 whitespace 로 시작될 경우, 그것을 제거한 문자열을 반환합니다.

T	문자열 객체
S	시작 부분의 whitespace 가 제거된 문자열 객체

... spush "   spacious   "
... call lstrip (T)S

"spacious   "

lstrip (TS)S

문자열 객체 SELF 에서 두번째 인자(S) 에 포함된 문자들을 제거한 결과의 문자열을 반환합니다.

T	문자열 객체
S	제거할 문자들의 집합
S	제거할 문자 집합이 적용된 문자열 객체

... spush "www.example.com"
... spush "cmowz."
... call lstrip (TS)S

"example.com"

replace (TSS)S

문자열 객체 SELF 에서 두번째 인자(S) 문자열을 찾아 세번째 인자(S) 문자열로 변경한 문자열 객체를 반환합니다.

T	문자열 객체
S	찾을 문자열
S	바꿀 문자열
S	문자열 대체가 완료된 문자열 객체

... spush "www.example.com"
... spush "example"
... spush "envalng"
... call replace (TSS)S

"www.envalng.com"

replace (TSSI)S

문자열 객체 SELF 에서 두번째 인자(S) 문자열을 찾아 세번째 인자(S) 문자열로 변경한 문자열 객체를 반환합니다. 단, 네번째 인자(I) 만큼만 변경하게 됩니다.

T	문자열 객체
S	찾을 문자열
S	바꿀 문자열
I	바꿀 최대 횟수
S	문자열 대체가 완료된 문자열 객체

... spush "abc abc abc abc abc"
... spush "bc"
... spush "cd"
... ipush 3
... call replace (TSSI)S

"acd acd acd abc abc"

rfind (TS)I

문자열 객체 SELF 에서 두번째 인자(S) 문자열을 검색하여 발견된 가장 상위 index 를 반환합니다.

T	문자열 객체
S	찾을 문자열
I	발견된 가장 상위 index

... spush "ROVM Client"
... spush "li"
... call rfind (TS)I

rfind (TSI)I

문자열 객체 SELF 에서 두번째 인자(S) 문자열을 검색하여 발견된 가장 상위 index 를 반환합니다. 단, 문자열의 시작점을 세번째 인자(I)로 정합니다.

T	문자열 객체
S	찾을 문자열
I	문자열의 시작점
I	발견된 가장 상위 index

... spush "ROVM Client"
... spush "li"
... ipush 9
... call rfind (TSI)I

-1

rfind (TSII)I

문자열 객체 SELF 에서 두번째 인자(S) 문자열을 검색하여 발견된 가장 상위 index 를 반환합니다. 단, 문자열의 시작점과 끝점을 각각 세번째 인자(I)와 네번째 인자(I) 로 정합니다.

T	문자열 객체
S	찾을 문자열
I	문자열의 시작점
I	문자열의 끝점
I	발견된 가장 상위 index

... spush "ROVM Library"
... spush "Li"
... ipush 4
... ipush 9
... call rfind (TSII)I

rjust (TI)S

문자열 객체 SELF 를 폭(두번째 인자(I)) 을 기준으로 오른쪽 정렬을 합니다. 나머지 공간은 space 로 채워집니다.

T	문자열 객체
I	폭 (width)
C	나머지 공간을 채울 문자
S	폭을 기준으로 오른쪽 정렬된 상태의 문자열 객체

... spush "HELLO"
... ipush 10
... call rjust (TI)S

"     HELLO"

rjust (TIC)S

문자열 객체 SELF 를 폭(두번째 인자(I)) 을 기준으로 오른쪽 정렬을 합니다. 나머지 공간은 세번째 인자(C) 문자로 채워집니다.

T	문자열 객체
I	폭 (width)
C	나머지 공간을 채울 문자
S	폭을 기준으로 오른쪽 정렬된 상태의 문자열 객체

... spush "HELLO"
... ipush 10
... cpush 46
... call rjust (TIC)S

".....HELLO"

rsplit (T)[

문자역 객체 SELF 를 오른쪽부터 whitespace 를 기준으로 자른 문자열 배열을 반환합니다. 오른쪽부터 시작한다는 것만 제외하면 split 메쏘드의 행동과 거의 비슷한 수행을 합니다.

T	문자열 객체
[	오른쪽을 기준으로 자른 문자열 배열

... spush "Welcome to the Korea"
... call rsplit (T)[

[ "Welcome", "to", "the", "Korea" ]

rsplit (TS)[

문자역 객체 SELF 를 오른쪽부터 두번째 인자(S) 문자열을 기준으로 자른 문자열 배열을 반환합니다. 오른쪽부터 시작한다는 것만 제외하면 split 메쏘드의 행동과 거의 비슷한 수행을 합니다.

T	문자열 객체
S	경계점이 되는 문자열 (delimiter string)
[	오른쪽을 기준으로 자른 문자열 배열

... spush "Australia"
... spush "tra"
... call rsplit (TS)[

[ "Aus", "lia" ]

rsplit (TSI)[

문자역 객체 SELF 를 오른쪽부터 두번째 인자(S) 문자열을 기준으로 자른 문자열 배열을 반환합니다. 단, 최대 세번째 인자(I) 갯수만큼만 rsplit 합니다. 오른쪽부터 시작한다는 것만 제외하면 split 메쏘드의 행동과 거의 비슷한 수행을 합니다.

T	문자열 객체
S	경계점이 되는 문자열 (delimiter string)
I	최대 rsplit 갯구
[	오른쪽을 기준으로 자른 문자열 배열

... spush "http://envlang.kldp.net"
... spush "."
... ipush 1
... call rsplit (TSI)[

[ "http://envlang.kldp", "net" ]

rstrip (T)S

문자열 객체 SELF 에서 끝 부분이 whitespace 로 끝날 경우, 그것을 제거한 문자열을 반환합니다.

T	문자열 객체
S	끝 부분의 whitespace 가 제거된 문자열 객체

... spush "   spacious   "
... call rstrip (T)S

"   spacious"

rstrip (TS)S

문자열 객체 SELF 에서 끝 부분이 두번째 인자(S) 문자열의 집합으로 끝날 경우, 그것을 제거한 문자열을 반환합니다.

T	문자열 객체
S	제거할 문자들의 집합
S	끝 부분의 문자열 집합이 제거된 문자열 객체

... spush "mississippi"
... spush "ipz"
... call rstrip (TS)S

"mississ"

split (T)[

SELF 가 StringRef 라는 가정하에, 문자열을 Whitespace 를 기준으로 split 하여 그에 대한 배열을 반환합니다.

T	SELF 객체
[	문자열을 whitespace 기준으로 split 된 상태의 배열입니다.

... spush " now's  the time"
... call split (T)[

["now's", "the", "time"]

split (TS)[

SELF 가 StringRef 라는 가정하에, 문자열을 두번째 argument 를 기준으로 split 하여 그에 대한 배열을 반환합니다.

T	SELF 객체
S	문자열 구분자
[	문자열을 두번째 인자 (StringRef) 기준으로 split 된 상태의 배열입니다.

... spush "mellow yellow"
... spush "ello"
... call split (TS)[

["m", "w y", "w"]

... spush "1,2,,3,4,,"
... spush ","                    
... call split (TS)[

["1", "2", "", "3", "4"]

split (TSI)[

SELF 가 StringRef 라는 가정하에, 문자열을 두번째 argument 를 기준으로 split 하여 그에 대한 배열을 반환합니다. 단, max limit 가 정해져 있습니다.

T	SELF 객체
S	문자열 구분자
I	Max 제한
[	문자열을 두번째 인자 (StringRef) 기준으로 split 된 상태의 배열입니다.

... spush "1,2,,3,4,,"
... spush ","
... ipush 4
... call split (TSI)[

["1", "2", "", "3,4,,"]

splitlines (T)[

문자열 객체 SELF 를 줄 경계점을 기준으로 자른 문자열 배열을 반환합니다. Line breaks 가 포함되지 않습니다.

T	문자열 객체
[	잘라진 문자열 배열

... spush "abc<enter>def"
... call splitlines (T)[

[ "abc", "def" ]

splitlines (TI)[

문자열 객체 SELF 를 줄 경계점을 기준으로 자른 문자열 배열을 반환합니다. 만약 두번째 인자(I) 정수값이 1 일 경우, Line breaks 가 포함되고, 0 일 경우 포함되지 않습니다.

T	문자열 객체
I	Line breaks ('\r' 혹은 '\n') 을 포함할 것인지 여부
[	잘라진 문자열 배열

... spush "abc<enter>def"
... ipush 1
... call splitlines (TI)[

[ "abc\r\n", "def" ]

startswith (TS)B

문자열 객체 SELF 가 두번째 인자(S) 문자열로 시작할 경우 TRUE 를 반환합니다.

T	문자열 객체
S	접두어 (prefix)
B	만약 문자열이 접두어로 시작될 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hye Jin Soang Babo"
... spush "Hye"
... call startswith (TS)B

TRUE

startswith (TSI)B

문자열 객체 SELF 가 두번째 인자(S) 문자열로 시작할 경우 TRUE 를 반환합니다. 그렇지 않을 경우 FALSE 를 반환합니다. 단 문자열의 시작점을 세번째 인자(I)로 합니다.

T	문자열 객체
S	접두어 (prefix)
I	문자열의 시작점
B	만약 문자열이 접두어로 시작될 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hye Jin Soang"
... spush "Jin"
... ipush 5
... call startswith (TSI)B

FALSE

startswith (TSII)B

문자열 객체 SELF 가 두번째 인자(S) 문자열로 시작할 경우 TRUE 를 반환합니다. 그렇지 않을 경우 FALSE 를 반환합니다. 단 문자열의 시작점과 끝점을 각각 세번째 인자(I)와 네번째 인자(I)로 합니다.

T	문자열 객체
S	접두어 (prefix)
I	문자열의 시작점
I	문자열의 끝점
B	만약 문자열이 접두어로 시작될 경우 TRUE, 그렇지 않을 경우 FALSE

... spush "Hye Jin Soang"
... spush "Jin"
... ipush 4
... ipush 10
... call startswith (TSII)B

TRUE

strip (T)S

문자열 객체 SELF 에서 첫 부분과 끝 부분에 whitespace 가 존재할 경우, 이를 제거한 결과값을 반환합니다.

T	문자열 집합
S	첫 부분과 끝 부분의 whitespace 가 제거된 결과값

... spush "   spacious   "
... call strip (T)S

"spacious"

strip (TS)S

문자열 객체 SELF 에서 두번째 인자(S) 문자열 집합이 첫 부분과 끝 부분에 존재할 경우, 이를 제거한 결과값을 반환합니다. 두번째 인자(S) 는 접두어, 접미사가 아니라 문자 집합입니다.

T	문자열 객체
S	제거할 문자들의 집합
S	첫 부분과 끝 부분의 문자 집합이 제거된 결과값

... spush "www.example.com"
... spush "cmowz."
... call strip (TS)S

"example"

swapcase (T)S

문자열 객체 SELF 에서 알파벳 대문자는 소문자로, 소문자는 대문자로 변경한 결과를 반환합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
S	대소문자가 바뀐 문자열 객체

... spush "Hello Jeong"
... call swapcase (T)S

"hELLO jEONG"

title (T)S

문자열 객체 SELF 를 titlecased 문자열로 변환하여 반환합니다.

T	문자열 객체
S	Titlecased 문자열로 변환된 문자열 객체

... spush "rovm developer"
... call title (T)S

"Rovm Developer"

upper (T)S

문자열 객체 SELF 에서 알파벳 소문자를 모두 대문자로 변경합니다.

8 bit 문자를 위한 것으로, 로케일 의존적입니다.

T	문자열 객체
S	알파벳 소문자에서 대문자로 변경된 문자열 객체

... spush "hello"
... call upper (T)S

"HELLO"

zfill (TI)S

문자열 객체 SELF 의 왼쪽을 두번째 인자(I) 을 폭(width) 으로 하여 0 으로 채워넣은 결과를 반환합니다. 만약 폭(width) 이 문자열 길이보다 작을 경우, 원래 문자열이 반환됩니다.

T	문자열 객체
I	폭 (width)
S	두번째 인자(I) 을 폭(width) 으로 하여 0 으로 채워넣은 문자열

... spush "-3.14"
... ipush 7
... call zfill (TI)S

"-003.14"