SINGLE function

PRO

The SINGLE function in Jspreadsheet Formulas Pro is used to retrieve a value from a range that shares the same column or row with a specified reference cell. Essentially, it lets you pick out a single value from a larger grid or array. This could be handy when you're dealing with a larger dataset but only need specific information from it. It's a simple and efficient way to extract and work with individual data points in Jspreadsheet.

Documentation

The SINGLE function returns the value from a range that shares the same column or row as the reference cell.

Syntax

SINGLE(reference)

Parameter	Description
`reference`	The reference cell whose row or column you want to match to retrieve the corresponding value from the range.

Behavior

The SINGLE function is used to return the value of a cell when the cell reference is a range of cells. Here's how it handles various inputs:

Empty cells: If the referenced position corresponds to an empty cell, the function will return 0.
Text: If the referenced cell contains text, the text will be returned.
Booleans: Boolean values are treated as numbers. TRUE is returned as 1, and FALSE as 0.
Errors: If the referenced cell contains an error, the SINGLE function will return the same error.

Common Errors

Error	Description
#VALUE!	Occurs when the formula contains the wrong type of argument.
#REF!	Occurs when the cell reference is not valid.

Best practices

Always make sure that the cell range you're referring to with SINGLE includes the type of value you're expecting to return. For example, if you're expecting a number, make sure the first cell in the range contains a number.

Use the SINGLE function when you're working with a range that is expected to contain only a single value.

Handle potential errors with appropriate error handling functions to ensure your formula doesn't break your spreadsheet.

Validate the cell range before using it in the SINGLE function to avoid reference errors.

Usage

A few examples using the SINGLE function.

SINGLE(A1:A10) → If entered in row 5, it returns the value in A5.  
SINGLE(B2:D2) → If entered in column C, it returns the value in C2.  
SINGLE(C3:C3) → Returns the value in C3 (a single-cell reference).

Interactive Spreadsheet Demo

<html>
<script src="https://jspreadsheet.com/v11/jspreadsheet.js"></script>
<script src="https://jsuites.net/v5/jsuites.js"></script>
<link rel="stylesheet" href="https://jsuites.net/v5/jsuites.css" type="text/css" />
<link rel="stylesheet" href="https://jspreadsheet.com/v11/jspreadsheet.css" type="text/css" />

<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Material+Icons" />
<script src="https://cdn.jsdelivr.net/npm/@jspreadsheet/formula-pro/dist/index.min.js"></script>

<div id="spreadsheet"></div>

<script>
// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('OGFjYzBkMWZjN2I2NWYyMjc4NTMyMzNlMjE4Zjc4OTlkODQ0MjgxOGI0NWUyYjFhMjZjZDg4MjRhNWI4ODJiYTlhNThiNDcwZjNjNzBiMjc1YTcyOGEzNTMzNDkyODk3ZTEzZGM0MDljMDgwYmQ1MDcxZmRmMWQxN2Q0MmM3ZDAsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNVEE1TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

// Create a new spreadsheet
jspreadsheet(document.getElementById('spreadsheet'), {
  worksheets: [{
    data: [
    [
        "Product",
        "Price",
        "Quantity"
    ],
    [
        "Apples",
        2.5,
        "=SINGLE(B1:B4)"
    ],
    [
        "Bananas",
        1.75,
        8
    ],
    [
        "Oranges",
        3.0,
        12
    ]
]
  }]
});
</script>
</html>

import React, { useRef } from "react";
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/react";
import formula from "@jspreadsheet/formula-pro";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";

// Set license
jspreadsheet.setLicense('OGFjYzBkMWZjN2I2NWYyMjc4NTMyMzNlMjE4Zjc4OTlkODQ0MjgxOGI0NWUyYjFhMjZjZDg4MjRhNWI4ODJiYTlhNThiNDcwZjNjNzBiMjc1YTcyOGEzNTMzNDkyODk3ZTEzZGM0MDljMDgwYmQ1MDcxZmRmMWQxN2Q0MmM3ZDAsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNVEE1TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default function App() {
    // Spreadsheet array of worksheets
    const spreadsheet = useRef();

    // Worksheet data
    const data = [
    [
        "Product",
        "Price",
        "Quantity"
    ],
    [
        "Apples",
        2.5,
        "=SINGLE(B1:B4)"
    ],
    [
        "Bananas",
        1.75,
        8
    ],
    [
        "Oranges",
        3.0,
        12
    ]
];

    // Render component
    return (
        <Spreadsheet ref={spreadsheet}>
            <Worksheet data={data} />
        </Spreadsheet>
    );
}

<template>
    <Spreadsheet ref="spreadsheet">
        <Worksheet :data="data" />
    </Spreadsheet>
</template>

<script>
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/vue";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";
import formula from "@jspreadsheet/formula-pro";

// Set license
jspreadsheet.setLicense('OGFjYzBkMWZjN2I2NWYyMjc4NTMyMzNlMjE4Zjc4OTlkODQ0MjgxOGI0NWUyYjFhMjZjZDg4MjRhNWI4ODJiYTlhNThiNDcwZjNjNzBiMjc1YTcyOGEzNTMzNDkyODk3ZTEzZGM0MDljMDgwYmQ1MDcxZmRmMWQxN2Q0MmM3ZDAsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNVEE1TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

export default {
    components: {
        Spreadsheet,
        Worksheet,
    },
    data() {
        // Worksheet data
        const data = [
    [
        "Product",
        "Price",
        "Quantity"
    ],
    [
        "Apples",
        2.5,
        "=SINGLE(B1:B4)"
    ],
    [
        "Bananas",
        1.75,
        8
    ],
    [
        "Oranges",
        3.0,
        12
    ]
]

        return {
            data
        };
    }
}
</script>

import { Component, ViewChild, ElementRef } from "@angular/core";
import jspreadsheet from "jspreadsheet";
import * as formula from "@jspreadsheet/formula-pro";

// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('OGFjYzBkMWZjN2I2NWYyMjc4NTMyMzNlMjE4Zjc4OTlkODQ0MjgxOGI0NWUyYjFhMjZjZDg4MjRhNWI4ODJiYTlhNThiNDcwZjNjNzBiMjc1YTcyOGEzNTMzNDkyODk3ZTEzZGM0MDljMDgwYmQ1MDcxZmRmMWQxN2Q0MmM3ZDAsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVNE56YzBNVEE1TENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');

// Set the extensions
jspreadsheet.setExtensions({ formula });

@Component({
    standalone: true,
    selector: "app-root",
    template: `<div #spreadsheet></div>`
})
export class AppComponent {
    @ViewChild("spreadsheet") spreadsheet: ElementRef;
    // Worksheets
    worksheets: jspreadsheet.worksheetInstance[];

    // Create a new data grid
    ngAfterViewInit() {
        // Create spreadsheet
        this.worksheets = jspreadsheet(this.spreadsheet.nativeElement, {
            worksheets: [{
                data: [
    [
        "Product",
        "Price",
        "Quantity"
    ],
    [
        "Apples",
        2.5,
        "=SINGLE(B1:B4)"
    ],
    [
        "Bananas",
        1.75,
        8
    ],
    [
        "Oranges",
        3.0,
        12
    ]
]
            }]
        });
    }
}

Edit this page on GitHub