PostgreSQL 8.3.3문서
Prev	Fast Backward	Chapter 9. 함수와 연산자	Fast Forward	Next

9.4. 문자열 함수와 연산자

본절에서는 문자열의 값의 조사나 조작을 위한 함수와 연산자에 대해 설명합니다. 여기서의 문자열은 character데이터형,character varying데이터형, 및text데이터형의 값을 포함합니다. 보충 설명이 없는 한, 아래와 같이 나열된 모든 함수는, 모든 데이터형에 대해서 사용할 수 있습니다만,character데이터형을 사용했을 경우, 자동적으로 공백 문자가 패딩되는 잠재적 작용이 있기 때문에 주의해 주세요. 비트 문자열 데이터형에 대해 존재하는 몇개의 함수도 있습니다.

SQL에서는, 인수의 단락에 콤마가 아닌 특정의 키워드를 사용하는 특수한 구문의 문자열 함수 몇 개를 정의하고 있습니다. 자세한 것은Table 9-5을 참조해 주세요. 또한, 이러한 함수는 통상의 함수 호출에 의해 실행되고 있습니다(Table 9-6를 참조해 주세요).

Table 9-5. SQL문자열 함수와 연산자

함수	반환값형	설명	예	결과
`string \|\| string`	`text`	문자열 결합	`'Post' \|\| 'greSQL'`	`PostgreSQL`
`bit_length(string)`	`int`	문자열 내의 비트수	`bit_length('jose')`	`32`
`char_length(string)` or `character_length(string)`	`int`	문자열 내의 문자수	`char_length('jose')`	`4`
`convert(string using conversion_name)`	`text`	특정한 변환명을 사용하여 인코딩을 변경합니다. 변환은 `CREATE CONVERSION`로 정의됩니다. 또한, 이미 정의된 변환명이 있습니다. 사용가능한 변환명에 대해서는 Table 9-7를 참조하세요.	`('PostgreSQL' using iso_8859_1_to_utf8)를 변환한다`
`lower(string)`	`text`	스트링을 소문자로 변환	`lower('TOM')`	`tom`
`octet_length(string)`	`int`	스트링내의 바이트수	`octet_length('jose')`	`4`
`overlay(string placing string from int [for int ])`	`text`	서브스트링의 치환	`overlay('Txxxxas' placing 'hom' from 2 for 4)`	`Thomas`
`position(substring in string)`	`int`	특정한 서브스트링의 위치	`position('om' in 'Thomas')`	`3`
`substring(string [from int ] [for int ])`	`text`	서브스트링를 추출합니다.	`substring('Thomas' from 2 for 3)`	`hom`
`substring(string from pattern )`	`text`	POSIX 정규 표현에 일치하는 서브스트링을 추출합니다. 패턴 매칭에 관해서보다 자세한 것은,Section 9.7을 참조해 주세요.	`substring('Thomas' from '...$')`	`mas`
`substring(string from pattern for escape )`	`text`	SQL정규 표현에 일치하는 서브스트링을 추출합니다. 패턴 매칭에 관해서보다 자세한 것은,Section 9.7을 참조해 주세요.	`substring('Thomas' from '%#"o_a#"_' for '#')`	`oma`
`trim([leading \| trailing \| both] [ characters ] from string)`	`text`	`characters`(디폴트는 공백)로 지정된 문자만을 포함한 가장 긴 문자열을,`string`의 선두, 말미, 그리고 그 양쪽 모두로부터 삭제합니다.	`trim(both 'x' from 'xTomxx')`	`Tom`
`upper(string)`	`text`	문자열을 대문자로 변환	`upper('tom')`	`TOM`

이 외,Table 9-6에 열거하는 스트링 조작 함수를 사용할 수 있습니다. 그 중 몇 개는,Table 9-5그리고 열거된 표준SQL의 스트링 함수를 실행하기 위해, 내부적으로 사용됩니다.

Table 9-6. 그 외의 스트링 함수

함수	반환값형	설명	예	결과
`ascii(string)`	`int`	인수의 최초 바이트의ASCII코드	`ascii('x')`	`120`
`btrim(string text [, characters text ])`	`text`	`characters`(디폴트는 공백 문자)로 지정된 문자만을 가지는 최장의 문자열을,`string`의 선두와 말미로부터 삭제합니다.	`btrim('xyxtrimyyx', 'xy')`	`trim`
`chr(int)`	`text`	주어진 ASCII코드의 문자.	`chr(65)`	`A`
`convert(string text, [ src_encoding name,] dest_encoding name)`	`text`	문자열을 `dest_encoding`로 변환합니다. 원래의 인코딩은 `src_encoding`로 지정됩니다. `src_encoding`이 생략될 경우, 데이터베이스 인코딩이 사용됩니다.	`convert( 'text_in_utf8', 'UTF8', 'LATIN1')`	ISO 8859-1 인코딩 방식의`text_in_utf8`
`decode(string text, type text)`	`bytea`	이전에`encode()`로 인코드된`string`로부터 바이너리 데이터를 복호화합니다. 파라미터의 형태는`encode()`와 같습니다.	`decode('MTIzAAE=', 'base64')`	`123\000\001`
`encode(data bytea, type text)`	`text`	바이너리 데이터를 다른 표현 방식으로 인코드합니다. 지원되고 있는 형태는,`base64`,`hex`,`escape`입니다. `escape`는 단지 null바이트를`\000`과 같이 출력해, 백슬래시를 이중화합니다.	`encode( E'123\\000\\001', 'base64')`	`MTIzAAE=`
`initcap(string)`	`text`	각각의 단어의 첫번째 문자를 대문자로 변환하고, 나머지는 소문자로 남깁니다. 여기서 단어는, 영숫자 이외의 문자로 단락지어진, 영숫자 문자의 시퀀스입니다.	`initcap('hi THOMAS')`	`Hi Thomas`
`length(string)`	`int`	`string`내의 문자수	`length('jose')`	`4`
`lpad(string text, length int [, fill text ])`	`text`	문자`fill`(디폴트는 공백 문자)를 문자의 전에 추가해,`string`를`length`길이로 채웁니다. `string`가 이미`length`의 길이를 넘고 있는 경우는(우측을) 잘라 버릴 수 있습니다.	`lpad('hi', 5, 'xy')`	`xyxhi`
`ltrim(string text [, characters text ])`	`text`	`string`의 처음부터,`characters`(디폴트는 스페이스)에서 문자만을 가지는 최장의 문자열을 삭제합니다.	`ltrim('zzzytrim', 'xyz')`	`trim`
`md5(string)`	`text`	`string`의 MD5 해시를 계산해, 16 진수로 결과를 반환합니다.	`md5('abc')`	`900150983cd24fb0 d6963f7d28e17f72`
`pg_client_encoding()`	`name`	현재 클라이언트의 인코딩 방식의 이름.	`pg_client_encoding()`	`SQL_ASCII`
`quote_ident(string text)`	`text`	주어진 문자열을,SQL문의 스트링내에 식별자로서 사용할 수 있도록, 적절한 인용부호를 붙여 반환합니다. 인용부호는, 필요한 경우(예를 들면, 문자열에 식별자로서 사용할 수 없는 문자가 포함되는 경우나, 대문자 변환되는 경우)에게만 추가됩니다. 임베디드된 인용부호는, 적절히 이중화 됩니다.	`quote_ident('Foo bar')`	`"Foo bar"`
`quote_literal(string)`	`text`	주어진 문자열을,SQL문의 문자열내에 문자 리터럴로서 사용할 수 있도록, 적절한 인용부호를 붙여 반환합니다. 임베디드된 단일 인용부호 및 백슬래시는, 적절히 이중화 됩니다.	`quote_literal( 'O\'Reilly')`	`'O''Reilly'`
`regexp_replace(string text, pattern text, replacement text [,flags text])`	`text`	POSIX 정규 표현에 일치하는 서브스링을 치환합니다. 패턴매칭에 관한 자세한 정보는 Section 9.7를 참조하세요.	`regexp_replace('Thomas', '.[mN]a.', 'M')`	`ThM`
`repeat(string text, number int)`	`text`	지정된`number`의 수만큼`string`를 반복합니다.	`repeat('Pg', 4)`	`PgPgPgPg`
`replace(string text, from text, to text)`	`text`	`string`에 출현하는 모든`from`서브스트링을 `to`서브스트링에 치환합니다.	`replace('abcdefabcdef', 'cd', 'XX')`	`abXXefabXXef`
`rpad(string text, length int [, fill text ])`	`text`	문자`fill`(디폴트는 스페이스)를 문자에 추가해,`string`를`length`길이에 채웁니다. `string`가 이미`length`의 길이를 넘고 있는 경우는 잘라 버릴 수 있습니다.	`rpad('hi', 5, 'xy')`	`hixyx`
`rtrim(string text [, characters text ])`	`text`	`string`의 말미로부터,`characters`(디폴트는 스페이스)로 문자만을 가지는 최장의 문자열을 삭제합니다.	`rtrim('trimxxxx', 'x')`	`trim`
`split_part(string text, delimiter text, field int)`	`text`	`string`를`delimiter`로 분할해, 그 결과로부터(1부터 센다) 지정한 필드를 반환합니다.	`split_part('abc~@~def~@~ghi', '~@~', 2)`	`def`
`strpos(string, substring)`	`int`	지정한 서브스트링의 위치를 특정하는(`position(substring in string)` 와 같습니다만, 인수의 시퀀스가 거꾸로 되고 있는 것에 주의해 주세요).	`strpos('high', 'ig')`	`2`
`substr(string, from [, count ])`	`text`	지정한 서브스트링을 추출하는(`substring(string from from for count)`와 같습니다).	`substr('alphabet', 3, 2)`	`ph`
`to_ascii(string text [, encoding text ])`	`text`	`string`를 다른 인코딩방식으로부터ASCII로 변환합니다. `LATIN1`,`LATIN2`,`LATIN9`,`WIN1250`encode 방식으로부터의 변환만을 지원합니다. )	`to_ascii('Karel')`	`Karel`
`to_hex(number int or bigint)`	`text`	`number`를, 동등의 16 진수 표현으로 변환합니다.	`to_hex(2147483647)`	`7fffffff`
`translate(string text, from text, to text)`	`text`	`from`집합으로 지정된 문자와 일치하는`string`에 있는 모든 문자는, 거기에 대응하는`to`로 지정된 문자로 옮겨집니다. set	`translate('12345', '14', 'ax')`	`a23x5`

Table 9-7. Built-in Conversions

변환명 [a]	변환 전의 인코딩 방식	변환 후의 인코딩방식
`ascii_to_mic`	`SQL_ASCII`	`MULE_INTERNAL`
`ascii_to_utf8`	`SQL_ASCII`	`UTF8`
`big5_to_euc_tw`	`BIG5`	`EUC_TW`
`big5_to_mic`	`BIG5`	`MULE_INTERNAL`
`big5_to_utf8`	`BIG5`	`UTF8`
`euc_cn_to_mic`	`EUC_CN`	`MULE_INTERNAL`
`euc_cn_to_utf8`	`EUC_CN`	`UTF8`
`euc_jp_to_mic`	`EUC_JP`	`MULE_INTERNAL`
`euc_jp_to_sjis`	`EUC_JP`	`SJIS`
`euc_jp_to_utf8`	`EUC_JP`	`UTF8`
`euc_kr_to_mic`	`EUC_KR`	`MULE_INTERNAL`
`euc_kr_to_utf8`	`EUC_KR`	`UTF8`
`euc_tw_to_big5`	`EUC_TW`	`BIG5`
`euc_tw_to_mic`	`EUC_TW`	`MULE_INTERNAL`
`euc_tw_to_utf8`	`EUC_TW`	`UTF8`
`gb18030_to_utf8`	`GB18030`	`UTF8`
`gbk_to_utf8`	`GBK`	`UTF8`
`iso_8859_10_to_utf8`	`LATIN6`	`UTF8`
`iso_8859_13_to_utf8`	`LATIN7`	`UTF8`
`iso_8859_14_to_utf8`	`LATIN8`	`UTF8`
`iso_8859_15_to_utf8`	`LATIN9`	`UTF8`
`iso_8859_16_to_utf8`	`LATIN10`	`UTF8`
`iso_8859_1_to_mic`	`LATIN1`	`MULE_INTERNAL`
`iso_8859_1_to_utf8`	`LATIN1`	`UTF8`
`iso_8859_2_to_mic`	`LATIN2`	`MULE_INTERNAL`
`iso_8859_2_to_utf8`	`LATIN2`	`UTF8`
`iso_8859_2_to_windows_1250`	`LATIN2`	`WIN1250`
`iso_8859_3_to_mic`	`LATIN3`	`MULE_INTERNAL`
`iso_8859_3_to_utf8`	`LATIN3`	`UTF8`
`iso_8859_4_to_mic`	`LATIN4`	`MULE_INTERNAL`
`iso_8859_4_to_utf8`	`LATIN4`	`UTF8`
`iso_8859_5_to_koi8_r`	`ISO_8859_5`	`KOI8`
`iso_8859_5_to_mic`	`ISO_8859_5`	`MULE_INTERNAL`
`iso_8859_5_to_utf8`	`ISO_8859_5`	`UTF8`
`iso_8859_5_to_windows_1251`	`ISO_8859_5`	`WIN1251`
`iso_8859_5_to_windows_866`	`ISO_8859_5`	`WIN866`
`iso_8859_6_to_utf8`	`ISO_8859_6`	`UTF8`
`iso_8859_7_to_utf8`	`ISO_8859_7`	`UTF8`
`iso_8859_8_to_utf8`	`ISO_8859_8`	`UTF8`
`iso_8859_9_to_utf8`	`LATIN5`	`UTF8`
`johab_to_utf8`	`JOHAB`	`UTF8`
`koi8_r_to_iso_8859_5`	`KOI8`	`ISO_8859_5`
`koi8_r_to_mic`	`KOI8`	`MULE_INTERNAL`
`koi8_r_to_utf8`	`KOI8`	`UTF8`
`koi8_r_to_windows_1251`	`KOI8`	`WIN1251`
`koi8_r_to_windows_866`	`KOI8`	`WIN866`
`mic_to_ascii`	`MULE_INTERNAL`	`SQL_ASCII`
`mic_to_big5`	`MULE_INTERNAL`	`BIG5`
`mic_to_euc_cn`	`MULE_INTERNAL`	`EUC_CN`
`mic_to_euc_jp`	`MULE_INTERNAL`	`EUC_JP`
`mic_to_euc_kr`	`MULE_INTERNAL`	`EUC_KR`
`mic_to_euc_tw`	`MULE_INTERNAL`	`EUC_TW`
`mic_to_iso_8859_1`	`MULE_INTERNAL`	`LATIN1`
`mic_to_iso_8859_2`	`MULE_INTERNAL`	`LATIN2`
`mic_to_iso_8859_3`	`MULE_INTERNAL`	`LATIN3`
`mic_to_iso_8859_4`	`MULE_INTERNAL`	`LATIN4`
`mic_to_iso_8859_5`	`MULE_INTERNAL`	`ISO_8859_5`
`mic_to_koi8_r`	`MULE_INTERNAL`	`KOI8`
`mic_to_sjis`	`MULE_INTERNAL`	`SJIS`
`mic_to_windows_1250`	`MULE_INTERNAL`	`WIN1250`
`mic_to_windows_1251`	`MULE_INTERNAL`	`WIN1251`
`mic_to_windows_866`	`MULE_INTERNAL`	`WIN866`
`sjis_to_euc_jp`	`SJIS`	`EUC_JP`
`sjis_to_mic`	`SJIS`	`MULE_INTERNAL`
`sjis_to_utf8`	`SJIS`	`UTF8`
`tcvn_to_utf8`	`WIN1258`	`UTF8`
`uhc_to_utf8`	`UHC`	`UTF8`
`utf8_to_ascii`	`UTF8`	`SQL_ASCII`
`utf8_to_big5`	`UTF8`	`BIG5`
`utf8_to_euc_cn`	`UTF8`	`EUC_CN`
`utf8_to_euc_jp`	`UTF8`	`EUC_JP`
`utf8_to_euc_kr`	`UTF8`	`EUC_KR`
`utf8_to_euc_tw`	`UTF8`	`EUC_TW`
`utf8_to_gb18030`	`UTF8`	`GB18030`
`utf8_to_gbk`	`UTF8`	`GBK`
`utf8_to_iso_8859_1`	`UTF8`	`LATIN1`
`utf8_to_iso_8859_10`	`UTF8`	`LATIN6`
`utf8_to_iso_8859_13`	`UTF8`	`LATIN7`
`utf8_to_iso_8859_14`	`UTF8`	`LATIN8`
`utf8_to_iso_8859_15`	`UTF8`	`LATIN9`
`utf8_to_iso_8859_16`	`UTF8`	`LATIN10`
`utf8_to_iso_8859_2`	`UTF8`	`LATIN2`
`utf8_to_iso_8859_3`	`UTF8`	`LATIN3`
`utf8_to_iso_8859_4`	`UTF8`	`LATIN4`
`utf8_to_iso_8859_5`	`UTF8`	`ISO_8859_5`
`utf8_to_iso_8859_6`	`UTF8`	`ISO_8859_6`
`utf8_to_iso_8859_7`	`UTF8`	`ISO_8859_7`
`utf8_to_iso_8859_8`	`UTF8`	`ISO_8859_8`
`utf8_to_iso_8859_9`	`UTF8`	`LATIN5`
`utf8_to_johab`	`UTF8`	`JOHAB`
`utf8_to_koi8_r`	`UTF8`	`KOI8`
`utf8_to_sjis`	`UTF8`	`SJIS`
`utf8_to_tcvn`	`UTF8`	`WIN1258`
`utf8_to_uhc`	`UTF8`	`UHC`
`utf8_to_windows_1250`	`UTF8`	`WIN1250`
`utf8_to_windows_1251`	`UTF8`	`WIN1251`
`utf8_to_windows_1252`	`UTF8`	`WIN1252`
`utf8_to_windows_1253`	`UTF8`	`WIN1253`
`utf8_to_windows_1254`	`UTF8`	`WIN1254`
`utf8_to_windows_1255`	`UTF8`	`WIN1255`
`utf8_to_windows_1256`	`UTF8`	`WIN1256`
`utf8_to_windows_1257`	`UTF8`	`WIN1257`
`utf8_to_windows_866`	`UTF8`	`WIN866`
`utf8_to_windows_874`	`UTF8`	`WIN874`
`windows_1250_to_iso_8859_2`	`WIN1250`	`LATIN2`
`windows_1250_to_mic`	`WIN1250`	`MULE_INTERNAL`
`windows_1250_to_utf8`	`WIN1250`	`UTF8`
`windows_1251_to_iso_8859_5`	`WIN1251`	`ISO_8859_5`
`windows_1251_to_koi8_r`	`WIN1251`	`KOI8`
`windows_1251_to_mic`	`WIN1251`	`MULE_INTERNAL`
`windows_1251_to_utf8`	`WIN1251`	`UTF8`
`windows_1251_to_windows_866`	`WIN1251`	`WIN866`
`windows_1252_to_utf8`	`WIN1252`	`UTF8`
`windows_1256_to_utf8`	`WIN1256`	`UTF8`
`windows_866_to_iso_8859_5`	`WIN866`	`ISO_8859_5`
`windows_866_to_koi8_r`	`WIN866`	`KOI8`
`windows_866_to_mic`	`WIN866`	`MULE_INTERNAL`
`windows_866_to_utf8`	`WIN866`	`UTF8`
`windows_866_to_windows_1251`	`WIN866`	`WIN`
`windows_874_to_utf8`	`WIN874`	`UTF8`
Notes: a. 변환명은, 표준 명명 체계를 따르고 있습니다. 영숫자 이외의 문자가 밑줄로 치환된 변환전의 인코딩 방식의 공식 명칭의 뒤로`_to_`를 붙일 수 있어 그 후에, 동등하게 처리된 변환 후의 인코딩 방식명이 계속됩니다. 따라서, 이러한 명칭은 관습적인 코드명과는 다를 가능성이 있습니다.

Prev	Home	Next
산술 함수와 연산자	Up	바이너리 문자열함수와 연산자