89 lines
2.9 KiB
PHP
89 lines
2.9 KiB
PHP
<?php
|
|
|
|
namespace PhpOffice\PhpSpreadsheet\Cell;
|
|
|
|
use PhpOffice\PhpSpreadsheet\Exception;
|
|
|
|
class AddressHelper
|
|
{
|
|
/**
|
|
* Converts an R1C1 format cell address to an A1 format cell address.
|
|
*/
|
|
public static function convertToA1(
|
|
string $address,
|
|
int $currentRowNumber = 1,
|
|
int $currentColumnNumber = 1
|
|
): string {
|
|
$validityCheck = preg_match('/^(R(\[?-?\d*\]?))(C(\[?-?\d*\]?))$/i', $address, $cellReference);
|
|
|
|
if ($validityCheck === 0) {
|
|
throw new Exception('Invalid R1C1-format Cell Reference');
|
|
}
|
|
|
|
$rowReference = $cellReference[2];
|
|
// Empty R reference is the current row
|
|
if ($rowReference === '') {
|
|
$rowReference = (string) $currentRowNumber;
|
|
}
|
|
// Bracketed R references are relative to the current row
|
|
if ($rowReference[0] === '[') {
|
|
$rowReference = $currentRowNumber + trim($rowReference, '[]');
|
|
}
|
|
$columnReference = $cellReference[4];
|
|
// Empty C reference is the current column
|
|
if ($columnReference === '') {
|
|
$columnReference = (string) $currentColumnNumber;
|
|
}
|
|
// Bracketed C references are relative to the current column
|
|
if ($columnReference[0] === '[') {
|
|
$columnReference = $currentColumnNumber + trim($columnReference, '[]');
|
|
}
|
|
|
|
if ($columnReference <= 0 || $rowReference <= 0) {
|
|
throw new Exception('Invalid R1C1-format Cell Reference, Value out of range');
|
|
}
|
|
$A1CellReference = Coordinate::stringFromColumnIndex($columnReference) . $rowReference;
|
|
|
|
return $A1CellReference;
|
|
}
|
|
|
|
/**
|
|
* Converts an A1 format cell address to an R1C1 format cell address.
|
|
* If $currentRowNumber or $currentColumnNumber are provided, then the R1C1 address will be formatted as a relative address.
|
|
*/
|
|
public static function convertToR1C1(
|
|
string $address,
|
|
?int $currentRowNumber = null,
|
|
?int $currentColumnNumber = null
|
|
): string {
|
|
$validityCheck = preg_match('/^\$?([A-Z]{1,3})\$?(\d{1,7})$/i', $address, $cellReference);
|
|
|
|
if ($validityCheck === 0) {
|
|
throw new Exception('Invalid A1-format Cell Reference');
|
|
}
|
|
|
|
$columnId = Coordinate::columnIndexFromString($cellReference[1]);
|
|
$rowId = (int) $cellReference[2];
|
|
|
|
if ($currentRowNumber !== null) {
|
|
if ($rowId === $currentRowNumber) {
|
|
$rowId = '';
|
|
} else {
|
|
$rowId = '[' . ($rowId - $currentRowNumber) . ']';
|
|
}
|
|
}
|
|
|
|
if ($currentColumnNumber !== null) {
|
|
if ($columnId === $currentColumnNumber) {
|
|
$columnId = '';
|
|
} else {
|
|
$columnId = '[' . ($columnId - $currentColumnNumber) . ']';
|
|
}
|
|
}
|
|
|
|
$R1C1Address = "R{$rowId}C{$columnId}";
|
|
|
|
return $R1C1Address;
|
|
}
|
|
}
|