Come restituire un valore da una procedura usando un cursore (REF CURSOR)?

In Oracle PL/SQL, per restituire un insieme di righe da una procedura, si utilizza spesso REF CURSOR. È un puntatore al risultato di una query, che può essere aperto all'interno della procedura e restituito al codice chiamante.

Esempio di procedura con parametro OUT di tipo REF CURSOR:

CREATE OR REPLACE PROCEDURE get_employees(p_dept_id IN NUMBER, p_refcur OUT SYS_REFCURSOR) AS
BEGIN
  OPEN p_refcur FOR
    SELECT employee_id, first_name, last_name
    FROM employees
    WHERE department_id = p_dept_id;
END;
/

Chiamata da un blocco PL/SQL:

DECLARE
  rc SYS_REFCURSOR;
  emp_id employees.employee_id%TYPE;
  fname employees.first_name%TYPE;
  lname employees.last_name%TYPE;
BEGIN
  get_employees(10, rc);
  LOOP
    FETCH rc INTO emp_id, fname, lname;
    EXIT WHEN rc%NOTFOUND;
    DBMS_OUTPUT.PUT_LINE(emp_id || ' ' || fname || ' ' || lname);
  END LOOP;
  CLOSE rc;
END;
/

In questo modo, la procedura apre un REF CURSOR con la query necessaria, e il codice chiamante legge i dati da esso.