oracledb 26.0.0-beta.1

//-----------------------------------------------------------------------------
// Copyright (c) 2026, Oracle and/or its affiliates.
//
// This software is dual-licensed to you under the Universal Permissive License
// (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl and Apache License
// 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose
// either license.
//
// If you elect to accept the software under the Apache License, Version 2.0,
// the following applies:
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//    https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//-----------------------------------------------------------------------------

//-----------------------------------------------------------------------------
// exec_result.rs
//
// Defines the structure representing execution results.
//-----------------------------------------------------------------------------

use crate::response::Response;
use crate::row::{Row, RowData};

/// Represents the result returned by the database when calling
/// [Connection::execute()](`crate::Connection::execute()`),
/// [Connection::execute_named()](`crate::Connection::execute_named()`), or
/// [Connection::execute_batch()](`crate::Connection::execute_batch()`).
pub struct ExecResult {
    returned_data: Option<Vec<RowData>>,
    rows_affected: u64,
}

impl ExecResult {
    pub(crate) fn new(resp: &mut Response) -> ExecResult {
        ExecResult {
            returned_data: resp.take_rows(),
            rows_affected: resp.get_rowcount(),
        }
    }

    /// Returns the number of rows affected by the execution of the statement.
    pub fn rows_affected(&self) -> u64 {
        self.rows_affected
    }

    /// Returns data returned by the database as OUT variables (PL/SQL or
    /// RETURNING statements. This transfers ownership of the returned data to
    /// the caller.
    pub fn returned_data(&mut self) -> Vec<Row> {
        if let Some(returned_data) = self.returned_data.take() {
            let mut rows = Vec::<Row>::with_capacity(returned_data.len());
            for column_values in returned_data {
                rows.push(Row::new(column_values));
            }
            rows
        } else {
            Vec::<Row>::new()
        }
    }
}