41.1. pl/무지개 토토 함수 및 인수

pl/무지개 토토 언어에서 함수를 만들려면 표준을 사용하십시오PostgreSQL : 문서 : 9.0 : 배트맨 토토 만들기구문 :

기능 생성funcName(Argument-types) 반환return-type$$
    # pl/무지개 토토 기능 본체
$$ 언어 pl무지개 토토;

함수의 본문은 일반적인 무지개 토토 코드입니다. 사실, PL/무지개 토토 접착제 코드는 무지개 토토 서브 루틴 안에 랩핑됩니다. pl/무지개 토토 스칼라 컨텍스트에서 기능이 호출되므로 반환 할 수 없습니다. 목록. 비 스칼라 값 (배열, 레코드 및 sets) 아래 논의 된대로 참조를 반환하여.

pl/무지개 토토도 호출 된 익명 코드 블록도 지원합니다.메이저 무지개 토토 사이트 : 문서 : 9.0 : do진술 :

$$
    # pl/무지개 토토 코드
$$ 언어 pl무지개 토토;

익명 코드 블록은 아무런 논증을받지 않습니다 반환 할 수있는 가치는 폐기됩니다. 그렇지 않으면 그것은 단지 동작합니다 함수처럼.

의 구문기능 만들기명령은 함수 본체를 문자열로 작성해야합니다. 끊임없는. 일반적으로 달러 인용문을 사용하는 것이 가장 편리합니다 (보다섹션 4.1.2.412053_12126e '', 당신은 두 배가되어야합니다 단일 견적 마크 (') 및 백 슬래시 (\) 함수 본문에 사용됩니다 (보다섹션 4.1.2.1).

​​인수와 결과는 다른 무지개 토토에서와 같이 처리됩니다. 서브 루틴 : 논쟁이 통과되었습니다@_, 결과 값은로 반환됩니다.return또는 마지막 표현식에서 기능.

예를 들어, 두 개의 정수를 더 많이 반환하는 함수 값은 다음과 같이 정의 될 수 있습니다.

함수 생성 무지개 토토_max (정수, 정수)는 정수를 $$로 반환합니다
    if ($ _ [0] $ _ [1]) return $ _ [0]; 
    반환 $ _ [1];
$$ 언어 plperl;

SQL NULL 값이 함수로 전달되면 인수 값은로 나타납니다."정의되지 않은"in 펄. 위의 함수 정의는 그다지 멋지게 행동하지 않습니다 널 입력으로 (실제로는 마치 마치 0). 우리는 추가 할 수 있습니다엄격한to 만들기위한 함수 정의PostgreSQL더 합리적인 일을하십시오 : if 널 값이 전달되고 함수는 전혀 호출되지 않습니다. 그러나 자동으로 널 결과를 반환합니다. 또는 기능 본문에서 정의되지 않은 입력을 확인할 수 있습니다. 을 위한 예를 들어, 우리가 원한다고 가정 해무지개 토토_max하나의 null과 하나의 unnull 인수가 있습니다 널 값이 아니라 unnull 인수를 반환하려면 :

함수 생성 무지개 토토_max (정수, 정수)는 정수를 $$로 반환합니다
    내 ($ x, $ y) = @_;
    if ($ x 정의되지 않음) 
        정의되지 않은 경우 undef를 반환하십시오. $ y;
        반품 $ y;

    정의되지 않은 경우 $ x를 반환합니다. $ y;
    $ x $ y 인 경우 $ x를 반환합니다.
    반품 $ y;
$$ 언어 plperl;

위와 같이, pl/무지개 토토에서 SQL NULL 값을 반환하려면 함수, 정의되지 않은 값을 반환하십시오. 이것은 할 수 있습니다 기능은 엄격하거나 없어.

참조가 아닌 함수 인수의 모든 것은 표준에있는 문자열PostgreSQL외부 텍스트 표현 관련 데이터 유형. 일반 숫자 또는 텍스트의 경우 유형, 무지개 토토은 옳은 일을하고 프로그래머는 일반적으로 그것에 대해 걱정할 필요가 없습니다. 그러나 다른 경우에는 인수는 더 많은 양식으로 변환해야합니다. 무지개 토토에서 사용할 수 있습니다. 예를 들어,decode_bytea함수를 사용하여 변환 할 수 있습니다 유형의 주장BYTEA에스코퍼로 이진.

마찬가지로 값이 다시 전달되었습니다PostgreSQL외부 텍스트에 있어야합니다 표현 형식. 예를 들어,encode_bytea함수를 사용하여 탈출 할 수 있습니다 유형의 반환 값에 대한 이진 데이터BYTEA.

무지개 토토이 반환 할 수 있습니다PostgreSQL무지개 토토 어레이에 대한 참조로 배열. 예는 다음과 같습니다.

함수 생성 또는 교체 반환 _array ()
텍스트 [] []를 $$로 반환합니다
    반환 [[ 'A "B', 'C, D'], [ 'e \\ f', 'g']];
$$ 언어 plperl;

returns_array (); 선택

복합 유형 인수는 다음과 같은 함수로 전달됩니다 해시에 대한 참조. 해시의 키는 속성입니다 복합 유형의 이름. 예는 다음과 같습니다.

테이블 직원 생성 (
    이름 텍스트,
    기본 정수,
    보너스 정수
);

Function Empcomp (Employee)는 정수를 $$로 반환합니다
    내 ($ emp) = @_;
    return $ emp- basesalary + $ emp- 보너스;
$$ 언어 plperl;

직원의 이름, Empcomp (Employee.*)를 선택하십시오.

PL/무지개 토토 함수는 복합 유형 결과를 사용하여 반환 할 수 있습니다 동일한 접근법 : 필요한 속성. 예를 들어:

타입 타입 testrowperl (f1 Integer, f2 텍스트, f3 텍스트);

function perl_row ()를 작성하거나 바꾸십시오
    return f2 = 'hello', f1 = 1, f3 = 'world';
$$ 언어 plperl;

perl_row ();에서 *를 선택하십시오.

신고 된 결과 데이터 유형의 모든 열이 아닌 해시에 존재하면 널 값으로 반환됩니다.

pl/무지개 토토 함수는 스칼라 또는 스칼라 세트를 반환 할 수 있습니다. 복합 유형. 일반적으로 a에서 행을 반환하고 싶을 것입니다 시간, 시작 시간을 가속화하고 대기 시간을 유지하는 시간 전체 결과는 메모리를 설정합니다. 당신은로 이것을 할 수 있습니다.return_next아래 그림과 같이. 마지막으로return_next, 당신은 둘 중 하나를 넣어야합니다return또는 (더 나은)반환 undef.

함수 생성 또는 교체 perl_set_int (int)
정수를 $$로 반환합니다
    foreach (0 .. $ _ [0]) 
        return_next ($ _);

    Undef를 반환하십시오.
$$ 언어 plperl;

perl_set_int (5)에서 *를 선택하십시오.

함수 생성 또는 교체 perl_set ()
setof testrowperl을 $$로 반환합니다
    return_next (f1 = 1, f2 = 'hello', f3 = 'world');
    return_next (f1 = 2, f2 = 'hello', f3 = 'postgresql');
    return_next (f1 = 3, f2 = 'hello', f3 = 'pl/무지개 토토');
    Undef를 반환하십시오.
$$ 언어 plperl;

작은 결과 세트의 경우 배열에 대한 참조를 반환 할 수 있습니다. 여기에는 스칼라, 어레이에 대한 참조 또는 참조가 포함되어 있습니다 간단한 유형, 배열 유형 및 복합 유형의 해시. 각기. 다음은 반환의 간단한 예입니다 배열 참조로 전체 결과 세트 :

함수 생성 또는 교체 perl_set_int (int) 정수를 $$로 설정합니다.
    반환 [0 .. $ _ [0]];
$$ 언어 plperl;

perl_set_int (5)에서 *를 선택하십시오.

function perl_set ()을 setsof testrowperl로 $$로 반환합니다.
    반품 [
        f1 = 1, f2 = 'hello', f3 = 'world',
        f1 = 2, f2 = 'hello', f3 = 'postgresql',
        f1 = 3, f2 = 'hello', f3 = 'pl/무지개 토토'
    ];
$$ 언어 plperl;

perl_set ();에서 *를 선택하십시오.

사용하려면엄격한Pragma 코드에는 몇 가지 옵션이 있습니다. 일시적인 글로벌 사용을 위해 당신은 할 수 있습니다SET pl무지개 토토.use_stricttrue. 이것은 영향을 미칩니다 후속 편집pl/무지개 토토함수이지만 이미 함수는 없습니다 현재 세션에서 편집되었습니다. 영구적 인 글로벌 사용을 위해 할 수 있습니다 세트pl무지개 토토.use_stricttrue in thepostgresql.conf파일.

특정 기능에서 영구적으로 사용하려면 간단히 할 수 있습니다 놓다:

Strict 사용;

기능 본문의 상단에 있습니다.

the기능Pragma도 제공됩니다 에게use무지개 토토이 버전 인 경우 5.10.0 이상.