롤 토토 — 주어진 행의 선택된 필드를 대체하여 행 생성
HeapTuple 롤 토토(관계rel, HeapTuple행, 정수ncols, 정수 *열, 데이텀 *값, const char *널)
롤 토토선택된 열을 새 값으로 대체하고 원래 행의 열을 다른 위치에 복사하여 새 행을 생성합니다. 입력 행은 수정되지 않습니다. 새 행은 상위 실행기 컨텍스트에서 반환됩니다.
이 기능은 SPI에 연결된 동안에만 사용할 수 있습니다. 그렇지 않으면 NULL을 반환하고 설정합니다.SPI_result에SPI_ERROR_UNCONNECTED.
관계rel행에 대한 행 설명자의 소스로만 사용됩니다. (행 설명자 대신 관계를 전달하는 것은 잘못된 기능입니다.)
HeapTuple행수정할 행
intncols변경할 열 수
정수 *열길이 배열ncols, 변경할 열 번호 포함(열 번호는 1부터 시작)
데이텀 *값길이의 배열ncols, 지정된 열에 대한 새 값 포함
상수 문자 *널길이의 배열ncols, 어떤 새 값이 null인지 설명
만약널isNULL그런 다음롤 토토새로운 값은 null이 아니라고 가정합니다. 그렇지 않으면,의 각 항목은널배열은 다음과 같아야 합니다' '해당 새 값이 null이 아닌 경우, 또는'n'해당 새 값이 null인 경우. (후자의 경우 해당하는 실제 값값항목은 중요하지 않습니다.) 참고널텍스트 문자열이 아니며 단지 배열입니다. 필요하지 않습니다.'\0'터미네이터.
수정된 새 행, 상위 실행기 컨텍스트에 할당됨, 또는NULL오류 발생 시(참조SPI_result오류 표시용)
오류 발생 시,SPI_result다음과 같이 설정됩니다:
SPI_ERROR_ARGUMENTifrelisNULL또는 만약행isNULL또는 만약ncols0보다 작거나 같은 경우, 또는 if열isNULL또는 만약값isNULL.
SPI_ERROR_NOATTRIBUTEif열잘못된 열 번호가 포함되어 있습니다(0보다 작거나 같거나 다음의 열 수보다 큼행)
SPI_ERROR_UNCONNECTEDSPI가 활성화되지 않은 경우
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 경험이 있거나 추가 설명이 필요한 경우 이용해주세요이 양식문서 문제를 보고합니다.