The Microsoft Excel File Format
OpenOffice.org's Documentation of the
Microsoft Excel File Format
Excel Versions 2, 3, 4, 5, 95, 97, 2000, XP, 2003
Author
Daniel Rentz â mailto:dr@openoffice.org î http://sc.openoffice.org
License
Public Documentation License
Contributors
Yves Hiltpold, James J. Keene, Sami Kuhmonen, John Marmion, Alexander Mavrin,
Josh Micich, Andrew C. Oliver, Mike Salter, Stefan SchmĂścker, Charles Wyble
Other sources
Hyperlinks to Wikipedia (î http://www.wikipedia.org) for various extended information
Mailing list
â mailto:dev@sc.openoffice.org
Subscription â mailto:dev-subscribe@sc.openoffice.org
Download
PDF î http://sc.openoffice.org/excelfileformat.pdf
OpenOffice.org 1.x XML î http://sc.openoffice.org/excelfileformat.sxw
OpenOffice.org 2.x XML î http://sc.openoffice.org/excelfileformat.odt
Project started
2001-Jun-29
Last change
2008-Apr-02
Revision
1.42
Contents
1 Introduction ......................................................................................................... 6
1.1
License Notices
6
1.2
Abstract
7
1.3
Byte Order
9
2 Document Structure ........................................................................................... 10
2.1
Document Types
10
2.2
The Binary Interchange File Format
13
2.3
File Structure
14
2.4
BIFF Record Structure
16
2.5
Common Record Substructures
17
3 Formulas ............................................................................................................ 28
3.1
Common Formula Structure
28
3.2
Token Classes
32
3.3
Cell Addresses in Tokens
36
3.4
Token Overview
40
3.5
Unary Operator Tokens
44
3.6
Binary Operator Tokens
45
3.7
Function Operator Tokens
49
3.8
Constant Operand Tokens
51
3.9
Operand Tokens
54
3.10 Control Tokens
65
3.11 Built-In Sheet Functions
74
4 Worksheet/Workbook Stream ............................................................................ 79
4.1
Worksheet/Workbook Stream
80
4.2
Record Order in Streams and Substreams
81
4.3
Calculation Settings Block
87
4.4
Page Settings Block
87
4.5
Sheet View Settings Block
88
4.6
Cell Formatting
89
4.7
Cell Table and Row Blocks
90
4.8
Array Formulas and Shared Formulas
96
4.9
Multiple Operation Tables
97
4.10 Internal and External References
98
4.11 Shared String Table (BIFF8)
110
2
4.12 Conditional Formatting Table (BIFF8)
112
4.13 Hyperlink Table (BIFF8)
112
4.14 Data Validity Table (BIFF8)
112
4.15 AutoFilter, Advanced Filter
113
4.16 Scenarios
113
4.17 Web Queries (BIFF8)
113
4.18 Worksheet/Workbook Protection
114
4.19 File Protection
117
5 Worksheet/Workbook Records ........................................................................ 120
5.1
Overview, Ordered by Record Identifier
120
5.2
Overview, Ordered by Record Names
124
5.3
Overview, Ordered by BIFF Versions
127
5.4
ARRAY
132
5.5
BACKUP
133
5.6
BITMAP
133
5.7
BLANK
134
5.8
BOF â Beginning of File
135
5.9
BOOKBOOL
137
5.10 BOOLERR
137
5.11 BOTTOMMARGIN
138
5.12 BUILTINFMTCOUNT
138
5.13 CALCCOUNT
139
5.14 CALCMODE
139
5.15 CFHEADER
139
5.16 CFRULE â Conditional Formatting Rule
140
5.17 CODEPAGE
145
5.18 COLINFO
146
5.19 COLUMNDEFAULT
147
5.20 COLWIDTH
147
5.21 CONTINUE
148
5.22 COUNTRY
149
5.23 CRN
150
5.24 DATATABLE â Multiple Operation Table
151
5.25 DATATABLE2 â Multiple Operation Table
152
5.26 DATAVALIDATION
153
5.27 DATAVALIDATIONS
154
5.28 DATEMODE
154
5.29 DBCELL
155
5.30 DCONREF â Data Consolidation Reference
155
5.31 DEFAULTROWHEIGHT
156
5.32 DEFCOLWIDTH
156
5.33 DEFINEDNAME
157
5.34 DELTA
160
5.35 DIMENSION
160
5.36 DSF â Double Stream File
161
5.37 EOF â End of File
161
5.38 EXTERNALBOOK â External Workbook
162
5.39 EXTERNALNAME
164
5.40 EXTERNCOUNT
166
5.41 EXTERNSHEET
166
5.42 EXTSST â Extended SST
167
5.43 FILEPASS
168
5.44 FILESHARING
170
5.45 FONT
171
5.46 FONT2
173
3
5.47 FONTCOLOR
173
5.48 FOOTER
173
5.49 FORMAT
174
5.50 FORMULA
176
5.51 GCW â Global Column Width
178
5.52 GRIDSET
179
5.53 GUTS
179
5.54 HCENTER
179
5.55 HEADER
180
5.56 HIDEOBJ
181
5.57 HORIZONTALPAGEBREAKS
181
5.58 HYPERLINK
182
5.59 INDEX
185
5.60 INTEGER
186
5.61 ITERATION
186
5.62 IXFE â Index to XF
186
5.63 LABEL
187
5.64 LABELRANGES
187
5.65 LABELSST
188
5.66 LEFTMARGIN
188
5.67 MERGEDCELLS
188
5.68 MULBLANK â Multiple BLANK
189
5.69 MULRK â Multiple RK
189
5.70 NOTE
190
5.71 NUMBER
191
5.72 OBJECTPROTECT
191
5.73 PAGESETUP
192
5.74 PALETTE
195
5.75 PANE
197
5.76 PASSWORD
197
5.77 PHONETICPR
198
5.78 PLS
198
5.79 PRECISION
198
5.80 PRINTGRIDLINES
199
5.81 PRINTHEADERS
199
5.82 PROTECT
200
5.83 QUICKTIP
200
5.84 RANGEPROTECTION
200
5.85 REFMODE
201
5.86 RIGHTMARGIN
201
5.87 RK
201
5.88 ROW
202
5.89 RSTRING
204
5.90 SAVERECALC
204
5.91 SCENPROTECT
205
5.92 SCL
205
5.93 SELECTION
205
5.94 SHAREDFMLA â Shared Formula
206
5.95 SHEET
206
5.96 SHEETLAYOUT
207
5.97 SHEETPR
207
5.98 SHEETPROTECTION
208
5.99 SORT
209
5.100 SST â Shared String Table
210
5.101 STANDARDWIDTH
210
5.102 STRING
211
5.103 STYLE
212
4
5.104 TOPMARGIN
213
5.105 UNCALCED
213
5.106 USESELFS
213
5.107 VCENTER
214
5.108 VERTICALPAGEBREAKS
214
5.109 WINDOW1
215
5.110 WINDOW2
216
5.111 WINDOWPROTECT
217
5.112 WRITEACCESS
218
5.113 WRITEPROT
218
5.114 XCT â CRN Count
218
5.115 XF â Extended Format
219
6 Drawing Objects .............................................................................................. 225
7 Charts ............................................................................................................... 226
7.1
Document Integration
226
7.2
General Chart Structure
229
7.3
Common Record Blocks
231
7.4
Record Overview, Ordered by Identifier
234
7.5
Record Overview, Ordered by Name
235
7.6
CHAREAFORMAT
236
7.7
CHAXISLINE
237
7.8
CHBEGIN â Begin of Block
238
7.9
CHEND â End of Block
239
7.10 CHFRAME
240
7.11 CHLINEFORMAT
241
7.12 CHSOURCELINK
242
7.13 CHSTRING
243
8 PivotTables ...................................................................................................... 244
9 Change Tracking ............................................................................................. 245
10 Workspace Documents .................................................................................... 246
10.1 Workspace Stream
246
10.2 Overview, Ordered by Record Identifier
248
10.3 INDEX
249
10.4 SHEETHDR
250
10.5 SHEETSOFFSET
250
5
1 Introduction
1
Introduction
1.1 License Notices
1.1.1 Public Documentation License Notice
The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the "License"); you
may only use this Documentation if you comply with the terms of this License. A copy of the License is available at
î http://www.openoffice.org/licenses/PDL.html.
The Original Documentation is "OpenOffice.org's Documentation of the Microsoft Excel File Format".
The Initial Writer of the Original Documentation is Sun Microsystems, Inc., Copyright Š 2003. All Rights Reserved.
See title page for Author contact and Contributors.
All Trademarks are properties of their respective owners.
1.1.2 Wikipedia
Wikipedia Disclaimer: î http://en.wikipedia.org/wiki/Wikipedia:General_disclaimer
6
1.2 Abstract
1.2 Abstract
This document contains a description of the binary file format of Microsoft Excel, including all available Excel versions
(for Windows) from Excel 2.x to the current Excel 2003.
This project has been started in June 2001 and is still in progress. At several places the remark â2doâ indicates an
incomplete section of the documentation.
1.2.1 Project Status
Chapter
Contents
Status
1 Introduction
Common information
Done
2 Document Structure
Document structure overview
Done
3 Formulas
- Structure of RPN token arrays
Done
- Detailed description of all tokens
In progress
4 Worksheet/Workbook Stream
Abstract description of complex features represented
In progress
by several records
5 Worksheet/Workbook Records
Detailed description of all records of the
In progress
worksheet/workbook stream
6 Drawing Objects
Not started
7 Charts
Internals of chart sheets and chart objects
In progress
8 PivotTables
Not started
9 Change Tracking
Not started
10 Workspace Documents
In progress
7
1 Introduction
1.2.2 Used Terms, Symbols, and Formatting
⢠References
A reference to another chapter is symbolised by a little arrow: â1.1.
⢠Definitions
Definitions of important terms are shown in a box with light-grey background.
Definition:
This is an example of a definition box.
⢠Examples
An example is indented and marked with a light-grey border.
This is an example.
⢠Important Passages
Text passages with important information contain a leading exclamation mark.
This is an important passage.
!
⢠Numbers and Strings
Numerical values are shown in several number systems:
Number system
Marking
Example
Decimal
None
1234
Hexadecimal
Trailing âHâ
1234H
Binary
Trailing â2â
10012
Constant strings are enclosed in quotation marks. They may contain specific values (control characters, unprintable
characters). These values are enclosed in angle brackets.
Example of a string containing a control character: âabcdef<01H>ghijâ.
⢠Record Listings
A record listing shows a bundle of records in the required order. A dark grey rectangle stands for a single record, a light
grey rectangle stands for a group of records. Either this is a group representing a specific feature and is referred with the
Record Group Name, or it is a group of various unspecified records that do not matter in this context.
RECORD NAME
Comments
Record Group Name
Comments
8
1.2 Abstract
⢠Record Content Listings
⢠Data offsets enclosed in square brackets indicate record content that may be omitted (the remark âoptionalâ may point
out this).
⢠The term âNot usedâ means: Ignore the data on import and write zero bytes on export. The same applies for unmen-
tioned bits in bit fields.
⢠The term âUnknownâ describes data fields with fixed but unknown contents. On export these fields have to be written
as shown.
⢠At several places a variable is introduced, which represents the value of this field for later use. In most common
cases this is a field containing a size value, which is used later in the âSizeâ column of the record content listing. An
example can be found in â2.4.
⢠Algorithm Listings
Algorithms given in pseudo-code are shown in a box with light-grey background.
ALGORITHM Example_Algorithm
1) Command 1
2) Command 2
Notation conventions used in algorithms:
Notation
Description
command1 ; command2
Two commands in one line, first execute command1, then command2
var â value
The value value is assigned to the variable var
JUMP x)
Continue with line x) in the algorithm
RETURN [value]
Returns value value if specified, otherwise returns without a return value
IF cond THEN command
Execute command only, if condition cond evaluates to true
AND
Binary AND operation
OR
Binary OR operation
XOR
Binary XOR (exclusive or) operation
= <> < > <= >=
Comparison operators for conditional execution
array[]
An array consisting of equal typed elements
array[0]
The first element of the array array[] (arrays are used zero-based)
1.3 Byte Order
All data items containing more than one byte are stored using the Little-Endian method1. That means the least significant
byte is stored first and the most significant byte last. This applies for all data types like 16-bit integers, 32-bit integers,
floating-point values and Unicode characters.
Example: The 32-bit integer value 13579BDFH is converted into the byte sequence DFH 9BH 57H 13H.
1
For more information see http://en.wikipedia.org/wiki/Endianness.
9
2 Document Structure
2
Document Structure
2.1 Document Types
2.1.1 Microsoft Excel Releases
The following table shows the different Excel versions released for Microsoft Windows and Apple Macintosh2:
Excel version
MS Windows
Release year
Apple Macintosh
Release year
Excel 2.x
Excel 2.0
1987
Excel 2.2
1989
Excel 3.0
Excel 3.0
1990
Excel 3.0
1990
Excel 4.0
Excel 4.0
1992
Excel 4.0
1992
Excel 5.0
Excel 5.0
1993
Excel 5.0
1993
Excel 7.0
Excel 95
1995
â
Excel 8.0
Excel 97
1997
Excel 98
1998
Excel 9.0
Excel 2000
1999
Excel 2001
2000
Excel 10.0
Excel XP
2001
Excel v.X
2001
Excel 11.0
Excel 2003
2003
Excel 2004
2004
2.1.2 Worksheet Document
Definition: Worksheet Document
A worksheet document consists of a single sheet only. Various kinds of sheets are possible, for instance a regular
sheet (containing values and formulas), a chart sheet (â7.1.1), or a macro sheet. The default file extension of
worksheet documents is âXLSâ.
General structure of a worksheet document:
Worksheet document
Sheet
2
Source: http://en.wikipedia.org/wiki/Microsoft_Excel.
10
2.1 Document Types
2.1.3 Workbook Document
Definition: Workbook document
A workbook document contains several sheets. It is possible to combine sheets of all types into the workbook,
for instance regular sheets, chart sheets (â7.1.2), macro sheets, or Visual Basic modules. Each workbook
document contains global settings for the workbook, called the workbook globals. The default file extension of
workbook documents is âXLSâ.
Note the difference: A sheet is part of a worksheet document as well as a workbook document. A workbook
! document containing only one sheet is possible, but it is still called a workbook document.
General structure of a workbook document:
Workbook document
Sheet 3
Sheet 2
Sheet 1
Workbook globals
2.1.4 Workspace Document
Definition: Workspace document
A workspace document contains links to several worksheet and/or workbook documents. It stores the file name,
window size, and window position of each document that is part of the workspace. The default file extension of
workspace documents is âXLWâ.
Note the difference: A workbook document contains several sheets, but a workspace document contains links to
! worksheet or workbook documents that are stored in several files.
No rule without exception: A workspace document written by Excel 4.0 is in fact a combination of a workbook
! document and a workspace document: It may contain links to worksheet documents, and embedded sheets that are
loaded from an existing worksheet file or created from scratch. The workspace document contains the complete data
of all embedded sheets.
General structure of a workspace document:
Workspace document
Link to worksheet/workbook document 1
Link to worksheet/workbook document 2
Link to worksheet/workbook document 3
Worksheet or
Worksheet or
Worksheet or
workbook document 1
workbook document 2
workbook document 3
The detailed structure of workspace documents is described in chapter â10.
11
2 Document Structure
2.1.5 Availability of the Document Types
The following illustration shows which document types are available in the different Excel versions:
Excel 2.x worksheet
Excel 3.0 worksheet
Excel 3.0 workspace
Excel 4.0 worksheet
Excel 4.0 combined workbook/workspace
Excel 5.0/7.0 workbook
Excel 5.0/7.0 workspace
Excel 8.0+ workbook
Excel 8.0+ workspace
12
2.2 The Binary Interchange File Format
2.2 The Binary Interchange File Format
The Excel file format is named BIFF (Binary Interchange File Format). It is used to store all types of documents:
worksheet documents (â2.1.2), workbook documents (â2.1.3), and workspace documents (â2.1.4). There are different
versions of this file format, depending on the version of Excel that has written the file (â2.1.1), and depending on the
document type.
2.2.1 BIFF Versions for Worksheet/Workbook Documents
The following table shows which Excel version writes which file format for worksheet and workbook documents:
Excel version
BIFF version
Document type
Excel 2.x
BIFF2
Worksheet
Excel 3.0
BIFF3
Worksheet
Excel 4.0
BIFF4
Worksheet
Excel 5.0
BIFF5
Workbook
Excel 7.0
BIFF5
Workbook
Excel 8.0
BIFF8
Workbook
Excel 9.0
BIFF8
Workbook
Excel 10.0
BIFF8
Workbook
Excel 11.0
BIFF8
Workbook
BIFF8 contains major changes towards older BIFF versions, for instance the handling of Unicode strings.
2.2.2 BIFF Versions for Workspace Documents
The following table shows which Excel version writes which file format for workspace documents:
Excel version
BIFF version
Document type
Excel 2.x
â
â
Excel 3.0
BIFF3W
Workspace
Excel 4.0
BIFF4W
Combined workbook/workspace
Excel 5.0
BIFF5W
Workspace
Excel 7.0
BIFF5W
Workspace
Excel 8.0
BIFF8W
Workspace
Excel 9.0
BIFF8W
Workspace
Excel 10.0
BIFF8W
Workspace
Excel 11.0
BIFF8W
Workspace
13
2 Document Structure
2.3 File Structure
2.3.1 Stream File
All document types and BIFF versions can be stored in a simple stream file, most of them are always stored this way.
The only exception are BIFF5-BIFF8 workbook documents, which are usually stored as compound document files (see
below). If these documents are stored as stream files, the entire file consists of the âBookâ stream (BIFF5) or
âWorkbookâ stream (BIFF8) only.
2.3.2 Compound Document File (BIFF5-BIFF8)
A workbook document with several sheets (BIFF5-BIFF8) is usually stored using the compound document file format
(also known as âOLE2 storage file formatâ or âMicrosoft Office compatible storage file formatâ). It contains several
streams for different types of data. A complete documentation of the format of compound document files can be found at
î http://sc.openoffice.org/compdocfileformat.pdf.
The following table lists names of possible streams.
Stream name
Contents
Book
BIFF5 Workbook Stream (â2.3.3)
Workbook
BIFF8 Workbook Stream (â2.3.3)
<05H>SummaryInformation
Document settings
<05H>DocumentSummaryInformation
Document settings
Ctls
Formatting of form controls
User Names
User names in shared workbooks (â9)
Revision Log
Change tracking log stream (â9)
It is possible to create substorages like subdirectories in a file system, for instance for the PivotTable streams. These
storages contain substreams itself.
Storage name
Contents
LNKxxxxxxxx
Storage for a linked OLE object (â6)
MBDxxxxxxxx
Storage for an embedded OLE object (â6)
_SX_DB_CUR
Pivot cache storage. The streams contain cached values for PivotTables (â8).
_VBA_PROJECT_CUR
Visual BASIC project storage
In BIFF8, the Escher stream describing drawing objects (â6) is not stored as separate stream in the compound
! document file, but split and embedded in several MSODRAWING records that are part of the Workbook Stream.
14
2.3 File Structure
2.3.3 Worksheet/Workbook/Workspace Stream
Depending on the document type, different names are used for the stream(s) they contain.
Definition: Worksheet Stream
BIFF2-BIFF4 worksheet documents (â2.1.2) are stored as stream files (â2.3.1). The entire stream is called the
Worksheet Stream.
The Worksheet Stream is described in detail in â4.1.1.
Definition: Workbook Stream
BIFF5-BIFF8 workbook documents (â2.1.3) that are stored in a compound document file (â2.3.2) contain a
stream in the root storage called the Workbook Stream. The name of this stream in the compound document file is
âBookâ for BIFF5 workbooks, and âWorkbookâ for BIFF8 workbooks.
If a BIFF5-BIFF8 workbook document is stored as stream file (â2.3.1), the entire stream is called the Workbook
Stream.
The Worksheet Stream is described in detail in â4.1.2.
Definition: Workspace Stream
BIFF3W-BIFF8W workspace documents (â2.1.4) are stored as stream files (â2.3.1). The entire stream is called
the Workspace Stream.
The Workspace Stream is described in detail in chapter â10.
2.3.4 Substreams
The BIFF5-BIFF8 Workbook Stream (â2.3.3) is divided into several parts that describe the workbook globals and the
contained sheets (â2.1.3). Each of this parts is called a substream, defined by a starting and end position in the stream.
Definition: Workbook Globals Substream
The substream that contains the global information of a workbook is called the Workbook Globals Substream. It
is part of the Workbook Stream of BIFF5-BIFF8 workbooks.
Definition: Sheet Substream
A substream that describes a sheet in a workbook is called Sheet Substream. It is part of the BIFF5-BIFF8
Workbook Stream as well as the BIFF4W Workspace Stream.
The Sheet Substream in a Workbook Stream can be regarded as a Worksheet Stream, because both describe one sheet
and are very similar in their structure. A special type of a Sheet Substream is the Chart Substream (â7.1.2).
⢠Substreams in the BIFF5-BIFF8 Workbook Stream
In BIFF5-BIFF8 Workbook Streams, the Workbook Globals Substream ist the leading part of the stream. It is followed
by all Sheet Substreams in order of the sheets that are in the document.
Common structure of a BIFF5-BIFF8 Workbook Stream:
Workbook Globals Substream (required)
First Sheet Substream (required)
Second Sheet Substream (optional)
Third Sheet Substream (optional)
âŽ
15
2 Document Structure
⢠Substreams in the BIFF4 Workspace Stream
In BIFF4 Workspace Streams, the Sheet Substreams are embedded in the Workspace Stream. They are similar in their
structure to BIFF4 Worksheet Streams.
Common structure of a BIFF4W Workspace Stream:
Workspace Stream (required)
First embedded BIFF4 Sheet Substream (optional)
Second embedded BIFF4 Sheet Substream (optional)
Third embedded BIFF4 Sheet Substream (optional)
âŽ
2.4 BIFF Record Structure
Definition: BIFF Record
Most of the Excel streams or substreams (including all streams described in â2.3.3 and substreams described in
â2.3.4) are divided into records. Each record contains specific data for the various contents or features in a
document. It consists of a header specifying the record type and size, followed by the record data.
Common structure of a BIFF record:
Offset
Size
Contents
0
2
Identifier
} Record header
2
2
Size of the following data (sz)
4
sz
Record data
The maximum size of the record data is limited and depends on the BIFF version. If the size of the record data exceeds
the current limit, one or more CONTINUE records (â5.21) will be added. Inside a CONTINUE record the data of the
previous record continues as usual.
In this documentation only the record data without the headers is shown. All offsets are relative to the beginning of the
record data and not to the entire record. The contents of most of the records differ from BIFF version to version. This
will be described in separate tables. A few older records are replaced in newer BIFF versions. Excel does not write these
old records in new BIFF versions anymore.
16
2.5 Common Record Substructures
2.5 Common Record Substructures
This chapter contains information about basic substructures which do not belong to specific records, for instance strings,
error codes, constant values, URLs, or line and area formatting.
2.5.1 Formatting Runs
Formatting runs describe the character formatting of strings. A formatting run contains the index of a character and the
index of a font in the font buffer. The font is used to format the indexed character and the following characters, until the
string ends or another formatting run follows.
Formatting run, BIFF2-BIFF5:
Offset
Size
Contents
0
1
First formatted character (zero-based)
1
1
Index to FONT record (â5.45)
Formatting run, BIFF8:
Offset
Size
Contents
0
2
First formatted character (zero-based)
2
2
Index to FONT record (â5.45)
2.5.2 Byte Strings (BIFF2-BIFF5)
All Excel file formats up to BIFF5 contain simple byte strings. The byte string consists of the length of the string
followed by the character array. The length is stored either as 8-bit value or as 16-bit value, depending on the current
record. The string is not zero-terminated. The encoding of the character array is dependent on the current record (for
example taken from the CODEPAGE record, â5.17, or from the FONT record, â5.45).
Offset
Size
Contents
0
1 or 2
Length of the string (character count, ln)
1 or 2
ln
Character array (8-bit characters)
2.5.3 Unicode Strings (BIFF8)
From BIFF8 on, strings are always stored using UTF-16LE3 text encoding. The character array is a sequence of 16-bit
values4. Additionally it is possible to use a compressed format, which omits the high bytes of all characters, if they are
all zero.
The following table describes the standard format of the entire string, but in many records the strings differ from this
format. This will be mentioned separately. It is possible (but not required) to store Rich-Text formatting information and
Asian phonetic information inside a Unicode string. This results in four different ways to store a string. The character
array is not zero-terminated.
3
For more information see http://en.wikipedia.org/wiki/UTF-16.
4
In most cases each value corresponds to a Unicode character. Only the Unicode characters above U+FFFF are encoded with a
âsurrogate pairâ, that are two 16-bit code values in UTF-16 (see footnote 3).
17
2 Document Structure
⢠Contents of a Unicode String
The string consists of the character count (as usual an 8-bit value or a 16-bit value), option flags, the character array and
optional formatting information. In general, the option flags field occurs also for empty strings. But in a few records, this
field is omitted, if the string is empty. This is mentioned at the respective place.
Offset
Size
Contents
0
1 or 2
Length of the string (character count, ln)
1 or 2
1
Option flags:
Bit
Mask
Contents
0
01H
Character compression (ccompr):
02 = Compressed (8-bit characters)
12 = Uncompressed (16-bit characters)
2
04H
Asian phonetic settings (phonetic):
02 = Does not contain Asian phonetic settings
12 = Contains Asian phonetic settings
3
08H
Rich-Text settings (richtext):
02 = Does not contain Rich-Text settings
12 = Contains Rich-Text settings
[2 or 3]
2
(optional, only if richtext=1) Number of Rich-Text formatting runs (rt)
[var.]
4
(optional, only if phonetic=1) Size of Asian phonetic settings block (in bytes, sz)
var.
ln or 2âln Character array (8-bit characters or 16-bit characters, dependent on ccompr)
[var.]
4ârt
(optional, only if richtext=1) List of rt formatting runs (â2.5.1)
[var.]
sz
(optional, only if phonetic=1) Asian Phonetic Settings Block (see below)
18
2.5 Common Record Substructures
⢠Asian Phonetic Settings Block
Asian phonetic text5 (Ruby) can be used to provide extended phonetic information for specific characters or words. It
appears above the regular text (or to the right of vertical text), and can refer to single characters, groups of characters, or
entire words.
Offset
Size
Contents
0
2
Unknown identifier 0001H
2
2
Size of the following data (10 + 2âln + 6ânp)
4
2
Index to FONT record (â5.45) used for the Asian phonetic text
6
2
Additional settings for the Asian phonetic text:
Bit
Mask
Contents
1-0
0003H
Type of Japanese phonetic text (type):
002 = Katakana (narrow)
102 = Hiragana
012 = Katakana (wide)
3-2
000CH
Alignment of all portions of the Asian phonetic text (align):
002 = Not specified (Japanese only)
102 = Centered
012 = Left (Top for vertical text)
112 = Distributed
5-4
0030H
112 (always set)
8
2
Number of portions the Asian phonetic text is broken into (np).
If np = 0, the Asian phonetic text refers to the entire cell text.
10
2
Total length of the following Asian phonetic text (number of characters, ln)
12
2
Repeated total length of the text
14
2âln or 2
Character array of Asian phonetic text, no Unicode string header, always 16-bit characters.
Note: If ln = 0, this field is not empty but contains 0000H.
14+2âln
6ânp
List of np structures that describe the position of each portion in the main text. Each
structure contains the following fields:
Offset
Size
Contents
0
2
First character in the Asian phonetic text of this portion (cpa)
2
2
First character of the main text belonging to this portion (cpm)
4
2
Number of characters in main text belonging to this portion (ccm)
Example: Japanese word Tokyo (ćąäşŹ) with added hiragana (ă¨ăăăă)6. The following examples show the
contents of the important fields of the Asian Phonetic Settings Block.
Example 1: Hiragana centered over the entire word:
ă¨ăăăă
ćąäşŹ
type = 102 (hiragana)
align = 102 (centered)
np = 0 (no portions, hiragana refers to entire text)
ln = 5 (length of entire hiragana text)
No portion structures
5
For more information see http://en.wikipedia.org/wiki/Ruby_characters.
6
Example taken from http://en.wikipedia.org/wiki/Ruby_characters.
19
2 Document Structure
Example 2: Hiragana left-aligned per character:
ă¨ă
ăăă
ćąäşŹ
type = 102 (hiragana)
align = 012 (left-aligned)
np = 2 (hiragana split into 2 portions)
ln = 5 (length of entire hiragana text)
Portion #1: cpa = 0 (start with 1st hiragana character); cpm = 0; ccm = 1 (attach to 1st character in main text)
Portion #2: cpa = 2 (start with 3rd hiragana character); cpm = 1; ccm = 1 (attach to 2nd character in main text)
2.5.4 RGB Colours
Colour values are represented in RGB mode (red/green/blue).
Offset
Size
Contents
0
1
Red component
1
1
Green component
2
1
Blue component
3
1
Not used
In this documentation, constant colour values are written as 6-digit hexadecimal values in RGB notation: RRGGBBH.
Example: The colour value FF8000H describes the colour orange: red is FFH, green is 80H, and blue is 00H.
2.5.5 RK Values
An RK value is an encoded integer or floating-point value. RK values have a size of 4 bytes and are used to decrease file
size for floating-point values.
Structure of an RK value (32-bit value), BIFF3-BIFF8:
Bit
Mask
Contents
0
00000001H
0 = Value not changed
1 = Encoded value is multiplied by 100
1
00000002H
0 = Floating-point value
1 = Signed integer value
31-2
FFFFFFFCH
Encoded value
If bit 1 is cleared, the encoded value represents the 30 most significant bits of an IEEE 754 floating-point value (64-bit
double precision). The 34 least significant bits must be set to zero. If bit 1 is set, the encoded value represents a signed
30-bit integer value. To get the correct integer, the encoded value has to be shifted right arithmetically by 2 bits. If bit 0
is set, the decoded value (both integer and floating-point) must be divided by 100 to get the final result.
Examples:
RK value
Type
Div 100 Encoded value Decoded value
Result
3FF00000H
float
no
3FF00000H
3FF0000000000000H = 1.0
1.0
3FF00001H
float
yes
3FF00000H
3FF0000000000000H = 1.0
0.01
004B5646H
integer
no
004B5644H
0012D591H = 1234321
1234321
004B5647H
integer
yes
004B5644H
0012D591H = 1234321
12343.21
20
2.5 Common Record Substructures
2.5.6 Error Codes
If the calculation of a formula results in an error or any other action fails, Excel sets a specific error code. These error
codes are used for instance in cell records and formulas.
Error code
Error value
Description
00H
#NULL!
Intersection of two cell ranges is empty
07H
#DIV/0!
Division by zero
0FH
#VALUE!
Wrong type of operand
17H
#REF!
Illegal or deleted cell reference
1DH
#NAME?
Wrong function or range name
24H
#NUM!
Value range overflow
2AH
#N/A
Argument or function not available
2.5.7 Constant Values
Sometimes it is needed to store constant values of different data types. These values are used to create linear lists (for
instance in the CRN record, â5.23), or two-dimensional arrays (â2.5.8). This chapter describes the format of the
individual constant values.
⢠Empty Value
Offset
Size
Contents
0
1
00H (Identifier for an empty constant)
1
8
Not used
⢠Number
Offset
Size
Contents
0
1
01H (Identifier for a numerical constant)
1
8
IEEE 754 floating-point value (64-bit double precision)
⢠String Value
Offset
Size
Contents
0
1
02H (Identifier for a string constant)
1
var.
BIFF2-BIFF5:
Byte string, 8-bit string length (â2.5.2)
BIFF8:
Unicode string, 16-bit string length, option flags occur always (â2.5.3)
⢠Boolean Value
Offset
Size
Contents
0
1
04H (Identifier for a Boolean constant)
1
1
0 = FALSE, 1 = TRUE
2
7
Not used
21
2 Document Structure
⢠Error Value
Offset
Size
Contents
0
1
10H (Identifier for an error constant)
1
1
Error code (â2.5.6)
2
7
Not used
2.5.8 Constant Value Array
Two-dimensional arrays of constant values are used to store cached DDE link results (record EXTERNALNAME,
â5.39), or for constant arrays in formulas (token tArray, â3.8.7). The array starts with the dimensions (width and
height), followed by a list of constant values.
Two-dimensional constant value array, BIFF2-BIFF5:
Offset
Size
Contents
0
1
Number of columns (nc). The value 0 represents 256 columns.
1
2
Number of rows (nr)
3
var.
List of ncânr constant values (â2.5.7)
Two-dimensional constant value array, BIFF8:
Offset
Size
Contents
0
1
Number of columns decreased by 1 (nc)
1
2
Number of rows decreased by 1 (nr)
3
var.
List of (nc+1)â(nr+1) constant values (â2.5.7)
2.5.9 Encoded File URLs
The intention of encoding file URLs is to make them more platform independent. Encoded URLs occur in the records
EXTERNSHEET (BIFF2-BIFF5, â5.41) or EXTERNALBOOK (BIFF8, â5.38), and DCONREF (â5.30).
The first character of the URL is used to determine the type of encoding. In Unicode strings (BIFF8) this could be a
16-bit value.
First character
BIFF2-BIFF4
BIFF5
BIFF8
00H
Not used
Reference relative to the current
Reference relative to the current
sheet (nothing will follow), used sheet (nothing will follow), used
e.g. in defined names
e.g. in defined names
01H
Encoded URL follows
Encoded URL follows
Encoded URL follows
02H
Reference to the current
Reference to the current sheet
Reference to a sheet in the own
sheet (nothing will follow) (nothing will follow)
document (sheet name follows)
03H
Not used
Reference to a sheet in the own
Not used
document (sheet name follows)
04H
Not used
Reference to the own workbook, Not used
sheet is unspecified (nothing will
follow)
others
Not encoded. This is already the first character of the URL.
22
2.5 Common Record Substructures
Inside of the encoded URL there can occur several control characters.
Control character Meaning
01H
An MS-DOS drive letter will follow, or â@â and the server name of a UNC path
02H
Start path name on same drive as own document
03H
End of subdirectory name
04H
Parent directory
05H
Unencoded URL. Followed by the length of the URL (1 byte), and the URL itself.
06H
Start path name in installation directory of Excel
08H
Macro template directory in installation directory of Excel
09H
Sheet in the same workbook (BIFF4W)
If a sheet name follows the file name in the encoded URL (BIFF4W-BIFF8), the file name (but not the file path) will be
enclosed in brackets. Note that in EXTERNALBOOK records (BIFF8) sheet names do not occur and therefore the file
names are not enclosed in brackets.
Examples for BIFF2-BIFF4 (own document is saved as âC:\path\own.xlsâ):
Formula
Encoded filename
=own.xls!A1
<02H>
=ext.xls!A1
<01H>ext.xls
='sub\ext.xls'!A1
<01H>sub<03H>ext.xls
='\ext.xls'!A1
<01H><02H>ext.xls
='\sub\ext.xls'!A1
<01H><02H>sub<03H>ext.xls
='\sub\sub2\ext.xls'!A1
<01H><02H>sub<03H>sub2<03H>ext.xls
='..\sub\ext.xls'!A1
<01H><04H>sub<03H>ext.xls
='D:\sub\ext.xls'!A1
<01H><01H>Dsub<03H>ext.xls
='\\pc\sub\ext.xls'!A1
<01H><01H>@pc<03H>sub<03H>ext.xls
='http://www.example.org/ext.xls'!A1
<01H><05H><1EH>http://www.example.org/ext.xls
(the length of the URL (30 = 1EH) follows the 05H byte)
Examples for BIFF4W internal references (all formulas are located on âSheet1â):
Formula
Encoded filename
=Sheet1!A1
<02H>
=Sheet2!A1
<01H><09H>Sheet2
Examples for BIFF5 internal references (all formulas are located on âSheet1â):
Formula
Encoded filename
=Sheet1!A1
<02H>
=Sheet2!A1
<03H>Sheet2
=NonExistentSheet!A1
<04H>
Examples for BIFF8 internal references (for example in record DCONREF):
Formula
Encoded filename
=Sheet2!A1
<02H>Sheet2
23
2 Document Structure
Examples for BIFF4W-BIFF8 external references (own document is saved as âC:\path\own.xlsâ):
Formula
Encoded filename
=[ext.xls]Sheet1!A1
<01H>[ext.xls]Sheet1
='sub\[ext.xls]Sheet1'!A1
<01H>sub<03H>[ext.xls]Sheet1
='\[ext.xls]Sheet1'!A1
<01H><02H>[ext.xls]Sheet1
='\sub\[ext.xls]Sheet1'!A1
<01H><02H>sub<03H>[ext.xls]Sheet1
='\sub\sub2\[ext.xls]Sheet1'!A1 <01H><02H>sub<03H>sub2<03H>[ext.xls]Sheet1
='..\sub\[ext.xls]Sheet1'!A1
<01H><04H>sub<03H>[ext.xls]Sheet1
='D:\sub\[ext.xls]Sheet1'!A1
<01H><01H>Dsub<03H>[ext.xls]Sheet1
='\\pc\sub\[ext.xls]Sheet1'!A1
<01H><01H>@pc<03H>sub<03H>[ext.xls]Sheet1
='http://www.example.org/
<01H><05H><26H>http://www.example.org/[ext.xls]Sheet1
[ext.xls]Sheet1'!A1
(the length of the URL (38 = 26H) follows the 05H byte)
2.5.10 Encoded DDE and OLE Links
A DDE link contains the name of the server application and the DDE topic. An OLE link contains the class name and
the URL of the document. In both cases the names are stored in one string, separated by the control character 03H. The
URLs are not encoded.
Example: A document contains a DDE link and an OLE link to Sheet1 in the file âD:\sub\example.xlsâ.
Link
Server/Class
Topic/URL
Encoded document name
DDE
excel
D:\sub\[example.xls]Sheet1
excel<03H>D:\sub\[example.xls]Sheet1
OLE
Excel.Sheet.8
D:\sub\example.xls
Excel.Sheet.8<03H>D:\sub\example.xls
2.5.11 Line Styles for Cell Borders (BIFF3-BIFF8)
These line styles are used to define cell borders. The styles 08H to 0DH are available in BIFF8 only.
Index Style
Sample
Index Style
Sample
00H
No line
The following for BIFF8 only:
01H
Thin
08H
Medium dashed
02H
Medium
09H
Thin dash-dotted
03H
Dashed
0AH
Medium dash-dotted
04H
Dotted
0BH
Thin dash-dot-dotted
05H
Thick
0CH
Medium dash-dot-dotted
06H
Double
0DH
Slanted medium dash-dotted
07H
Hair
24
2.5 Common Record Substructures
2.5.12 Patterns for Cell and Chart Background Area
The background area of cells (BIFF3-BIFF8) and chart objects (BIFF2-BIFF8) may contain a pattern. Pattern colour and
pattern background colour are defined separately. In the following table black is used as pattern colour and white as
pattern background colour.
Index
Pattern Sample
Index
Pattern Sample
00H
No pattern
01H
0AH
02H
0BH
03H
0CH
04H
0DH
05H
0EH
06H
0FH
07H
10H
08H
11H
09H
12H
The following table shows how a pattern is used with the correct colour indexes.
Cell format
Pattern Pattern colour index
Background colour index
No background (shows system window
00H
System window text (not used)
System window background
background)
Red background (solid)
01H
Red
System window text (not used)
Red background with thin horizontal
0BH
Blue
Red
blue lines
Red background with thin horizontal
0BH
System window text
Red
lines, automatic colour
No background, thin horizontal blue
0BH
Blue
System window background
lines
No background, thin horizontal lines,
0BH
System window text
System window background
automatic colour
The description of the PALETTE record (â5.74) contains information how the special system colours are used. Note the
behaviour of solid coloured backgrounds, where pattern 01H is used in conjunction with the pattern colour.
25
2 Document Structure
2.5.13 Cell Attributes (BIFF2)
All cell records in BIFF2 contain a cell attribute field with a size of 3 bytes. They contain an index to an XF record
(â5.115) and some repeated contents of the referenced XF record. The XF index field has a size of only 6 bits, so the
index range is 0âŚ63. If a real XF index greater than 62 is used, the XF index field always contains the value 63, and an
IXFE record (â5.62) occurs in front of a cell record. The IXFE record contains the correct index of the XF record. In a
ROW record (â5.88) this field is not used, because there will always occur a real XF index field.
Cell attributes field (3 bytes), BIFF2:
Offset
Size
Contents
0
1
Cell protection and XF index:
Bit
Mask
Contents
5-0
3FH
Index to XF record (â5.115). The value 3FH = 63 indicates a
preceding IXFE record (â5.62). Not used in ROW records (â5.88).
6
40H
1 = Cell is locked
7
80H
1 = Formula is hidden
1
1
Indexes to FORMAT and FONT records:
Bit
Mask
Contents
5-0
3FH
Index to FORMAT record (â5.49)
7-6
C0H
Index to FONT record (â5.45)
2
1
Cell style:
Bit
Mask
Contents
2-0
07H
XF_HOR_ALIGN â Horizontal alignment (â5.115.1)
3
08H
1 = Cell has left black border
4
10H
1 = Cell has right black border
5
20H
1 = Cell has top black border
6
40H
1 = Cell has bottom black border
7
80H
1 = Cell has shaded background
2.5.14 Cell Range Address
A cell range address specifies a fixed cell range in the current sheet.
Cell range address, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Index to first row
2
2
Index to last row
4
1
Index to first column
5
1
Index to last column
Cell range address, BIFF8:
Offset
Size
Contents
0
2
Index to first row
2
2
Index to last row
4
2
Index to first column
6
2
Index to last column
In several cases, BIFF8 still writes the BIFF2-BIFF5 format of a cell range address (using 8-bit values for the
! column indexes). This will be mentioned at the respective place.
26
2.5 Common Record Substructures
2.5.15 Cell Range Address List
A cell range address list consists of a field with the number of ranges and the list of the range addresses.
Cell range address list, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Number of following cell range addresses (nm)
2
6ânm or 8ânm List of nm cell range addresses (â2.5.14)
In several cases, BIFF8 still writes the BIFF2-BIFF5 format of a cell range address (using 8-bit values for the
! column indexes). This will be mentioned at the respective place.
27
3 Formulas
3
Formulas
3.1 Common Formula Structure
3.1.1 Common Structure
Formulas are stored as part of a record, for instance inside of a FORMULA record or a DEFINEDNAME record. The
common format of a formula is as follows:
Formula in BIFF2:
Offset
Size
Contents
0
1
Size of the following formula data (RPN token array, sz)
1
sz
Formula data (RPN token array)
[1+sz]
var.
(optional) Additional data for specific tokens (â3.1.6, for example tArray token, â3.8.7)
Formula in BIFF3-BIFF8:
Offset
Size
Contents
0
2
Size of the following formula data (sz)
2
sz
Formula data (RPN token array)
[2+sz]
var.
(optional) Additional data for specific tokens (â3.1.6, for example tArray token, â3.8.7)
Sometimes the size field is not stored directly before the RPN token array, but somewhere else. If this happens, it will be
mentioned at the respective place. If there does not exist any formula data, only the size field (which contains 0 then) is
present.
3.1.2 Tokens
Definition: Formula token
Formula tokens are the indivisible particles of a formula. There might be operators, numerical or string constants
or function names.
Each token contains a token identifier. Several tokens contain additional information. A token does not contain any size
information, so importing and exporting tokens must be done carefully.
Common structure of a formula token, BIFF2-BIFF8:
Offset
Size
Contents
0
1
Token identifier
[1]
var.
(optional) Additional data for the token
28
3.1 Common Formula Structure
3.1.3 Token Notation
Tokens are referred to by their name. All token names start with a small âtâ (for âTokenâ). If a token contains additional
information, it is appended to the token name in parentheses.
Examples:
The addition operator + is represented by the token tAdd. It does not contain any additional data.
The integer constant 1 is represented by the token tInt(1).
An absolute reference to cell $A$1 is represented by the token tRef($A$1).
3.1.4 Operators
There are 3 types of operators:
⢠Unary operators like the minus sign that negates a value. These operators pop the topmost operand from the stack.
⢠Binary operators like addition or multiplication. These operators pop the two topmost operands from the stack.
⢠Function operators represent the sheet functions of Excel. They operate on different numbers of topmost operands on
the stack. Either the function expects a fixed number of operands (for instance SIN expects one operand), or a
variable number of operands given in the function token (for instance SUM is able to process 0 to 30 operands).
All operators push the (single) result of their operation back onto the stack.
3.1.5 Token Arrays
Definition: Token array
The token array represents an entire formula and contains all used tokens of the formula in a specific order.
The tokens of the formula are stored in the Reverse-Polish Notation (RPN). This means, first there occur all operands of
an operation, followed by the respective operator.
Example: the simple term 1+2 consists of the 3 tokens â1â, â+â and â2â. Written in RPN, the formula is
converted to the token list â1â, â2â, â+â.
During parsing such an expression, operands are pushed onto a stack. An operator pops the needed number of operands
from stack, performs the operation and pushes the result back onto the stack.
29
3 Formulas
Other examples for RPN token arrays:
Formula
Token array
Excel notation
Parsing result
2*4+5
2, 4, *, 5, +
tInt(2), tInt(4),
First, the integer constants 2 and 4 are pushed onto
tMul, tInt(5), tAdd the stack. The * operator pops them from the stack
and pushes 8. Then the constant 5 is pushed. The +
operator pops 5 and 8 and pushes 13 (the final
result).
2+4*5
2, 4, 5, *, +
tInt(2), tInt(4),
First, the integer constants 2, 4, and 5 are pushed
tInt(5), tMul, tAdd onto the stack. The * operator pops 5 and 4 and
pushes 20, the + operator pops 20 and 2 and
pushes 22 (the final result).
ABS(2*âA1) 2, A1, -, *, ABS
tInt(2), tRefV(A1), First, the integer constant 2 and the value from cell
tUminus, tMul,
A1 (for example 3) are pushed onto the stack. The
tFunc(ABS)
unary - operator (tUminus) pops the topmost value
3 from stack and pushes the negated value -3. The
* operator pops -3 and 2 and pushes -6. The ABS
function needs 1 parameter. It pops -6 and pushes
6 (the final resut).
Example of the complete byte representation of the formula 2*4+5.
⢠The RPN representation of the formula is: 2, 4, 5, *, +.
⢠Written in Excel token notation, this is: tInt(2), tInt(4), tInt(5), tMul, tAdd.
Offset
Size
Contents
Token name Description
0
2
000BH
Size of the following formula data (sz)
2
1
1EH
tInt
} Integer value token for 2
3
2
0002H
5
1
1EH
tInt
} Integer value token for 4
6
2
0004H
8
1
05H
tMul
Multiplication operator
9
1
1EH
tInt
} Integer value token for 5
10
2
0005H
12
1
03H
tAdd
Addition operator
30
3.1 Common Formula Structure
3.1.6 Additional Token Data
A few tokens contain additional data that does not follow the token identifier, but is appended to the token array. Its size
is not contained in the leading field containing the token array size. Affected tokens are the tArray token (â3.8.7), the
tMemArea token (â3.9.4), and a few subtypes of the the tNlr token (â3.10.4). The additional data of each token is
appended in the same order the tokens are located in the token array.
Example: The formula ={1}+A1:A2 A2:A3+{2} contains 3 tokens with additional data: 2 tArray tokens
representing the contant arrays, and a tMemArea token containing the result of the intersection operator (the cell
reference A2). The detailed example below applies for BIFF8.
⢠The RPN representation of the formula is: {1}, A1:A2, A2:A3, â â, +, {2}, +.
⢠Written in Excel token notation, this is (the term A1:A2, A2:A3, â â is led by a tMemArea token):
tArrayV({1}), tMemAreaV(A2), tAreaR(A1:A2), tAreaR(A2:A3), tIsect, tAdd, tArrayV({2}), tAdd.
Offset
Size
Token name Description
0
2
Size of the following formula data (44 bytes), without the additional
data following the last tAdd token
2
8
tArrayV
Placeholder for first constant array {1}
10
7
tMemAreaV Constant reference subexpression follows in next 19 bytes (until and
including the tIsect token)
17
9
tAreaR
Cell reference A1:A2
26
9
tAreaR
Cell reference A2:A3
35
1
tIsect
Intersection operator
36
1
tAdd
Addition operator
37
8
tArrayV
Placeholder for second constant array {2}
45
1
tAdd
Addition operator
46
12
Constant value array (â2.5.8) containing the values of the constant
array {1}: contains width 1, height 1, value 1
58
10
Cell range address list (â2.5.15) containing the result of the
reference subexpression A1:A2 A2:A3: a one-element list with the
cell address A2
68
12
Constant value array (â2.5.8) containing the values of the constant
array {2}: contains width 1, height 1, value 2
31
3 Formulas
3.2 Token Classes
3.2.1 Classified Tokens
All function operators and most operand tokens exist in 3 different versions: as reference class token, value class token,
and array class token. The token class depends on which type of data the involved operator expects. Sometimes only 1
or 2 token classes are valid for a token (for example, array class tokens cannot exist as reference class tokens, but they
can exist as value class tokens).
⢠Reference class token: The reference address itself, independent of the cell contents.
⢠Value class token: A value (a constant, a function result, or one specific value from a dereferenced cell range).
⢠Array class token: An array of values (array of constant values, an array function result, or all values of a cell range).
The structure of the 8-bit identifier of a classified token is described in the following table.
Bit
Mask
Contents
4-0
1FH
Basic token identifier
6-5
60H
012 = Reference class token (token range 20H-3FH)
102 = Value class token (token range 40H-5FH)
112 = Array class token (token range 60H-7FH)
7
80H
02 (zero)
The token class is marked in the names of the tokens. The names of reference class tokens contain a trailing âRâ, value
class tokens contain a trailing âVâ, and the names of array class tokens a trailing âAâ.
Example: The tArea token (â3.9.3) is no specific token, but refers to the three tokens tAreaR (25H),
tAreaV (45H), and tAreaA (65H).
⢠The tAreaR token represents the cell range address itself.
⢠The tAreaV token represents one value in the cell range (for example the value in the current row or column).
⢠The tAreaA token represents the entire array of values in the cell range.
3.2.2 Operand Classes
Each operator and operand has a default token class, called operand class. For operands itself, the operand class is
dependent on the data the token represents. The operand class of operators is determined from its return value. For
functions (tokens tFunc, â3.7.1, and tFuncVar, â3.7.2), the operand class is dependent on the value the function
returns. Classified tokens can represent their operand class, other tokens cannot.
Examples for operand classes:
Term
Operand class Token identifier
Description
A1
Reference
tRefR
Reference to cell A1
A1 A1
Reference
tIsect
Return value of the intersection operator
INDEX(A1,1,1)
Reference
tFuncVarR
Return value of the INDEX function
2
Value
tInt
The constant 2
2+3
Value
tAdd
Return value of the addition operator
SUM(2,3)
Value
tFuncVarV
Return value of the SUM function
{2,3}
Array
tArrayA
The constant array {2,3}
TREND({2,3})
Array
tFuncVarA
Return value of the TREND function
32
3.2 Token Classes
3.2.3 Expected Parameter Classes
Function parameters expect operands of specific operand classes. The expected token classes of all function parameters
are specified in the list of built-in functions (â3.11). The result of the whole formula is handled as a parameter, called
the root level parameter (the parameter of the equality sign). The root level also expects a specific token class.
Examples for function parameter classes:
⢠Reference class:
ROW(A1) (the first parameter of the function ROW expects reference class, ROW(1) would produce an error).
⢠Value class:
ABS(A1) (the first parameter of the function ABS expects value class, it dereferences the cell reference to a
value).
⢠Array class:
MDETERM(A1:C3) (the first parameter of the function MDETERM expects array class, it dereferences the
cell range to an array of values).
⢠Root level:
=A1 (parameter is on formula root level, expected class is dependent on formula type).
3.2.4 Token Class Transformation
The final class of a token depends on the combination of the operand class of the token and the expected parameter
class. Furthermore it is dependent on the type of the formula. There are 3 different types of formulas:
Formula type
Examples
Cell type formula
Cell formulas (â4.7), shared formulas (â4.8)
Array type formula
Array formulas (â4.8), conditional formatting (â4.12), data validity (â4.14)
Name type formula
Defined names (â4.10), reference lists (for example chart source range, form control links)
Token class transformation is done in several steps. All steps have to be performed for each classified token in a formula.
⢠Step 1: Value Operators
If the token has reference operand class, and if it is a direct operand of a unary or binary value operator (tAdd, tSub,
tMul, tDiv, tPower, tConcat, tLT, tLE, tEQ, tGE, tGT, tNE, tUplus, tUminus, or tPercent â the binary reference
operators tRange, tList, and tIsect are not included here), its class will be changed to value class, and further handling is
done regarding this new class (for example it may be changed to array class later).
Example: In the formula =SUM(A1,B1+1), the cell addresses A1 and B1 are represented by tRefR tokens.
Because the second tRefR token containing B1 has reference operand class, and it is an operand of the addition
operator, it will be changed to value class (tRefV). As described below, in array type formulas this token will be
changed to array class then, while the reference class of the first tRefR(A1) token is retained.
33
3 Formulas
⢠Step 2: Forced Array Class
If the token is part of a function parameter (directly or indirectly, for example nested in another function), transformation
of the token class is dependent on the expected token classes of all involved functions. For this purpose, a Boolean state
âforced array classâ is carried, and it will be updated whenever processing of a new function parameter is started. If this
state is set to true already, nothing will be changed (the state is still true). If the state is false, it will be changed to true,
if one of the following conditions is met:
⢠In cell type formulas: if the parameter expects array class, or
⢠In array type formulas: if the parameter expects reference class or array class, or
⢠In name type formulas: if the parameter expects reference class or array class, or if the function returns a value with
value class or array class.
The forced array class state will be restored, when the entire function parameter is processed. The state starts with false
at root level of all formula types.
As described below, the cell formula =ABS(A1) changes its tRefR token to value class (tRefV). The formula
=MDETERM(ABS(A1)) behaves differently: The first parameter of the MDETERM function expects array
class. Therefore the âforced array classâ state is set to true, when the parameter (the term SUM(A1)) is started.
This state is the reason that the tRefR token will be changed to array class (tRefA), regardless that the ABS
function does not indicate this. When the parameter is completed, the forced array class state is restored to its
old value (false).
⢠Step 3: Token Class Transformation
Token class transformation is dependent on the expected token class of the current position in the formula.
⢠Current position is a function parameter expecting a reference class token (for example the parameters of the SUM
function), or it is the root level of a name type formula (for example the return value of the outer function in a defined
name):
⪠Reference class tokens are not modified.
⪠Value class tokens will be changed dependent on further conditions. In array type functions and name type
functions, or if the forced array class state is set, it is changed to array class. In all other cases (cell type formula
without forced array class), value class is retained.
⪠Array class tokens are not modified.
Examples for reference class tokens, when reference class is expected:
⢠In the formula =SUM(A1), the tRefR token is not modified (function parameter expects reference class).
⢠In the defined name =Sheet1!A1, the tRef3dR token is not modified (root level of a name type formula).
Examples for value class tokens, when reference class is expected:
⢠In the cell formula =SUM(PI()), the tFuncV(PI) token is not modified (cell formula, no forced array class).
⢠In the array formula {=SUM(PI())}, the tFuncV(PI) token is set to array class (array type formula).
⢠In the cell formula =MDETERM(SUM(PI())), the tFuncV(PI) token is set to array class (forced array
class in MDETERM function parameter).
Examples for array class tokens, when reference class is expected:
⢠In the formula =SUM({1}), the tArrayA token is not modified.
⢠In the defined name ={1}, the tArrayA token is not modified (root level of a name type formula).
34
3.2 Token Classes
⢠Current position is a function parameter expecting a value class token (for example the parameter of the ABS
function), or it is the root level of a cell type formula or an array type formula (for example the return value of the
outer function in a cell formula, a shared formula, or an array formula):
⪠If the forced array class state is set, all tokens will be changed to array class, otherwise to value class.
Examples for token transformation, when value class is expected without forced array class state:
⢠In the cell formula =ABS(A1), the tRefR token is changed to value class (tRefV), and the tFuncV(ABS)
token keeps its value class (root level of a cell function).
⢠In the cell formula =ABS(PI()), the tFuncV(PI) token keeps unchanged.
⢠In the cell formula =ABS({1}), the tArrayA token is changed to value class (tArrayV).
Examples for token transformation, when value class is expected with forced array class state:
⢠In the name formula =ABS(A1), the tRefR token is changed to array class (tRefA, a name type formula sets
the forced array class state for all parameters of functions returning a value).
⢠In the cell formula =MDETERM(ABS(A1)), the tRefR token is set to array class (tRefA, forced array class
in MDETERM function parameter).
⢠Current position is a function parameter expecting an array class token (for example the parameter of the MDETERM
function):
⪠All tokens are changed to array class.
Examples for token transformation, when array class is expected:
⢠In the formula =MDETERM(A1), the tRefR token is changed to array class (tRefA).
⢠In the formula =MDETERM(PI()), the tFuncV(PI) token is changed to array class (tFuncA).
⢠In the formula =MDETERM({1}), the tArrayA token keeps unchanged.
3.2.5 Binary Reference Operators
The binary reference operators tIsect (â3.6.13), tList (â3.6.14), and tRange (â3.6.15) are always encapsulated into
reference subexpression tokens (for instance tMemArea, â3.9.4, or tMemFunc, â3.9.7). These tokens will change their
token class, but the operands of the reference operators will not be changed. Because these operators require reference
operands (constant references or functions returning a reference), the actual operands of these operators always have
reference class.
Example: The ABS function in the cell formula =ABS(A1 A1) expects value class for its parameter. The inter-
section operator tIsect and its operands are encapsulated into a tMemAreaR token, which is changed to value
class in cell formulas. The tRefR tokens of the intersection operator are not changed.
The resulting token array of this formula is:
tMemAreaV, tRefR(A1), tRefR(A1), tIsect, tFuncV(ABS).
35
3 Formulas
3.3 Cell Addresses in Tokens
All tokens containing cell addresses (with the two components row and column) store them in the same format. There are
differences in storing relative components of an address.
3.3.1 Absolute and Relative Components of a Cell Address
An absolute component of an address (for example the row in B$6) points always to the same fixed row or column. It is
stored with its zero-based index (the value 0 refers to row 1 or column A).
To store a relative component (for example the column in B$6), there are two different ways used in an Excel file:
⢠In method [A], the reference component is stored equally to absolute components (with its zero-based index), together
with the information, that the component is relative.
⢠In method [B], a signed offset is stored for the reference component. The resulting address can be calculated later from
the position in the current context (for example the cell position in which a defined name is used).
The following table shows which formula type in Excel uses which method to store relative components:
Method
Formula type
[A]
Cell formulas (â4.7), array formulas (â4.8)
[B]
Shared formulas (â4.8), conditional formatting (â4.12), data validity (â4.14), defined names (â4.10)
Example for method [A]: The reference in the cell formula =C4 is stored in a tRef token (â3.9.2). Regardless of
the position of the formula, the token always contains the row index 3 (zero-based index for row 4) and the
column index 2 (zero-based column index for column C), together with two flags, that row and column indexes
are relative. These flags are used for example when the cell is copied to another position (to adjust the relative
reference components), but they do not influence the evaluation of the formula.
Example for method [B]: The reference in the condition =C4 in a conditional formatting, entered in cell A7, is
stored in a tRefN token (â3.9.10). The token does not contain the address C4 itself, but the difference to the
base cell A7, therefore it contains the row offset â3 (three rows up) and the column offset +2 (2 columns to the
right). If the same conditional formatting is copied, the token will not be modified, because it only contains
offset values, and not an explicit cell address. If it is copied for example to cell B8, the condition will refer to
cell D5 (three rows up and 2 columns to the right from cell B8).
36
3.3 Cell Addresses in Tokens
3.3.2 Reference Token Replacement
In formulas using method [B], several tokens are replaced by similar tokens that have the letter âNâ appended to their
name. Other tokens do not have such a counterpart and are used in both types of formulas (for example, tRef always uses
method [A], tRefN always uses method [B], and tRef3d uses either method, dependent on the formula type). The
following tables show the details.
Reference token replacement, BIFF2-BIFF4:
Cell formulas, array formulas [A]
Defined names [B]
tRef/tArea
tRefN/tAreaN
tRefErr/tAreaErr
tRefErr/tAreaErr
tMemArea
tMemAreaN
tMemNoMem
tMemNoMemN
tMemFunc
tMemFunc
tMemErr
tMemErr
Reference token replacement, BIFF5-BIFF8:
Cell formulas, array
Conditional formatting, data
formulas [A]
Defined names [B]
Shared formulas [B]
validity [B] (BIFF8)
tRef/tArea
tRef3d/tArea3d
tRefN/tAreaN
tRefN/tAreaN
tRefErr/tAreaErr
tRefErr3d/tAreaErr3d
tRefErr/tAreaErr
tRefErr/tAreaErr
tRef3d/tArea3d
tRef3d/tArea3d
â
â
tRefErr3d/tAreaErr3d
tRefErr3d/tAreaErr3d
â
â
tMemArea
tMemFunc
â
â
tMemNoMem
tMemFunc
â
â
tMemFunc
tMemFunc
â
â
tMemErr
tMemErr
â
â
In BIFF5-BIFF8, the tRefN and tAreaN tokens do not occur, if all components of the contained cell address or cell
range address are absolute. In this case, the respective tRef or tArea tokens are used.
Example: The shared formulas =A1, =$A1, and =A$1 (shared formulas use method [B]) use a tRefNV token.
But the shared formula =$A$1 uses a tRefV token instead.
37
3 Formulas
3.3.3 Cell Addresses in BIFF2-BIFF5
In the file format versions up to BIFF5, it is possible to use 16384 (214) rows. A cell address contains the row index as a
14-bit value, the column index as an 8-bit value, and two flags. The flags, encoded into the row index, specify whether
the row or column index is absolute or relative. The differences in interpreting relative indexes are described in 3.3.1.
Index to row or row offset, with embedded relative flags (16-bit value), BIFF2-BIFF5:
Bit
Mask
Contents
13-0
3FFFH
Index to row (0âŚ16383) or row offset (method [B], -8192âŚ8191)
14
4000H
0 = Absolute column index
1 = Relative column index, or column offset
15
8000H
0 = Absolute row index
1 = Relative row index, or row offset
Cell address, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Index to row or row offset, with relative flags (see table above)
2
1
Index to column (0âŚ255) or column offset (method [B], -128âŚ127)
Cell range address, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Index to first row or offset of first row, with relative flags (see table above)
2
2
Index to last row or relative offset of last row, with relative flags (see table above)
4
1
Index to first column (0âŚ255) or offset of first column (method [B], -128âŚ127)
5
1
Index to last column (0âŚ255) or offset of last column (method [B], -128âŚ127)
Example for a reference in a cell formula (method [A], token tRef): The reference B$6 consists of the absolute
row index 5 and the relative column index 1. The value of the encoded row index is 4005H (row 6, column is
relative). The value of the column index is 01H (column B). Though the column is relative, the fixed index to
column B is stored in cell formulas.
Example for a relative reference in a shared formula (method [B], token tRefN): The reference âdecrease column
by 1, absolute row 6â (which would evaluate to the address B6, if used in cell C1) consists of the absolute row
index 5, and (in shared formulas) the relative column offset â1. The value of the encoded row index is 4005H
(row 6, column is relative). The value of the column index is FFH (the signed offset â1).
38
3.3 Cell Addresses in Tokens
3.3.4 Cell Addresses in BIFF8
From BIFF8 on, 65536 (216) rows are available. A cell address contains the row index as a 16-bit value, the column
index as an 8-bit value, and two flags. The flags are encoded into the column index (which therefore needs 2 bytes), and
specify whether the row or column index is absolute or relative. The differences in interpreting relative indexes are
described in 3.3.1.
Index to column or column offset, with embedded relative flags (16-bit value), BIFF8:
Bit
Mask
Contents
7-0
00FFH
Index to column (0âŚ255) or column offset (method [B], -128âŚ127)
14
4000H
0 = Absolute column index
1 = Relative column index, or column offset
15
8000H
0 = Absolute row index
1 = Relative row index, or row offset
Cell address, BIFF8:
Offset
Size
Contents
0
2
Index to row (0âŚ65535) or row offset (method [B], -32768âŚ32767)
2
2
Index to column or column offset, with relative flags (see table above)
Cell range address, BIFF8:
Offset
Size
Contents
0
2
Index to first row (0âŚ65535) or offset of first row (method [B], -32768âŚ32767)
2
2
Index to last row (0âŚ65535) or offset of last row (method [B], -32768âŚ32767)
4
2
Index to first column or offset of first column, with relative flags (see table above)
6
2
Index to last column or offset of last column, with relative flags (see table above)
Example for a reference in a cell formula (method [A], token tRef): The reference B$6 consists of the absolute
row index 5 and the relative column index 1. The value of the row index is 0005H (row 6). The value of the
encoded column index is 4001H (column B, column is relative). Though the column is relative, the fixed index
to column B is stored in cell formulas.
Example for a relative reference in a shared formula (method [B], token tRefN): The reference âdecrease column
by 1, absolute row 6â (which would evaluate to the address B6, if used in cell C1) consists of the absolute row
index 5, and (in shared formulas) the relative column offset â1. The value of the row index is 0005H (row 6). The
value of the encoded column index is 7FFFH (the signed 14-bit offset 3FFFH = â1, and the column relative flag).
39
3 Formulas
3.4 Token Overview
Following a list of all tokens, separated into the several token types and ordered by token identifier.
3.4.1 Unary Operator Tokens
Token ID
Token name
Description
12H
tUplus
Unary plus
13H
tUminus
Unary minus
14H
tPercent
Percent sign
3.4.2 Binary Operator Tokens
Token ID
Token name
Description
03H
tAdd
Addition
04H
tSub
Subtraction
05H
tMul
Multiplication
06H
tDiv
Division
07H
tPower
Exponentiation
08H
tConcat
Concatenation
09H
tLT
Less than
0AH
tLE
Less than or equal
0BH
tEQ
Equal
0CH
tGE
Greater than or equal
0DH
tGT
Greater than
0EH
tNE
Not equal
0FH
tIsect
Cell range intersection
10H
tList
Cell range list
11H
tRange
Cell range
3.4.3 Function Operator Tokens
Token ID
Token name
Description
21H 41H 61H
tFunc
Function with fixed number of arguments
22H 42H 62H
tFuncVar
Function or macro command with variable number of arguments
38H 58H 78H
tFuncCE
Macro command with variable number of arguments (BIFF2-BIFF3)
40
3.4 Token Overview
3.4.4 Constant Operand Tokens
Token ID
Token name
Description
16H
tMissArg
Missing argument
17H
tStr
String constant
1CH
tErr
Error constant
1DH
tBool
Boolean constant
1EH
tInt
Integer constant
1FH
tNum
Floating-point constant
20H 40H 60H
tArray
Array constant
3.4.5 Operand Tokens
Token ID
Token name
Description
23H 43H 63H
tName
Internal defined name
24H 44H 64H
tRef
2D cell reference
25H 45H 65H
tArea
2D area reference
26H 46H 66H
tMemArea
Constant reference subexpression
27H 47H 67H
tMemErr
Deleted constant reference subexpression
28H 48H 68H
tMemNoMem
Incomplete constant reference subexpression
29H 49H 69H
tMemFunc
Variable reference subexpression
2AH 4AH 6AH
tRefErr
Deleted 2D cell reference
2BH 4BH 6BH
tAreaErr
Deleted 2D area reference
2CH 4CH 6CH
tRefN
Relative 2D cell reference
2DH 4DH 6DH
tAreaN
Relative 2D area reference
2EH 4EH 6EH
tMemAreaN
Relative constant reference subexpression
2FH 4FH 6FH
tMemNoMemN
Incomplete relative constant reference subexpression
39H 59H 79H
tNameX
External name (BIFF5-BIFF8)
3AH 5AH 7AH
tRef3d
3D cell reference (BIFF5-BIFF8)
3BH 5BH 7BH
tArea3d
3D area reference (BIFF5-BIFF8)
3CH 5CH 7CH
tRefErr3d
Deleted 3D cell reference (BIFF5-BIFF8)
3DH 5DH 7DH
tAreaErr3d
Deleted 3D area reference (BIFF5-BIFF8)
3.4.6 Control Tokens, Special Tokens
Token ID
Token name
Description
01H
tExp
Matrix formula or shared formula
02H
tTbl
Multiple operation table
15H
tParen
Parentheses
18H
tNlr
Natural language reference (BIFF8)
19H
tAttr
Special attribute
1AH
tSheet
Start of external sheet reference (BIFF2-BIFF4)
1BH
tEndSheet
End of external sheet reference (BIFF2-BIFF4)
41
3 Formulas
3.4.7 Overview, Ordered by Token Identifiers
The following table shows all tokens, ordered by their identifiers, together with their sizes in bytes. The sizes include the
token identifier. Note that the tStr token, the tNlr token, and the tAttr token do not have a fixed size.
⢠Base Tokens (00Hâ1FH)
Token ID
Token name
BIFF2
BIFF3
BIFF4 BIFF5/7 BIFF8
00H
Not used
â
â
â
â
â
01H
tExp
4
5
5
5
5
02H
tTbl
4
5
5
5
5
03H
tAdd
1
1
1
1
1
04H
tSub
1
1
1
1
1
05H
tMul
1
1
1
1
1
06H
tDiv
1
1
1
1
1
07H
tPower
1
1
1
1
1
08H
tConcat
1
1
1
1
1
09H
tLT
1
1
1
1
1
0AH
tLE
1
1
1
1
1
0BH
tEQ
1
1
1
1
1
0CH
tGE
1
1
1
1
1
0DH
tGT
1
1
1
1
1
0EH
tNE
1
1
1
1
1
0FH
tIsect
1
1
1
1
1
10H
tList
1
1
1
1
1
11H
tRange
1
1
1
1
1
12H
tUplus
1
1
1
1
1
13H
tUminus
1
1
1
1
1
14H
tPercent
1
1
1
1
1
15H
tParen
1
1
1
1
1
16H
tMissArg
1
1
1
1
1
17H
tStr
var.
var.
var.
var.
var.
18H
tNlr
â
â
â
â
var.
19H
tAttr
var.
var.
var.
var.
var.
1AH
tSheet
8
11
11
â
â
1BH
tEndSheet
4
5
5
â
â
1CH
tErr
2
2
2
2
2
1DH
tBool
2
2
2
2
2
1EH
tInt
3
3
3
3
3
1FH
tNum
9
9
9
9
9
42
3.4 Token Overview
⢠Classified Tokens (20Hâ7FH)
Token ID
Token name
BIFF2
BIFF3
BIFF4 BIFF5/7 BIFF8
20H 40H 60H
tArray
7
8
8
8
8
21H 41H 61H
tFunc
3
3
4
4
4
22H 42H 62H
tFuncVar
4
4
5
5
5
23H 43H 63H
tName
8
11
11
15
5
24H 44H 64H
tRef
4
4
4
4
5
25H 45H 65H
tArea
7
7
7
7
9
26H 46H 66H
tMemArea
5
7
7
7
7
27H 47H 67H
tMemErr
5
7
7
7
7
28H 48H 68H
tMemNoMem
5
7
7
7
7
29H 49H 69H
tMemFunc
2
3
3
3
3
2AH 4AH 6AH
tRefErr
4
4
4
4
5
2BH 4BH 6BH
tAreaErr
7
7
7
7
9
2CH 4CH 6CH
tRefN
4
4
4
4
5
2DH 4DH 6DH
tAreaN
7
7
7
7
9
2EH 4EH 6EH
tMemAreaN
2
3
3
3
3
2FH 4FH 6FH
tMemNoMemN
2
3
3
3
3
30H 50H 70H
Not used
â
â
â
â
â
31H 51H 71H
Not used
â
â
â
â
â
32H 52H 72H
Not used
â
â
â
â
â
33H 53H 73H
Not used
â
â
â
â
â
34H 54H 74H
Not used
â
â
â
â
â
35H 55H 75H
Not used
â
â
â
â
â
36H 56H 76H
Not used
â
â
â
â
â
37H 57H 77H
Not used
â
â
â
â
â
38H 58H 78H
tFuncCE
3
3
â
â
â
39H 59H 79H
tNameX
â
â
â
25
7
3AH 5AH 7AH
tRef3d
â
â
â
18
7
3BH 5BH 7BH
tArea3d
â
â
â
21
11
3CH 5CH 7CH
tRefErr3d
â
â
â
18
7
3DH 5DH 7DH
tAreaErr3d
â
â
â
21
11
3EH 5EH 7EH
Not used
â
â
â
â
â
3FH 5FH 7FH
Not used
â
â
â
â
â
43
3 Formulas
3.5 Unary Operator Tokens
Unary operators perform an operation with the topmost operand from stack. The tokens do not contain any additional
data.
3.5.1 tUplus (12H)
Unary plus operator. This operator has no effect on the operand. Operand class: value.
Token tUplus, BIFF2-BIFF8:
Offset
Size
Contents
0
1
12H
Example: +A1 returns the value of cell A1.
3.5.2 tUminus (13H)
Unary minus operator. Negates the operand. Operand class: value.
Token tUminus, BIFF2-BIFF8:
Offset
Size
Contents
0
1
13H
Example: -A1 returns the negated value of cell A1.
3.5.3 tPercent (14H)
Percent sign. Divides the operand by 100. Operand class: value.
Token tPercent, BIFF2-BIFF8:
Offset
Size
Contents
0
1
14H
Example: 1% returns 0.01.
44
3.6 Binary Operator Tokens
3.6 Binary Operator Tokens
Binary operators perform an operation with the two topmost operands from stack. The tokens do not contain any
additional data.
3.6.1 tAdd (03H)
Addition operator. Adds the operands. Operand class: value.
Token tAdd, BIFF2-BIFF8:
Offset
Size
Contents
0
1
03H
Example: 3+2 returns 5.
3.6.2 tSub (04H)
Subtraction operator. Subtracts the top operand from the second-to-top operand. Operand class: value.
Token tSub, BIFF2-BIFF8:
Offset
Size
Contents
0
1
04H
Example: 3-2 returns 1.
3.6.3 tMul (05H)
Multiplication operator. Multiplicates the operands. Operand class: value.
Token tMul, BIFF2-BIFF8:
Offset
Size
Contents
0
1
05H
Example: 3*2 returns 6.
3.6.4 tDiv (06H)
Division operator. Divides the second-to-top operand by the top operand. Operand class: value.
Token tDiv, BIFF2-BIFF8:
Offset
Size
Contents
0
1
06H
Example: 3/2 returns 1.5.
45
3 Formulas
3.6.5 tPower (07H)
Exponentiation operator. Raises the second-to-top operand to the power of the top operand. Operand class: value.
Token tPower, BIFF2-BIFF8:
Offset
Size
Contents
0
1
07H
Example: 3^2 returns 9.
3.6.6 tConcat (08H)
Concatenation operator. Appends the top operand to the second-to-top operand. Operand class: value.
Token tConcat, BIFF2-BIFF8:
Offset
Size
Contents
0
1
08H
Example: "ABC"&"DEF" returns "ABCDEFâ.
3.6.7 tLT (09H)
Less than operator. Returns TRUE if the second-to-top operand is less than the top operand. Operand class: value.
Token tLT, BIFF2-BIFF8:
Offset
Size
Contents
0
1
09H
Example: 3<2 returns FALSE.
3.6.8 tLE (0AH)
Less than or equal operator. Returns TRUE if the second-to-top operand is less than or equal to the top operand.
Operand class: value..
Token tLE, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0AH
Example: 3<=2 returns FALSE.
46
3.6 Binary Operator Tokens
3.6.9 tEQ (0BH)
Equality operator. Returns TRUE if the operands are equal. Operand class: value.
Token tEQ, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0BH
Example: 3=2 returns FALSE.
3.6.10 tGE (0CH)
Greater than or equal operator. Returns TRUE if the second-to-top operand is greater than or equal to the top operand.
Operand class: value..
Token tGE, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0CH
Example: 3>=2 returns TRUE.
3.6.11 tGT (0DH)
Greater than operator. Returns TRUE if the second-to-top operand is greater than the top operand. Operand class: value.
Token tGT, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0DH
Example: 3>2 returns TRUE.
3.6.12 tNE (0EH)
Inequality operator. Returns TRUE if the operands are not equal. Operand class: value.
Token tNE, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0EH
Example: 3<>2 returns TRUE.
47
3 Formulas
3.6.13 tIsect (0FH)
Intersection operator, represented by the space sign. Returns the intersected range of two ranges. If the resulting cell
range is empty, the formula will return the error code â#NULL!â (for instance A1:A2 B3). This token is not allowed
in conditions of conditional formattings and in data validity. If this token is used in cell formulas, it prevents the
creation of shared formulas. Operand class: reference.
Token tIsect, BIFF2-BIFF8:
Offset
Size
Contents
0
1
0FH
Example: A1:B3 B2:C3 returns B2:B3.
3.6.14 tList (10H)
Range list operator, represented by the system's list separator sign (for example comma sign). Treats two ranges as one
operator. This might be useful for function parameters. Note: This is not a union operator. This token is not allowed in
conditions of conditional formattings and in data validity. If this token is used in cell formulas, it prevents the creation
of shared formulas. Operand class: reference.
Token tList, BIFF2-BIFF8:
Offset
Size
Contents
0
1
10H
Example: (A1:A2,A2:A3) will be handled as one operand. Cell A2 will be handled twice, therefore this is a
range list operator, no union operator.
3.6.15 tRange (11H)
Range operator, represented by the colon sign. Returns the minimal rectangular range that contains both parameters. This
token occurs for instance by using defined names. This token is not allowed in conditions of conditional formattings and
in data validity. If this token is used in cell formulas, it prevents the creation of shared formulas. Operand class:
reference.
Token tRange, BIFF2-BIFF8:
Offset
Size
Contents
0
1
11H
Example: namedcell:D5 returns A1:D5, if the defined name namedcell contains A1:B2.
48
3.7 Function Operator Tokens
3.7 Function Operator Tokens
The reference class of function operator tokens depend on the function itself and on the position of the function inside
of the formula (for instance the expected class for the current parameter of an enclosing function).
3.7.1 tFunc (21H, 41H, 61H)
This token contains the index to a built-in function with fixed number of arguments. The operand class is dependent on
the return type of the function.
Token tFunc, BIFF2-BIFF3:
Offset
Size
Contents
0
1
21H (tFuncR), 41H (tFuncV), 61H (tFuncA)
1
1
Index to a built-in sheet function (â3.11)
Token tFunc, BIFF4-BIFF8:
Offset
Size
Contents
0
1
21H (tFuncR), 41H (tFuncV), 61H (tFuncA)
1
2
Index to a built-in sheet function (â3.11)
3.7.2 tFuncVar (22H, 42H, 62H)
This token contains the index to a built-in function or a macro command with variable number of arguments. The
operand class is dependent on the return type of the function.
Token tFuncVar, BIFF2-BIFF3:
Offset
Size
Contents
0
1
22H (tFuncVarR), 42H (tFuncVarV), 62H (tFuncVarA)
1
1
Number of arguments
2
1
Index to a built-in sheet function (â3.11)
Token tFuncVar, BIFF4-BIFF8:
Offset
Size
Contents
0
1
22H (tFuncVarR), 42H (tFuncVarV), 62H (tFuncVarA)
1
1
Number of arguments
Bit
Mask
Contents
6-0
7FH
Number of arguments
7
80H
1 = User prompt for macro commands (shown by a question mark
following the command name)
2
2
Index to a sheet function
Bit
Mask
Contents
14-0
7FFFH
Index to a built-in sheet function (â3.11) or a macro command
15
8000H
0 = Built-in function; 1 = Macro command
49
3 Formulas
3.7.3 tFuncCE (38H, 58H, 78H)
This token contains the index to a macro sheet command. From BIFF4 on, macro commands are represented by
tFuncVar tokens (â3.7.2). Operand class: reference.
Token tFuncCE, BIFF2-BIFF3:
Offset
Size
Contents
0
1
38H (tFuncCER), 58H (tFuncCEV), 78H (tFuncCEA)
1
1
Number of arguments
2
1
Index to a macro sheet command
50
3.8 Constant Operand Tokens
3.8 Constant Operand Tokens
3.8.1 tMissArg (16H)
A missing argument in a function argument list is stored as a tMissArg token. Operand class: value.
Token tMissArg, BIFF2-BIFF8:
Offset
Size
Contents
0
1
16H
Example: SUM(1,,3) â Second argument is missing and represented by a tMissArg token.
3.8.2 tStr (17H)
This token contains a string constant. The maximum length of the string is 253 characters in BIFF2 (due to the limitation
of 255 bytes per formula) and 255 characters in BIFF3-BIFF8. Operand class: value.
Token tStr, BIFF2-BIFF5:
Offset
Size
Contents
0
1
17H
1
var.
Byte string, 8-bit string length (â2.5.2)
Token tStr, BIFF8:
Offset
Size
Contents
0
1
17H
1
var.
Unicode string, 8-bit string length, option flags occur always (â2.5.3)
Example: LEN("ABC") â The string constant "ABC" is represented by a tStr token.
3.8.3 tErr (1CH)
This token contains an error code. Operand class: value.
Token tErr, BIFF2-BIFF8:
Offset
Size
Contents
0
1
1CH
1
1
Error code (â2.5.6)
Example: ERROR.TYPE(#N/A) â The constant error code #N/A is represented by a tErr token.
51
3 Formulas
3.8.4 tBool (1DH)
This token contains a Boolean value (TRUE or FALSE). Operand class: value.
Token tBool, BIFF2-BIFF8:
Offset
Size
Contents
0
1
1DH
1
1
0 = FALSE, 1 = TRUE
Example: IF(A1<0,FALSE,TRUE) â The constants FALSE and TRUE are represented by tBool tokens.
3.8.5 tInt (1EH)
This token contains an unsigned 16-bit integer value in the range from 0 to 65535. Operand class: value.
Token tInt, BIFF2-BIFF8:
Offset
Size
Contents
0
1
1EH
1
2
Unsigned integer value
Example: 3+2.2222 â The constant 3 is represented by a tInt token.
3.8.6 tNum (1FH)
This token contains a floating-point number. Operand class: value.
Token tNum, BIFF2-BIFF8:
Offset
Size
Contents
0
1
1FH
1
8
IEEE 754 floating-point value (64-bit double precision)7
Example: 3+2.2222 â The constant 2.2222 is represented by a tNum token.
7
For details about the internal structure of floating-point values see http://en.wikipedia.org/wiki/IEEE_floating-point_standard.
52
3.8 Constant Operand Tokens
3.8.7 tArray (20H, 40H, 60H)
This token contains an array constant. For instance the 2x1 matrix {1;2} is an array constant. The values of the array
constant do not follow the token identifier but are stored behind the complete token array (â3.1.6) in a constant value
array(â2.5.8). This token is not allowed in conditions of conditional formattings and in data validity. If this token is
used in cell formulas, it prevents the creation of shared formulas. Operand class: array.
Token tArray, BIFF2:
Offset
Size
Contents
0
1
20H (tArrayR), 40H (tArrayV), 60H (tArrayA)
1
6
Not used
Token tArray, BIFF3-BIFF8:
Offset
Size
Contents
0
1
20H (tArrayR), 40H (tArrayV), 60H (tArrayA)
1
7
Not used
Example: MDETERM({1,2;3,4}) â The constant {1,2;3,4} is represented by a tArrayA token.
53
3 Formulas
3.9 Operand Tokens
3.9.1 tName (23H, 43H, 63H)
This token contains the one-based index to a DEFINEDNAME record (â5.33). In BIFF2-BIFF4 this could be the index
to an EXTERNALNAME record (â5.39) too. From BIFF5 on an external name or an internal name with explicit sheet
name (for example âSheet1!localnameâ) is represented by the token tNameX (â3.9.14). If this token is used in cell
formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tName, BIFF2:
Offset
Size
Contents
0
1
23H (tNameR), 43H (tNameV), 63H (tNameA)
1
2
One-based index to DEFINEDNAME (â5.33) or EXTERNALNAME record (â5.39)
3
5
Not used
Token tName, BIFF3-BIFF4:
Offset
Size
Contents
0
1
23H (tNameR), 43H (tNameV), 63H (tNameA)
1
2
One-based index to DEFINEDNAME (â5.33) or EXTERNALNAME record (â5.39)
3
8
Not used
Token tName, BIFF5:
Offset
Size
Contents
0
1
23H (tNameR), 43H (tNameV), 63H (tNameA)
1
2
One-based index to DEFINEDNAME record (â5.33) in the Global Link Table (â4.10.2)
3
12
Not used
Token tName, BIFF8:
Offset
Size
Contents
0
1
23H (tNameR), 43H (tNameV), 63H (tNameA)
1
2
One-based index to DEFINEDNAME record (â5.33) in the Link Table (â4.10.3)
3
2
Not used
3.9.2 tRef (24H, 44H, 64H)
This token contains the reference to a cell in the same sheet. Operand class: reference.
Token tRef, BIFF2-BIFF5:
Offset
Size
Contents
0
1
24H (tRefR), 44H (tRefV), 64H (tRefA)
1
3
Encoded cell address (â3.3.3)
Token tRef, BIFF8:
Offset
Size
Contents
0
1
24H (tRefR), 44H (tRefV), 64H (tRefA)
1
4
Encoded cell address (â3.3.4)
54
3.9 Operand Tokens
3.9.3 tArea (25H, 45H, 65H)
This token contains the reference to a cell range in the same sheet. Operand class: reference.
Token tArea, BIFF2-BIFF5:
Offset
Size
Contents
0
1
25H (tAreaR), 45H (tAreaV), 65H (tAreaA)
1
6
Encoded cell range address (â3.3.3)
Token tArea, BIFF8:
Offset
Size
Contents
0
1
25H (tAreaR), 45H (tAreaV), 65H (tAreaA)
1
8
Encoded cell range address (â3.3.4)
3.9.4 tMemArea (26H, 46H, 66H)
This token encapsulates a reference subexpression (â3.2.5) that results in a constant cell address, cell range address, or
cell range list on the same sheet. The token provides the result of the reference subexpression in a cell range address list
(â2.5.15). This list does not follow the token identifier, but is stored behind the complete token array (â3.1.6).
The tMemArea token is not allowed in conditions of conditional formattings and in data validity. If this token is used in
cell formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tMemArea, BIFF2:
Offset
Size
Contents
0
1
26H (tMemAreaR), 46H (tMemAreaV), 66H (tMemAreaA)
1
3
Not used
4
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemArea, BIFF3-BIFF8:
Offset
Size
Contents
0
1
26H (tMemAreaR), 46H (tMemAreaV), 66H (tMemAreaA)
1
4
Not used
5
2
Size of the following reference subexpression (all reference operators with their operands)
Examples for constant reference subexpressions represented by a tMemArea token:
Reference subexpression
Resulting cell range address list
A1:B2 B2:C3
B2
A1:B2:B2:C3
A1:C3
(A1:B2,B2:C3)
A1:B2, B2:C3
(A1:B2,B2:C3) B1:B3
B1:B2, B2:B3
55
3 Formulas
3.9.5 tMemErr (27H, 47H, 67H)
This token encapsulates a reference subexpression (â3.2.5) that results in an erroneous cell range list on the same sheet.
This token is not allowed in conditions of conditional formattings and in data validity. If this token is used in cell
formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tMemErr, BIFF2:
Offset
Size
Contents
0
1
27H (tMemErrR), 47H (tMemErrV), 67H (tMemErrA)
1
3
Not used
4
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemArea, BIFF3-BIFF8:
Offset
Size
Contents
0
1
27H (tMemErrR), 47H (tMemErrV), 67H (tMemErrA)
1
4
Not used
5
2
Size of the following reference subexpression (all reference operators with their operands)
Examples for erroneous reference subexpressions represented by a tMemErr token:
Reference subexpression
Reson for the error
A1:B2 C3:D4
Intersection results in an empty cell range list (#NULL! error)
(A1:B2,#REF!)
One of the references is invalid (for example after deleting a row)
3.9.6 tMemNoMem (28H, 48H, 68H)
Whenever a tMemArea token (â3.9.4) should be created (containing the result cell range list of a reference subex-
pression, â3.2.5), but their was not enough memory to calculate that resulting cell range list, a tMemNoMem token is
used instead. Its contents are equal to the tMemArea token but it does not append a cell range list to the token array.
This token is not allowed in conditions of conditional formattings and in data validity. If this token is used in cell
formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tMemNoMem, BIFF2:
Offset
Size
Contents
0
1
28H (tMemNoMemR), 48H (tMemNoMemV), 68H (tMemNoMemA)
1
3
Not used
4
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemNoMem, BIFF3-BIFF8:
Offset
Size
Contents
0
1
28H (tMemNoMemR), 48H (tMemNoMemV), 68H (tMemNoMemA)
1
4
Not used
5
2
Size of the following reference subexpression (all reference operators with their operands)
56
3.9 Operand Tokens
3.9.7 tMemFunc (29H, 49H, 69H)
This token encapsulates a reference subexpression (â3.2.5) that results in a non-constant cell address, cell range
address, or cell range list. Whenever one operand of the reference subexpression is a function, a defined name, a 3D
reference, or an external reference (and no error occurs), a tMemFunc token is used.
This token is not allowed in conditions of conditional formattings and in data validity. If this token is used in cell
formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tMemFunc, BIFF2:
Offset
Size
Contents
0
1
29H (tMemFuncR), 49H (tMemFuncV), 69H (tMemFuncA)
1
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemFunc, BIFF3-BIFF8:
Offset
Size
Contents
0
1
29H (tMemFuncR), 49H (tMemFuncV), 69H (tMemFuncA)
1
2
Size of the following reference subexpression (all reference operators with their operands)
Examples for non-constant reference subexpressions represented by a tMemFunc token:
Reference subexpression
Description
A1:B2 myname
Defined name used
A1:INDEX(A2;1;1)
Function used
(A1:B2,Sheet2!C3)
3D reference used
(A1:B2,extfile.xls!C3)
External reference used
3.9.8 tRefErr (2AH, 4AH, 6AH)
This token contains the last reference to a deleted cell in the same sheet. Operand class: reference.
Token tRefErr, BIFF2-BIFF5:
Offset
Size
Contents
0
1
2AH (tRefErrR), 4AH (tRefErrV), 6AH (tRefErrA)
1
3
Not used
Token tRefErr, BIFF8:
Offset
Size
Contents
0
1
2AH (tRefErrR), 4AH (tRefErrV), 6AH (tRefErrA)
1
4
Not used
57
3 Formulas
3.9.9 tAreaErr (2BH, 4BH, 6BH)
This token contains the last reference to a deleted cell range in the same sheet. Operand class: reference.
Token tAreaErr, BIFF2-BIFF5:
Offset
Size
Contents
0
1
2BH (tAreaErrR), 4BH (tAreaErrV), 6BH (tAreaErrA)
1
6
Not used
Token tAreaErr, BIFF8:
Offset
Size
Contents
0
1
2BH (tAreaErrR), 4BH (tAreaErrV), 6BH (tAreaErrA)
1
8
Not used
3.9.10 tRefN (2CH, 4CH, 6CH)
This token contains the relative reference to a cell in the same sheet. It stores relative components as signed offsets and
is used in defined names (BIFF2-BIFF4), shared formulas, conditional formatting, and data validity. If all components of
the cell address are absolute, a tRef token (â3.9.2) is used instead. For more details see â3.3.1 and â3.3.2. Operand
class: reference.
Token tRefN, BIFF2-BIFF5:
Offset
Size
Contents
0
1
2CH (tRefNR), 4CH (tRefNV), 6CH (tRefNA)
1
3
Encoded cell address (â3.3.3)
Token tRefN, BIFF8:
Offset
Size
Contents
0
1
2CH (tRefNR), 4CH (tRefNV), 6CH (tRefNA)
1
4
Encoded cell address (â3.3.4)
3.9.11 tAreaN (2DH, 4DH, 6DH)
This token contains the relative reference to a cell range in the same sheet. It stores relative components as signed offsets
and is used in defined names (BIFF2-BIFF4), shared formulas, conditional formatting, and data validity. If all compo-
nents of the cell range address are absolute, a tArea token (â3.9.3) is used instead. For more details see â3.3.1 and
â3.3.2. Operand class: reference.
Token tAreaN, BIFF2-BIFF5:
Offset
Size
Contents
0
1
2DH (tAreaNR), 4DH (tAreaNV), 6DH (tAreaNA)
1
6
Encoded cell range address (â3.3.3)
Token tAreaN, BIFF8:
Offset
Size
Contents
0
1
2DH (tAreaNR), 4DH (tAreaNV), 6DH (tAreaNA)
1
8
Encoded cell range address (â3.3.4)
58
3.9 Operand Tokens
3.9.12 tMemAreaN (2EH, 4EH, 6EH)
This token is closely related to the tMemArea token (â3.9.4). It is used in defined names in BIFF2-BIFF4, and encapsu-
lates a reference subexpression (â3.2.5) that results in a constant cell address, cell range address, or cell range list on the
same sheet. It does not append a cell range address list to the token array. The token is not used anymore in
BIFF5-BIFF8, but import filters should be prepared for its existence. Operand class: reference.
Token tMemAreaN, BIFF2:
Offset
Size
Contents
0
1
2EH (tMemAreaNR), 4EH (tMemAreaNV), 6EH (tMemAreaNA)
1
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemAreaN, BIFF3-BIFF8:
Offset
Size
Contents
0
1
2EH (tMemAreaNR), 4EH (tMemAreaNV), 6EH (tMemAreaNA)
1
2
Size of the following reference subexpression (all reference operators with their operands)
3.9.13 tMemNoMemN (2FH, 4FH, 6FH)
This token is closely related to the tMemAreaN token (â3.9.12). It is used in reference subexpressions (â3.2.5) in
defined names in BIFF2-BIFF4. Whenever a tMemAreaN token should be created, but their was not enough memory for
any reason, a tMemNoMemN token is used instead. Its contents are equal to the tMemAreaN token. The token is not
used anymore in BIFF5-BIFF8, but import filters should be prepared for its existence. Operand class: reference.
Token tMemNoMemN, BIFF2:
Offset
Size
Contents
0
1
2FH (tMemNoMemNR), 4FH (tMemNoMemNV), 6FH (tMemNoMemNA)
1
1
Size of the following reference subexpression (all reference operators with their operands)
Token tMemNoMemN, BIFF3-BIFF8:
Offset
Size
Contents
0
1
2FH (tMemNoMemNR), 4FH (tMemNoMemNV), 6FH (tMemNoMemNA)
1
2
Size of the following reference subexpression (all reference operators with their operands)
59
3 Formulas
3.9.14 tNameX (39H, 59H, 79H) (BIFF5-BIFF8)
This token contains the index to a DEFINEDNAME or EXTERNALNAME record. It occurs by using external names or
internal names with explicit sheet name (for example âSheet1!localnameâ), add-in functions, DDE links, and OLE links.
In BIFF5 the contents of this token differs for internal respectively external names. This token is not allowed in condi-
tions of conditional formattings and in data validity. If this token is used in cell formulas, it prevents the creation of
shared formulas. Operand class: reference.
Token tNameX for internal names, BIFF5:
Offset
Size
Contents
0
1
39H (tNameXR), 59H (tNameXV), 79H (tNameXA)
1
2
This is always a negative value to indicate an internal name. The absolute value is the one-
based index to EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
8
Not used
11
2
One-based index to DEFINEDNAME record (â5.33) in the Global Link Table (â4.10.2)
13
12
Not used
Token tNameX for external names, BIFF5:
Offset
Size
Contents
0
1
39H (tNameXR), 59H (tNameXV), 79H (tNameXA)
1
2
This is always a positive value to indicate an external name. One-based index to
EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
8
Not used
11
2
One-based index to EXTERNALNAME record (â5.39)
13
12
Not used
Token tNameX, BIFF8:
Offset
Size
Contents
0
1
39H (tNameXR), 59H (tNameXV), 79H (tNameXA)
1
2
Index to REF entry in EXTERNSHEET record (â5.41) in the Link Table (â4.10.3)
3
2
One-based index to DEFINEDNAME (â5.33) or EXTERNALNAME record (â5.39)
5
2
Not used
60
3.9 Operand Tokens
3.9.15 tRef3d (3AH, 5AH, 7AH) (BIFF5-BIFF8)
This token contains a 3D reference or an external reference to a cell. In BIFF5 the contents of this token differs for 3D
respectively external references. This token is not allowed in conditions of conditional formattings and in data validity.
If this token is used in cell formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tRef3d for 3D references, BIFF5:
Offset
Size
Contents
0
1
3AH (tRef3dR), 5AH (tRef3dV), 7AH (tRef3dA)
1
2
This is always a negative value to indicate a 3D reference. The absolute value is the one-
based index to EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2)
containing the name of the first referenced sheet.
3
8
Not used
11
2
Zero-based index to first referenced sheet (FFFFH = deleted sheet)
13
2
Zero-based index to last referenced sheet (FFFFH = deleted sheet)
15
3
Encoded cell address (â3.3.3)
Token tRef3d for external references, BIFF5:
Offset
Size
Contents
0
1
3AH (tRef3dR), 5AH (tRef3dV), 7AH (tRef3dA)
1
2
This is always a positive value to indicate an external reference. One-based index to
EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
12
Not used
15
3
Encoded cell address (â3.3.3)
Token tRef3d, BIFF8:
Offset
Size
Contents
0
1
3AH (tRef3dR), 5AH (tRef3dV), 7AH (tRef3dA)
1
2
Index to REF entry in EXTERNSHEET record (â5.41) in the Link Table (â4.10.3)
3
4
Encoded cell address (â3.3.4)
61
3 Formulas
3.9.16 tArea3d (3BH, 5BH, 7BH) (BIFF5-BIFF8)
This token contains a 3D reference or an external reference to a cell range. In BIFF5 the contents of this token differs for
3D respectively external references. This token is not allowed in conditions of conditional formattings and in data
validity. If this token is used in cell formulas, it prevents the creation of shared formulas. Operand class: reference.
Token tArea3d for 3D references, BIFF5:
Offset
Size
Contents
0
1
3BH (tArea3dR), 5BH (tArea3dV), 7BH (tArea3dA)
1
2
This is always a negative value to indicate a 3D reference. The absolute value is the one-
based index to EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2)
containing the name of the first referenced sheet.
3
8
Not used
11
2
Zero-based index to first referenced sheet (FFFFH = deleted sheet)
13
2
Zero-based index to last referenced sheet (FFFFH = deleted sheet)
15
6
Encoded cell range address (â3.3.3)
Token tArea3d for external references, BIFF5:
Offset
Size
Contents
0
1
3BH (tArea3dR), 5BH (tArea3dV), 7BH (tArea3dA)
1
2
This is always a positive value to indicate an external reference. One-based index to
EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
12
Not used
15
6
Encoded cell range address (â3.3.3)
Token tArea3d, BIFF8:
Offset
Size
Contents
0
1
3BH (tArea3dR), 5BH (tArea3dV), 7BH (tArea3dA)
1
2
Index to REF entry in EXTERNSHEET record (â5.41) in the Link Table (â4.10.3)
3
8
Encoded cell range address (â3.3.4)
62
3.9 Operand Tokens
3.9.17 tRefErr3d (3CH, 5CH, 7CH) (BIFF5-BIFF8)
This token contains the last 3D reference or external reference to a cell in a deleted row or column. In BIFF5 the
contents of this token differs for 3D respectively external references. This token is not allowed in conditions of condi-
tional formattings and in data validity. If this token is used in cell formulas, it prevents the creation of shared formulas.
Operand class: reference.
Token tRefErr3d for 3D references, BIFF5:
Offset
Size
Contents
0
1
3CH (tRefErr3dR), 5CH (tRefErr3dV), 7CH (tRefErr3dA)
1
2
This is always a negative value to indicate a 3D reference. The absolute value is the one-
based index to EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
8
Not used
11
2
Index to first referenced sheet (FFFFH = deleted sheet)
13
2
Index to last referenced sheet (FFFFH = deleted sheet)
15
3
Not used
Token tRefErr3d for external references, BIFF5:
Offset
Size
Contents
0
1
3CH (tRefErr3dR), 5CH (tRefErr3dV), 7CH (tRefErr3dA)
1
2
This is always a positive value to indicate an external reference. One-based index to
EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
15
Not used
Token tRefErr3d, BIFF8:
Offset
Size
Contents
0
1
3CH (tRefErr3dR), 5CH (tRefErr3dV), 7CH (tRefErr3dA)
1
2
Index to REF entry in EXTERNSHEET record (â5.41) in the Link Table (â4.10.3)
3
4
Not used
63
3 Formulas
3.9.18 tAreaErr3d (3DH, 5DH, 7DH) (BIFF5-BIFF8)
This token contains the last 3D reference or external reference to a cell range in deleted columns or rows. In BIFF5 the
contents of this token differs for 3D respectively external references. This token is not allowed in conditions of condi-
tional formattings and in data validity. If this token is used in cell formulas, it prevents the creation of shared formulas.
Operand class: reference.
Token tAreaErr3d for 3D references, BIFF5:
Offset
Size
Contents
0
1
3DH (tAreaErr3dR), 5DH (tAreaErr3dV), 7DH (tAreaErr3dA)
1
2
This is always a negative value to indicate a 3D reference. The absolute value is the one-
based index to EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
8
Not used
11
2
Index to first referenced sheet (FFFFH = deleted sheet)
13
2
Index to last referenced sheet (FFFFH = deleted sheet)
15
6
Not used
Token tAreaErr3d for external references, BIFF5:
Offset
Size
Contents
0
1
3DH (tAreaErr3dR), 5DH (tAreaErr3dV), 7DH (tAreaErr3dA)
1
2
This is always a positive value to indicate an external reference. One-based index to
EXTERNSHEET record (â5.41) in the Local Link Table (â4.10.2).
3
18
Not used
Token tAreaErr3d, BIFF8:
Offset
Size
Contents
0
1
3DH (tAreaErr3dR), 5DH (tAreaErr3dV), 7DH (tAreaErr3dA)
1
2
Index to REF entry in EXTERNSHEET record (â5.41) in the Link Table (â4.10.3)
3
8
Not used
64
3.10 Control Tokens
3.10 Control Tokens
3.10.1 tExp (01H)
This token is used to mark that a formula cell is part of an array formula or shared formula (â4.8). It is always the only
token in a token array and is only allowed in the FORMULA record (â5.50). It contains the address of the base
FORMULA record for this formula range. Note that in shared formulas this address may be different to the top-left cell
of the formula range (if the top left cell is not part of the shared formula).
Token tExp, BIFF2:
Offset
Size
Contents
0
1
01H
1
2
Index to row of first FORMULA record in the formula range
3
1
Index to column of first FORMULA record in the formula range
Token tExp, BIFF3-BIFF8:
Offset
Size
Contents
0
1
01H
1
2
Index to row of first FORMULA record in the formula range
3
2
Index to column of first FORMULA record in the formula range
3.10.2 tTbl (02H)
This token is used to mark that a formula cell is part of a multiple operation table (â4.9). It is always the only token in a
token array and is only allowed in the FORMULA record (â5.50).
Token tTbl, BIFF2:
Offset
Size
Contents
0
1
02H
1
2
Index to first row of the table range
3
1
Index to first column of the table range
Token tTbl, BIFF3-BIFF8:
Offset
Size
Contents
0
1
02H
1
2
Index to first row of the table range
3
2
Index to first column of the table range
65
3 Formulas
3.10.3 tParen (15H)
Parentheses. This token is for display purposes only, it does not affect the result of the token array. If it follows an
operator, the parentheses will enclose the operator and its operand(s), which in fact is the result of the enclosed
operation.
Token tParen, BIFF2-BIFF8:
Offset
Size
Contents
0
1
15H
Examples for enclosed operands:
=3+(2) is represented by tInt(3), tInt(2), tParen, tAdd;
=(3)% is represented by tInt(3), tParen, tPercent;
=SUM(3,(2)) is represented by tInt(3), tInt(2), tParen, tFuncV(SUM).
Examples for enclosed operators:
=(3+2) is represented by tInt(3), tInt(2), tAdd, tParen;
=(3%) is represented by tInt(3), tPercent, tParen;
=(SUM(3,2)) is represented by tInt(3), tInt(2), tFuncV(SUM), tParen.
3.10.4 tNlr (18H) (BIFF8)
2do
Operand class: reference.
3.10.5 tAttr (19H)
Special attribute. This token is able to represent a variety of information, described in the following chapters.
Common structure of the tAttr token, BIFF2-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
Attribute type flags:
01H = This is a tAttrVolatile token (volatile function)
02H = This is a tAttrIf token (IF function control)
04H = This is a tAttrChoose token (CHOOSE function control)
08H = This is a tAttrSkip token (skip part of token array)
10H = This is a tAttrSum token (SUM function with one parameter)
20H = This is a tAttrAssign token (assignment-style formula in a macro sheet)
40H = This is a tAttrSpace token (spaces and carriage returns, BIFF3-BIFF8)
41H = This is a tAttrSpaceVolatile token (BIFF3-BIFF8, see below)
2
var.
Additional information dependent on the attribute type
Theoretically, the attribute type flags may be combined to represent several attributes in one tAttr token. In practise, this
is only done with the tAttrVolatile token and a leading tAttrSpace token. This âtAttrSpaceVolatileâ token contains the
attribute type 41H (flags of the tAttrVolatile token and the tAttrSpace token). The data of the token is equivalent to a
regular tAttrSpace token. This is possible, because the tAttrVolatile token does not contain additional valid data.
66
3.10 Control Tokens
⢠Volatile Formula â The tAttrVolatile Token
If the formula contains a volatile function (a function that needs to be recalculated always, for example the NOW
function, â3.11), or a defined name that directly or indirectly includes a volatile function, this token will lead the token
array (except in assignment-style formulas in macro sheets, see tAttrAssign token below).
Token tAttrVolatile, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
01H (identifier for the tAttrVolatile token)
2
1
Not used
Token tAttrVolatile, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
01H (identifier for the tAttrVolatile token)
2
2
Not used
⢠IF Function Control â The tAttrIf Token
This token always follows the first parameter of the IF function (containing the condition). It contains a relative offset
that allows to skip the true parameter of the function (second parameter), if the condition evaluates to false.
The token promises that the topmost operand on the formula stack (the last processed subexpression) is the condition of
an IF function. This operand is popped from the stack, and processing continues depending on its value.
⢠If the condition is true, the following tokens are processed, and at the end of the parameter, a tAttrSkip token (see
below) will occur that jumps right behind the tFuncVar(IF) token (this has to be assured during creation of the
formula). Thus, the false parameter is not evaluated at all, and cannot cause an error code as final formula result, if it
contains an error.
⢠If the condition is false, the following tokens are skipped (the true parameter), and evaluation continues with the false
parameter. Again, at the end of the parameter, a tAttrSkip token will occur that jumps behind the tFuncVar(IF) token.
If the false parameter does not exist, the tAttrIf token causes to jump to the tFuncVar(IF) token, and a simple false
constant is pushed onto the formula stack.
If the IF function is processed, the result of either the true parameter or the false parameter will be on top of the formula
stack.
Token tAttrIf, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
02H (identifier for the tAttrIf token)
2
1
Distance (number of bytes) from start of next token (first token of second parameter) to
start of first token of the false parameter (if extant); otherwise to start of the respective
tFuncVar(IF) token. See example below for more details.
Token tAttrIf, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
02H (identifier for the tAttrIf token)
2
2
Distance (number of bytes) from start of next token (first token of second parameter) to
start of first token of the false parameter (if extant, including all leading tAttrSpace
tokens); otherwise to start of the respective tFuncVar(IF) token (skipping all leading
tAttrSpace tokens related to the tFuncVar token). See example below for more details.
67
3 Formulas
Example of the formula = IF(TRUE, 1, 2). The formula contains spaces before the function identifier and
before the second and third parameter.
Offset
Size
Token name
Description
0
2
tBool
The condition of the IF function: the constant true
2
4
tAttrIf
Distance to start of false parameter: 7+4 = 11 bytes
6
4
tAttrSpace
Leading spaces for the next token (the true parameter)
10
3
tInt
True parameter of the IF function: the integer constant 1
13
4
tAttrSkip
Distance to position behind tFuncVar(IF) token (minus 1):
7+12â1 = 18 bytes
17
4
tAttrSpace
Leading spaces for the next token (the false parameter)
21
3
tInt
False parameter of the IF function: the integer constant 2
24
4
tAttrSpace
Leading spaces for the next token (the function identifier).
Note that the tAttrSpace tokens related to the function itself
are located before the tAttrSkip token!
28
4
tAttrSkip
Distance to position behind tFuncVar(IF) token (minus 1):
4â1 = 3 bytes.
32
4
tFuncVar(IF)
Identifier of the IF function, function with 3 parameters
Example of the formula = IF(TRUE, 1). The formula contains spaces before the function identifier and the
second parameter.
Offset
Size
Token name
Description
0
2
tBool
The condition of the IF function: the constant true
2
4
tAttrIf
Distance to start of tFuncVar(IF) token: 7+8 = 15 bytes
6
4
tAttrSpace
Leading spaces for the next token (the true parameter)
10
3
tInt
True parameter of the IF function: the integer constant 1
13
4
tAttrSpace
Leading spaces for the next token (the function identifier).
Note that the tAttrSpace tokens related to the function itself
are located before the tAttrSkip token!
17
4
tAttrSkip
Distance to position behind tFuncVar(IF) token (minus 1):
4â1 = 3 bytes
21
4
tFuncVar(IF)
Identifier of the IF function with 3 parameters
68
3.10 Control Tokens
⢠CHOOSE Function Control â The tAttrChoose Token
This token always follows the first parameter of the CHOOSE function (containing the value which parameter to
choose). It contains a relative offset that allows to skip all unused choices and to jump directly to the correct parameter.
The token promises that the topmost operand on the formula stack (the last processed subexpression) is the first
parameter of a CHOOSE function. This operand is popped from the stack, and processing continues at the specified
position in the token array. At the end of the parameter, a tAttrSkip token (see below) will occur that jumps right behind
the tFuncVar(CHOOSE) token (this has to be assured during creation of the formula). Thus, only one more parameter of
the function is evaluated at all, all other parameters cannot cause an error code as final formula result, if they contain an
error. If the choice from the first parameter is wrong, the tAttrChoose token causes to jump to the tFuncVar(CHOOSE)
token, and an error is generated.
Token tAttrChoose, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
04H (identifier for the tAttrChoose token)
2
1
Number of choices in the CHOOSE function (nc, number of parameters decreased by 1)
3
nc
Jump table containing nc distances (8-bit values specifying numbers of bytes) from start
of this jump table to start of first token of the respective parameter of the CHOOSE
function.
3+nc
1
Distance (numbers of bytes) from start of the jump table of this token to start of the
tFuncVar(CHOOSE) token. Used in case of an error (wrong choice in first parameter).
Token tAttrChoose, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
04H (identifier for the tAttrChoose token)
2
2
Number of choices in the CHOOSE function (nc, number of parameters decreased by 1)
4
2ânc
Jump table containing nc distances (16-bit values specifying numbers of bytes) from start
of this jump table to start of first token of the respective parameter of the CHOOSE
function.
4+2ânc
2
Distance (numbers of bytes) from start of the jump table of this token to start of the
tFuncVar(CHOOSE) token (skipping all leading tAttrSpace tokens related to the tFuncVar
token). Used in case of an error (wrong choice in first parameter).
69
3 Formulas
Example of the formula = CHOOSE(2, 1,2, 3). The formula contains spaces before the function
identifier and before the second and fourth parameter.
Offset
Size
Token name
Description
0
2
tInt
The choice: the integer constant 2 (take second choice)
2
12
tAttrChoose
Function contains 3 choices (nc = 3)
Jump table: distances to start positions of the next nc = 3
parameters (including the size of this jump table:
ncâ2+2 = 3â2+2 = 8 bytes):
- First choice: 8 bytes (skip the jump table only)
- Second choice: 8+7+4 = 19 bytes
- Third choice: 8+7+7+4 = 26 bytes
Distance to start of tFuncVar(CHOOSE) token (including
jump table size, leading tAttrSpace tokens will be skipped
too): 8+7+7+11+8 = 41 bytes
14
4
tAttrSpace
Leading spaces for the next token
18
3
tInt
First choice parameter: the constant 1
21
4
tAttrSkip
Distance to position behind tFuncVar(CHOOSE) token
(minus 1): 11+11+8â1 = 29 bytes
25
3
tInt
Second choice parameter: the constant 2
28
4
tAttrSkip
Distance to position behind tFuncVar(CHOOSE) token
(minus 1): 11+8â1 = 18 bytes
32
4
tAttrSpace
Leading spaces for the next token
36
3
tInt
Third choice parameter: the constant 3
39
4
tAttrSpace
Leading spaces for the next token (the function identifier).
Note that the tAttrSpace tokens related to the function
itself are located before the tAttrSkip token!
43
4
tAttrSkip
Distance to position behind tFuncVar(CHOOSE) token
(minus 1): 4â1 = 3 bytes
47
4
tFuncVar(CHOOSE)
Identifier of the CHOOSE function with 4 parameters
⢠Jump to Position â The tAttrSkip Token
This token is used to let formula evaluation continue at another position in the token array. It contains the number of
bytes to skip from the current position. For no obvious reason, this value is always one less than the actual number. This
token is only used in conjunction with the tAttrIf token and tAttrChoose token (see tAttrIf and tAttrChosse tokens above
for examples).
Token tAttrSkip, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
08H (identifier for the tAttrSkip token)
2
1
Distance (number of bytes) from start of next token to destination position, decreased by 1
Token tAttrSkip, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
08H (identifier for the tAttrSkip token)
2
2
Distance (number of bytes) from start of next token to destination position, decreased by 1
70
3.10 Control Tokens
⢠Sum with One Parameter â The tAttrSum Token
This token replaces the tFuncVar(SUM) token, if the SUM function takes one parameter only. This is the only tAttr
token that behaves like a real operator.
Token tAttrSum, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
10H (identifier for the tAttrSum token)
2
1
Not used
Token tAttrSum, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
10H (identifier for the tAttrSum token)
2
2
Not used
Example: The formula =SUM(1) is represented with the token array tInt(1), tAttrSum; instead of the token array
tInt(1), tFuncVarV(SUM).
⢠Assignment in Macro Sheet â The tAttrAssign Token
In macro sheets it is possible to replace the SET.NAME function with an assignment-style formula. The usual syntax
=SET.NAME(name,value) will be replaced with the command name=value then.
Example: The macro sheet function =SET.NAME(myname,1) is represented by the token array
tNameV(myname), tInt(1), tFuncVarV(SET.NAME).
The used name is contained in a tName token.
The same can be done with the assignment-style formula myname=1. The token array of this function is
tAttrAssign, tAttrStr("myname"), tAttrInt(1), tFuncVarV(SET.NAME).
Now, the used name is given as string in a tStr token, not in a tName token anymore.
Token tAttrAssign, BIFF2:
Offset
Size
Contents
0
1
19H
1
1
20H (identifier for the tAttrAssign token)
2
1
Not used
Token tAttrAssign, BIFF3-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
20H (identifier for the tAttrAssign token)
2
2
Not used
In an assignment-style formulas the tAttrVolatile token will not be the first token in the formula, but it will follow the
tStr token containing the name used in the assignment (as usual, this can also be a tAttrSpaceVolatile token).
Example: The assignment-style formula myname=NOW() is represented by the following token array:
tAttrAssign, tStr("myname"), tAttrVolatile, tFuncV(NOW), tFuncVarV(SET.NAME).
See also the examples for the tAttrSpace token below.
71
3 Formulas
⢠Spaces and Carriage Returns â The tAttrSpace Token (BIFF3-BIFF8)
This token is a placeholder for space characters and carriage returns inserted into the formula representation. It specifies
the type and number of inserted characters preceding the next token. It does not affect the evaluation of the token array.
In BIFF3, only spaces are allowed, and they can only occur in macro sheets and only in front of the entire formula,
following the equality sign.
Several tAttrSpace tokens may occur before a token, for example mixed spaces and carriage returns. Parentheses and
function calls can contain spaces at different positions:
⢠Parentheses: before the opening parenthesis and before the closing parenthesis.
⢠Function call: before the function name and before the closing parenthesis. It is not possible to add a space between
function name and opening parenthesis, and in front of the parameter separator.
The position of the added characters is specified inside the tAttrSpace token.
Token tAttrSpace, BIFF3:
Offset
Size
Contents
0
1
19H
1
1
40H (identifier for the tAttrSpace token), or
41H (identifier for the tAttrSpaceVolatile token)
2
2
Number of spaces following the equality sign (1âŚ255)
Token tAttrSpace, BIFF4-BIFF8:
Offset
Size
Contents
0
1
19H
1
1
40H (identifier for the tAttrSpace token), or
41H (identifier for the tAttrSpaceVolatile token)
2
1
Type and position of the inserted character(s):
00H = Spaces before the next token (not allowed before tParen token)
01H = Carriage returns before the next token (not allowed before tParen token)
02H = Spaces before opening parenthesis (only allowed before tParen token)
03H = Carriage returns before opening parenthesis (only allowed before tParen token)
04H = Spaces before closing parenthesis (only allowed before tParen, tFunc, and tFuncVar
tokens)
05H = Carriage returns before closing parenthesis (only allowed before tParen, tFunc, and
tFuncVar tokens)
06H = Spaces following the equality sign (only in macro sheets)
3
1
Number of inserted spaces or carriage returns
72
3.10 Control Tokens
In the following examples, the space characters are replaced by ââŚâ characters, and a carriage return is shown as
â<cr>â. The tAttrSpace tokens are shown using the following notation: tAttrSpace(type,count).
Formula
Token array
=âŚ1
tAttrSpace(00H,1), tInt(1)
=âŚ1âŚâŚ+âŚâŚâŚ2
tAttrSpace(00H,1), tInt(1), tAttrSpace(00H,3), tInt(2), tAttrSpace(00H,2), tAdd
=1âŚ<cr>
tInt(1), tInt(2), tAttrSpace(00H,1), tAttrSpace(01H,1), tAttrSpace(00H,2), tAdd
âŚâŚ+2
=1+âŚ(2âŚâŚ)
tInt(1), tInt(2), tAttrSpace(02H,1), tAttrSpace(04H,2), tParen, tAdd
=âŚSUM(1âŚâŚ)
tInt(1), tAttrSpace(00H,1), tAttrSpace(04H,2), tAttrSum
=âŚNOW()
tAttrSpaceVolatile(00H,1), tFuncV(NOW)
Macro sheet formula
Token array
=âŚ1
tAttrSpace(06H,1), tInt(1)
=âŚNOW()
tAttrSpaceVolatile(06H,1), tFuncV(NOW)
âŚmyname=âŚâŚ1
tAttrAssign, tAttrSpace(06H,1), tStr("myname"), tAttrSpace(00H,2), tInt(1),
tFuncVarV(SET.NAME)
âŚmyname=âŚâŚNOW()
tAttrAssign, tAttrSpace(06H,1), tStr("myname"), tAttrSpaceVolatile(00H,2),
tFuncV(NOW), tFuncVarV(SET.NAME)
73
3 Formulas
3.11 Built-In Sheet Functions
Meaning of the table column headers:
Column header
Meaning
Func ID
Function identifier used in tFunc (â3.7.1) and tFuncVar (â3.7.2) tokens
Function name
English name of the function
Min par
Minimum number of parameters this function requires
Max par
Maximum number of parameters this function allows. If equal to âMin parâ, a tFunc token
is used for this function, otherwise a tFuncVar token.
Ret class
Default token class of the return value (â3.2.2).
R = reference class;
V = value class;
A = array class.
Parameter classes
Token classes expected by the respective parameters of the function (â3.2.3). The ellipse
ââŚâ repeats the last specified token class for all following parameters.
Volatile
If marked, the function result is volatile (needs to be recalculated always). Existance of
such a function causes the âRecalculate alwaysâ flag to be set in the ARRAY (â5.4),
FORMULA (â5.50), DATATABLE (â5.24), and DATATABLE2 (â5.25) records.
3.11.1 Built-In Sheet Functions in BIFF2
Func
Max Ret Parameter
Volat
Func
Min Max Ret Parameter
Volat
Function name
ID
Function name89
Min
par
par class classes
ile
ID
par
par class classes
ile
0
COUNT
0
30
V
R âŚ
27
ROUND
2
2
V
V V
1
IF
2
3
R
V R R
28
LOOKUP
2
3
V
V R R
2
ISNA
1
1
V
V
29
INDEX
2
4
R
R V V V
3
ISERROR
1
1
V
V
30
REPT
2
2
V
V V
4
SUM
0
30
V
R âŚ
31
MID
3
3
V
V V V
5
AVERAGE
1
30
V
R âŚ
32
LEN
1
1
V
V
6
MIN
1
30
V
R âŚ
33
VALUE
1
1
V
V
7
MAX
1
30
V
R âŚ
34
TRUE
0
0
V
â
8
ROW
0
1
V
R
35
FALSE
0
0
V
â
9
COLUMN
0
1
V
R
36
AND
1
30
V
R âŚ
10
NA
0
0
V
â
37
OR
1
30
V
R âŚ
11
NPV
2
30
V
V R âŚ
38
NOT
1
1
V
V
12
STDEV
1
30
V
R âŚ
39
MOD
2
2
V
V V
13
DOLLAR
1
2
V
V V
40
DCOUNT
3
3
V
R R R
14
FIXED8
2
2
V
V V
41
DSUM
3
3
V
R R R
15
SIN
1
1
V
V
42
DAVERAGE
3
3
V
R R R
16
COS
1
1
V
V
43
DMIN
3
3
V
R R R
17
TAN
1
1
V
V
44
DMAX
3
3
V
R R R
18
ATAN
1
1
V
V
45
DSTDEV
3
3
V
R R R
19
PI
0
0
V
â
46
VAR
1
30
V
R âŚ
20
SQRT
1
1
V
V
47
DVAR
3
3
V
R R R
21
EXP
1
1
V
V
48
TEXT
2
2
V
V V
22
LN
1
1
V
V
49
LINEST9
1
2
A
R R
23
LOG10
1
1
V
V
50
TREND9
1
3
A
R R R
24
ABS
1
1
V
V
51
LOGEST9
1
2
A
R R
25
INT
1
1
V
V
52
GROWTH9
1
3
A
R R R
26
SIGN
1
1
V
V
56
PV
3
5
V
V V V V V
8
Parameter count will change in BIFF4.
9
Parameter count will change in BIFF3.
74
3.11 Built-In Sheet Functions
Func
Max Ret Parameter
Volat
Func
Min Max Ret Parameter
Volat
Function name
ID
Function name1011 Min
par
par class classes
ile
ID
par
par class classes
ile
57
FV
3
5
V
V V V V V
116
RIGHT
1
2
V
V V
58
NPER
3
5
V
V V V V V
117
EXACT
2
2
V
V V
59
PMT
3
5
V
V V V V V
118
TRIM
1
1
V
V
60
RATE
3
6
V
V V V V V V
119
REPLACE
4
4
V
V V V V
61
MIRR
3
3
V
R V V
120
SUBSTITUTE
3
4
V
V V V V
62
IRR
1
2
V
R V
121
CODE
1
1
V
V
63
RAND
0
0
V
â
â
124
FIND
2
3
V
V V V
64
MATCH
2
3
V
V R R
125
CELL
1
2
V
V R
â
65
DATE
3
3
V
V V V
126
ISERR
1
1
V
V
66
TIME
3
3
V
V V V
127
ISTEXT
1
1
V
V
67
DAY
1
1
V
V
128
ISNUMBER
1
1
V
V
68
MONTH
1
1
V
V
129
ISBLANK
1
1
V
V
69
YEAR
1
1
V
V
130
T
1
1
V
R
70
WEEKDAY10
1
1
V
V
131
N
1
1
V
R
71
HOUR
1
1
V
V
140
DATEVALUE
1
1
V
V
72
MINUTE
1
1
V
V
141
TIMEVALUE
1
1
V
V
73
SECOND
1
1
V
V
142
SLN
3
3
V
V V V
74
NOW
0
0
V
â
â
143
SYD
4
4
V
V V V V
75
AREAS
1
1
V
R
144
DDB
4
5
V
V V V V V
76
ROWS
1
1
V
R
148
INDIRECT
1
2
R
V V
â
77
COLUMNS
1
1
V
R
162
CLEAN
1
1
V
V
78
OFFSET
3
5
R
R V V V V
â
163
MDETERM
1
1
V
A
82
SEARCH
2
3
V
V V V
164
MINVERSE
1
1
A
A
83
TRANSPOSE
1
1
A
A
165
MMULT
2
2
A
A A
86
TYPE
1
1
V
V
167
IPMT
4
6
V
V V V V V V
97
ATAN2
2
2
V
V V
168
PPMT
4
6
V
V V V V V V
98
ASIN
1
1
V
V
169
COUNTA
0
30
V
R âŚ
99
ACOS
1
1
V
V
183
PRODUCT
0
30
V
R âŚ
100
CHOOSE
2
30
R
V R âŚ
184
FACT
1
1
V
V
101
HLOOKUP10
3
3
V
V R R
189
DPRODUCT
3
3
V
R R R
102
VLOOKUP10
3
3
V
V R R
190
ISNONTEXT
1
1
V
V
105
ISREF
1
1
V
R
193
STDEVP
1
30
V
R âŚ
109
LOG
1
2
V
V V
194
VARP
1
30
V
R âŚ
111
CHAR
1
1
V
V
195
DSTDEVP
3
3
V
R R R
112
LOWER
1
1
V
V
196
DVARP
3
3
V
R R R
113
UPPER
1
1
V
V
197
TRUNC11
1
1
V
V
114
PROPER
1
1
V
V
198
ISLOGICAL
1
1
V
V
115
LEFT
1
2
V
V V
199
DCOUNTA
3
3
V
R R R
10 Parameter count will change in BIFF5.
11 Parameter count will change in BIFF3.
75
3 Formulas
3.11.2 New Built-In Sheet Functions in BIFF3
Func
Max Ret Parameter
Vola
Func
Max Ret Parameter
Vola
ID
Function name1213 Min
par
par class classes
tile
ID
Function name14
Min
par
par class classes
tile
49
LINEST12
1
4
A
R R V V
215
JIS14
1
1
V
V
50
TREND12
1
4
A
R R R V
219
ADDRESS
2
5
V
V V V V V
51
LOGEST12
1
4
A
R R V V
220
DAYS36010
2
2
V
V V
52
GROWTH12
1
4
A
R R R V
221
TODAY
0
0
V
â
â
197
TRUNC12
1
2
V
V V
222
VDB
5
7
V
V V V V V V V
204
YEN13
1
2
V
V V
227
MEDIAN
1
30
V
R âŚ
205
FINDB
2
3
V
V V V
228
SUMPRODUCT
1
30
V
A âŚ
206
SEARCHB
2
3
V
V V V
229
SINH
1
1
V
V
207
REPLACEB
4
4
V
V V V V
230
COSH
1
1
V
V
208
LEFTB
1
2
V
V V
231
TANH
1
1
V
V
209
RIGHTB
1
2
V
V V
232
ASINH
1
1
V
V
210
MIDB
3
3
V
V V V
233
ACOSH
1
1
V
V
211
LENB
1
1
V
V
234
ATANH
1
1
V
V
212
ROUNDUP
2
2
V
V V
235
DGET
3
3
V
R R R
213
ROUNDDOWN
2
2
V
V V
244
INFO
1
1
V
V
214
ASC
1
1
V
V
12 Function exists in BIFF2, but parameter count has been changed.
13 Function name YEN will change to USDOLLAR in BIFF4.
14 Function name JIS will change to DBCS in BIFF4.
76
3.11 Built-In Sheet Functions
3.11.3 New Built-In Sheet Functions in BIFF4
Func
Max Ret Parameter
Vola
Func
Max Ret Parameter
Vola
ID
Function name1516 Min
par
par class classes
tile
ID
Function name17
Min
par
par class classes
tile
14
FIXED15
2
3
V
V V V
298
ODD
1
1
V
V
204
USDOLLAR16
1
2
V
V V
299
PERMUT
2
2
V
V V
215
DBCS17
1
1
V
V
300
POISSON
3
3
V
V V V
216
RANK
2
3
V
V R V
301
TDIST
3
3
V
V V V
247
DB
4
5
V
V V V V V
302
WEIBULL
4
4
V
V V V V
252
FREQUENCY
2
2
A
R R
303
SUMXMY2
2
2
V
A A
261
ERROR.TYPE
1
1
V
V
304
SUMX2MY2
2
2
V
A A
269
AVEDEV
1
30
V
R âŚ
305
SUMX2PY2
2
2
V
A A
270
BETADIST
3
5
V
V V V V V
306
CHITEST
2
2
V
A A
271
GAMMALN
1
1
V
V
307
CORREL
2
2
V
A A
272
BETAINV
3
5
V
V V V V V
308
COVAR
2
2
V
A A
273
BINOMDIST
4
4
V
V V V V
309
FORECAST
3
3
V
V A A
274
CHIDIST
2
2
V
V V
310
FTEST
2
2
V
A A
275
CHIINV
2
2
V
V V
311
INTERCEPT
2
2
V
A A
276
COMBIN
2
2
V
V V
312
PEARSON
2
2
V
A A
277
CONFIDENCE
3
3
V
V V V
313
RSQ
2
2
V
A A
278
CRITBINOM
3
3
V
V V V
314
STEYX
2
2
V
A A
279
EVEN
1
1
V
V
315
SLOPE
2
2
V
A A
280
EXPONDIST
3
3
V
V V V
316
TTEST
4
4
V
A A V V
281
FDIST
3
3
V
V V V
317
PROB
3
4
V
A A V V
282
FINV
3
3
V
V V V
318
DEVSQ
1
30
V
R âŚ
283
FISHER
1
1
V
V
319
GEOMEAN
1
30
V
R âŚ
284
FISHERINV
1
1
V
V
320
HARMEAN
1
30
V
R âŚ
285
FLOOR
2
2
V
V V
321
SUMSQ
0
30
V
R âŚ
286
GAMMADIST
4
4
V
V V V V
322
KURT
1
30
V
R âŚ
287
GAMMAINV
3
3
V
V V V
323
SKEW
1
30
V
R âŚ
288
CEILING
2
2
V
V V
324
ZTEST
2
3
V
R V V
289
HYPGEOMDIST
4
4
V
V V V V
325
LARGE
2
2
V
R V
290
LOGNORMDIST
3
3
V
V V V
326
SMALL
2
2
V
R V
291
LOGINV
3
3
V
V V V
327
QUARTILE
2
2
V
R V
292
NEGBINOMDIST
3
3
V
V V V
328
PERCENTILE
2
2
V
R V
293
NORMDIST
4
4
V
V V V V
329
PERCENTRANK
2
3
V
R V V
294
NORMSDIST
1
1
V
V
330
MODE
1
30
V
A âŚ
295
NORMINV
3
3
V
V V V
331
TRIMMEAN
2
2
V
R V
296
NORMSINV
1
1
V
V
332
TINV
2
2
V
V V
297
STANDARDIZE
3
3
V
V V V
15 Function exists in BIFF2-BIFF3, but parameter count has been changed.
16 Function exists in BIFF3, but function name has been changed from YEN to USDOLLAR.
17 Function exists in BIFF3, but function name has been changed from JIS to DBCS.
77
3 Formulas
3.11.4 New Built-In Sheet Functions in BIFF5
Func
Max Ret Parameter
Vola
Func
Min Max Ret Parameter
Vola
Function name
ID
Function name1819 Min
par
par class classes
tile
ID
par
par class classes
tile
70
WEEKDAY18
1
2
V
V V
345
SUMIF
2
3
V
R V R
101
HLOOKUP18
3
4
V
V R R V
346
COUNTIF
2
2
V
R V
102
VLOOKUP18
3
4
V
V R R V
347
COUNTBLANK
1
1
V
R
220
DAYS36019
2
3
V
V V V
350
ISPMT
4
4
V
V V V V
336
CONCATENATE
0
30
V
V âŚ
351
DATEDIF
3
3
V
V V V
337
POWER
2
2
V
V V
352
DATESTRING
1
1
V
V
342
RADIANS
1
1
V
V
353
NUMBERSTRING
2
2
V
V V
343
DEGREES
1
1
V
V
354
ROMAN
1
2
V
V V
344
SUBTOTAL
2
30
V
V R âŚ
3.11.5 New Built-In Sheet Functions in BIFF8
Func
Min Max Ret Parameter
Vola
Func
Min Max Ret Parameter
Vola
Function name
Function name
ID
par
par class classes
tile
ID
par
par class classes
tile
358
GETPIVOTDATA
2
30
363
MINA
1
30
V
R âŚ
359
HYPERLINK
1
2
V
V V
364
STDEVPA
1
30
V
R âŚ
360
PHONETIC
1
1
V
R
365
VARPA
1
30
V
R âŚ
361
AVERAGEA
1
30
V
R âŚ
366
STDEVA
1
30
V
R âŚ
362
MAXA
1
30
V
R âŚ
367
VARA
1
30
V
R âŚ
18 Function exists in BIFF2-BIFF4, but parameter count has been changed.
19 Function exists in BIFF3-BIFF4, but parameter count has been changed.
78
4 Worksheet/Workbook Stream
4
Worksheet/Workbook Stream
The complex contents in an Excel document are split into several records. To keep the Worksheet/Workbook Stream
consistent, the position and order of the records is very important. This chapter contains details about the correct order
and combination of the records inside the stream. The internal structure of the records is described in chapter â5.
The following record listings show which records are required or optional, using small symbols in front of the record
name. The following table shows all possible combinations.
â
RECORD NAME
A single required record
â
RECORD NAME
A single optional record
RECORD NAME 1
â
Exactly one of the specified records
RECORD NAME 2
RECORD NAME 1
â
Exactly one of the specified records, or no record
RECORD NAME 2
ââ RECORD NAME
A required record list (record occurs 1 to n times)
ââ RECORD NAME
An optional record list (record occurs 0 to n times)
RECORD NAME 1
ââ
An unordered list of any of the specified records
RECORD NAME 2
RECORD NAME 1
An unodered list of any of the specified records, or no
ââ RECORD NAME 2
record
â
Record Group Name
A required group of records
â
Record Group Name
An optional group of records
ââ Record Group Name
A required list of record groups
ââ Record Group Name
An optional list of record groups
â
RECORD NAME 1 A required list of record groups, each group consists
ââ
â
RECORD NAME 2 only of the specified records
â
RECORD NAME 1 An optional list of record groups, each group consists
ââ
â
RECORD NAME 2 only of the specified records
Uninteresting records in this context
79
4 Worksheet/Workbook Stream
4.1 Worksheet/Workbook Stream
This chapter continues the description of the Worksheet Stream and Workbook Stream started in â2.3.3 on a more
detailed level.
4.1.1 Worksheet Stream (BIFF2-BIFF4)
The whole worksheet document (â2.1.2) consists of the Worksheet Stream (â2.3.3). All records of the worksheet are
enclosed by a leading BOF record and a trailing EOF record. The stream contains all information about the worksheet,
for instance sheet type (general sheet, chart, macro sheet), sheet dimension, view settings, a font list, a list of defined
names and external references, of course the contents and formats of all cells, row heights, column widths, etc.
Records in a Worksheet Stream (BIFF2-BIFF4):
â
BOF
Type = sheet, chart, macro sheet (â5.8)
Sheet records
â
EOF
â5.37
4.1.2 Workbook Stream (BIFF5-BIFF8)
The workbook document (â2.1.3) contains the Workbook Stream (â2.3.3), which is divided into Workbook Globals
Substream and several Sheet Substreams (â2.3.4).
Common structure of the Workbook Stream, BIFF5-BIFF8:
â
Workbook Globals Substream
ââ
Sheet Substreams
Records in the Workbook Stream, BIFF5-BIFF8:
â
BOF
Type = workbook globals (â5.8)
Global workbook records
â
EOF
â5.37
â
BOF
Type = sheet, chart, macro sheet, Basic module, ⌠(â5.8)
ââ
Sheet records
â
EOF
â5.37
80
4.2 Record Order in Streams and Substreams
4.2 Record Order in Streams and Substreams
Each of the following chapters describes the order of all records as they appear in a file written by Excel. Often it is
valid to modify this order, but in general the order described here should be used when writing Excel files. Note that
only normal sheets are described here. Special sheets like charts or macros are not subject of this chapter.
4.2.1 Record Order in a BIFF2 Worksheet Stream
â
BOF
Type = sheet (â5.8)
â
FILEPASS
â4.19 (File Protection), â5.43
â
INDEX
â4.7 (Row Blocks), â5.59
â
CODEPAGE
â5.17
â
Calculation Settings Block
â4.3
â
PRINTHEADERS
â5.81
â
PRINTGRIDLINES
â5.80
â
DEFAULTROWHEIGHT
â5.31
â
HORIZONTALPAGEBREAKS
â5.57 (separated from Page Settings Block)
â
VERTICALPAGEBREAKS
â5.108 (separated from Page Settings Block)
â
FONT
â5.45
ââ
â
FONT2
â5.46
â
FONTCOLOR
â5.47
â
Page Settings Block
â4.4
â
BACKUP
â5.5
â
Link Table
â4.10.1
â
BUILTINFMTCOUNT
â5.12
â
ââ FORMAT
â5.49
ââ DEFINEDNAME
â5.33
â
Worksheet Protection Block
â4.18
ââ XF
â5.115
â
DEFCOLWIDTH
â5.32
ââ COLWIDTH
â5.20
â
DIMENSION
â5.35
ââ COLUMNDEFAULT
â5.19
ââ Row Blocks
â4.7
ââ NOTE
â5.70
â
WINDOW1
â5.109
â
Worksheet View Settings Block
â4.5
â
EOF
â5.37
81
4 Worksheet/Workbook Stream
4.2.2 Record Order in a BIFF3 Worksheet Stream
â
BOF
Type = sheet (â5.8)
â
File Protection Block
â4.19
â
INDEX
â4.7 (Row Blocks), â5.59
â
CODEPAGE
â5.17
â
Calculation Settings Block
â4.3
â
PRINTHEADERS
â5.81
â
PRINTGRIDLINES
â5.80
â
GRIDSET
â5.52
â
HCENTER
â5.54 (separated from Page Settings Block)
â
VCENTER
â5.107 (separated from Page Settings Block)
â
GUTS
â5.53
â
DEFAULTROWHEIGHT
â5.31
â
COUNTRY
â5.22
â
HIDEOBJ
â5.56
â
SHEETPR
â5.97
â
HORIZONTALPAGEBREAKS
â5.57 (separated from Page Settings Block)
â
VERTICALPAGEBREAKS
â5.108 (separated from Page Settings Block)
ââ FONT
â5.45
â
Page Settings Block
â4.4
â
BACKUP
â5.5
â
Link Table
â4.10.1
â
BUILTINFMTCOUNT
â5.12
â
ââ FORMAT
â5.49
ââ DEFINEDNAME
â5.33
â
Workbook Protection Block
â4.18
ââ XF
â5.115
ââ STYLE
â5.103
â
PALETTE
â5.74
â
DEFCOLWIDTH
â5.32
ââ COLINFO
â5.18
â
DIMENSION
â5.35
ââ Row Blocks
â4.7
ââ NOTE
â5.70
â
WINDOW1
â5.109
â
Worksheet View Settings Block
â4.5
â
EOF
â5.37
82
4.2 Record Order in Streams and Substreams
4.2.3 Record Order in a BIFF4 Worksheet Stream
2do
4.2.4 Record Order in a BIFF5 Workbook Stream
⢠Workbook Globals Substream
â
BOF
Type = workbook globals (â5.8)
â
File Protection Block
â4.19
â
CODEPAGE
â5.17
â
TABID
â
FNGROUPCOUNT
â
Global Link Table
â4.10.2
ââ DEFINEDNAME
â5.33
â
Workbook Protection Block
â4.18
â
WINDOW1
â5.109
â
BACKUP
â5.5
â
HIDEOBJ
â5.56
â
DATEMODE
â5.28
â
PRECISION
â5.79
â
BOOKBOOL
â5.9
ââ FONT
â5.45
ââ FORMAT
â5.49
ââ XF
â5.115
ââ STYLE
â5.103
â
PALETTE
â5.74
ââ SHEET
â5.95
â
EOF
â5.37
83
4 Worksheet/Workbook Stream
⢠Sheet Substream
â
BOF
Type = sheet (â5.8)
â
INDEX
â4.7 (Row Blocks), â5.59
â
Calculation Settings Block
â4.3
â
PRINTHEADERS
â5.81
â
PRINTGRIDLINES
â5.80
â
GRIDSET
â5.52
â
GUTS
â5.53
â
DEFAULTROWHEIGHT
â5.31
â
COUNTRY
â5.22
â
SHEETPR
â5.97
â
Page Settings Block
â4.4
â
Local Link Table
â4.10.2
â
Worksheet Protection Block
â4.18
â
DEFCOLWIDTH
â5.32
ââ COLINFO
â5.18
â
SORT
â5.99
â
DIMENSION
â5.35
ââ Row Blocks
â4.7
ââ NOTE
â5.70
â
Worksheet View Settings Block
â4.5
â
GCW
â5.51
â
STANDARDWIDTH
â5.101
â
EOF
â5.37
84
4.2 Record Order in Streams and Substreams
4.2.5 Record Order in a BIFF8 Workbook Stream
⢠Workbook Globals Substream
â
BOF
Type = workbook globals (â5.8)
â
File Protection Block
â4.19
â
CODEPAGE
â5.17
â
DSF
â5.36
â
TABID
â
FNGROUPCOUNT
â
Workbook Protection Block
â4.18
â
WINDOW1
â5.109
â
BACKUP
â5.5
â
HIDEOBJ
â5.56
â
DATEMODE
â5.28
â
PRECISION
â5.79
â
REFRESHALL
â
BOOKBOOL
â5.9
ââ FONT
â5.45
ââ FORMAT
â5.49
ââ XF
â5.115
ââ STYLE
â5.103
â
PALETTE
â5.74
â
USESELFS
â5.106
ââ SHEET
â5.95
â
COUNTRY
â5.22
â
Link Table
â4.10.3
ââ DEFINEDNAME
â5.33
â
Shared String Table
â4.11
â
EOF
â5.37
85
4 Worksheet/Workbook Stream
⢠Sheet Substream
â
BOF
Type = sheet (â5.8)
â
INDEX
â4.7 (Row Blocks), â5.59
â
Calculation Settings Block
â4.3
â
PRINTHEADERS
â5.81
â
PRINTGRIDLINES
â5.80
â
GRIDSET
â5.52
â
GUTS
â5.53
â
DEFAULTROWHEIGHT
â5.31
â
SHEETPR
â5.97
â
Page Settings Block
â4.4
â
Worksheet Protection Block
â4.18
â
DEFCOLWIDTH
â5.32
ââ COLINFO
â5.18
â
SORT
â5.99
â
DIMENSION
â5.35
ââ Row Blocks
â4.7
â
Worksheet View Settings Block
â4.5
â
STANDARDWIDTH
â5.101
ââ MERGEDCELLS
â5.67
â
LABELRANGES
â5.64
â
PHONETICPR
â5.77
â
Conditional Formatting Table
â4.12
â
Hyperlink Table
â4.13
â
Data Validity Table
â4.14
â
SHEETLAYOUT
â5.96
â
SHEETPROTECTION
Additional protection, â5.98
â
RANGEPROTECTION
Additional protection, â5.84
â
EOF
â5.37
86
4.3 Calculation Settings Block
4.3 Calculation Settings Block
Definition: Calculation Settings Block
The calculation settings for a sheet are stored in several records in the Worksheet Stream (BIFF2-BIFF4) or
Sheet Substream (BIFF5-BIFF8), called the Calculation Settings Block. Note that the settings are global for the
entire workbook document in BIFF5-BIFF8, but most of the records occurs equally in every Sheet Substream.
Structure of the Calculation Settings Block:
â
UNCALCED
â5.105 (BIFF3-BIFF8 only)
â
CALCCOUNT â5.13
â
CALCMODE
â5.14
â
PRECISION
â5.79 (moved to Workbook Globals Substream in BIFF5-BIFF8)
â
REFMODE
â5.85
â
DELTA
â5.34
â
ITERATION
â5.61
â
DATEMODE
â5.28 (moved to Workbook Globals Substream in BIFF5-BIFF8)
â
SAFERECALC â5.90 (BIFF3-BIFF8 only)
4.4 Page Settings Block
Definition: Page Settings Block
The records in the Page Settings Block describe options and settings for printing. The record block is contained
in the Worksheet Stream (BIFF2-BIFF4) or in every Sheet Substream of the workbook (BIFF5-BIFF8).
Structure of the Page Settings Block:
â
HORIZONTALPAGEBREAKS
â5.57 (seperated in BIFF2-BIFF4, see below)
â
VERTICALPAGEBREAKS
â5.108 (seperated in BIFF2-BIFF4, see below)
â
HEADER
â5.55
â
FOOTER
â5.48
â
HCENTER
â5.54 (BIFF4-BIFF8 only, seperated in BIFF3)
â
VCENTER
â5.107 (BIFF4-BIFF8 only, seperated in BIFF3)
â
LEFTMARGIN
â5.66
â
RIGHTMARGIN
â5.86
â
TOPMARGIN
â5.104
â
BOTTOMMARGIN
â5.11
â
PLS
â5.78
â
PAGESETUP
â5.73 (BIFF4-BIFF8 only)
â
BITMAP
â5.6 (BIFF8 only)
In BIFF2-BIFF4, Excel does not write the HORIZONTALPAGEBREAKS and VERTICALPAGEBREAKS records
together with the other records of this block (BIFF2: â4.2.1; BIFF3: â4.2.2; BIFF4: â4.2.3). In BIFF3, additionally the
HCENTER and VCENTER records occur at another place (â4.2.2). Anyway, it is valid to write all records together
when a document is exported.
87
4 Worksheet/Workbook Stream
4.5 Sheet View Settings Block
Definition: Sheet View Settings Block
The view settings for a sheet are stored in several records in the Worksheet Stream (BIFF2-BIFF4) or Sheet
Substream (BIFF5-BIFF8), called the Sheet View Settings Block.
Structure of the Sheet View Settings Block:
â
WINDOW2
â5.110
â
SCL
â5.92 (BIFF4-BIFF8 only)
â
PANE
â5.75
ââ SELECTION
â5.93
88
4.6 Cell Formatting
4.6 Cell Formatting
All cell formatting attributes are stored in XF records (â5.115). The cell records themselves contain an index into the
XF record list. This way of storing cell formatting saves memory and decreases the file size.
4.6.1 Cell Formatting and Cell Styles
The XF record is able to store explicit cell formatting attributes or the attributes of a cell style (BIFF3-BIFF8). Explicit
formatting includes the reference to a cell style XF record. This allows to extend a defined cell style with some explicit
attributes.
The formatting attributes are divided into 6 groups:
Group
Attributes
Number format
Number format index (index to FORMAT record)
Font
Font index (index to FONT record)
Alignment
Horizontal and vertical alignment, text wrap, indentation, orientation/rotation, text direction
Border
Border line styles and colours
Background
Background area style and colours
Protection
Cell locked, formula hidden
For each group a flag in the cell XF record specifies whether to use the attributes contained in that XF record or in the
referenced style XF record. In style XF records, these flags specify whether the attributes will overwrite explicit cell
formatting when the style is applied to a cell. Changing a cell style (without applying this style to a cell) will change all
cells which already use that style and do not contain explicit cell attributes for the changed style attributes. If a cell XF
record does not contain explicit attributes in a group (if the attribute group flag is not set), it repeats the attributes of its
style XF record.
4.6.2 Default Formatting
Default formatting is applied to all cells which are not described by a cell record. In this case the default format of the
row or column may be used (if defined). If an undefined cell contains a row and a column default format, the row format
will overwrite the column format. If there are no row and column default formats available, the worksheet/workbook
default cell format will be used.
A
B
C
D
1
column
2
cel
3
row
4
5
worksheet
6
7
Default column formatting is stored in the COLUMNDEFAULT record (BIFF2, â5.19) or in the COLINFO record
(BIFF3-BIFF8, â5.18). The ROW record (â5.88) contains the default format of a specific row. The default cell format
is always present in an Excel file, described by the XF record with the fixed index 15 (0-based). By default, it uses the
worksheet/workbook default cell style, described by the very first XF record (index 0).
89
4 Worksheet/Workbook Stream
4.7 Cell Table and Row Blocks
4.7.1 Cell Table
Definition: Cell Table
The Cell Table describes all cells in a sheet, together with all row and column settings for that sheet.
Structure of the Cell Table in the Worksheet Stream (BIFF2):
â
DEFAULTROWHEIGHT â5.31
â
DEFCOLWIDTH
â5.32
ââ COLWIDTH
â5.20
â
DIMENSION
â5.35
ââ COLUMNDEFAULT
â5.19
ââ Row Block(s)
Groups of rows with cells (â4.7.2)
Structure of the Cell Table in the Worksheet Stream (BIFF3-BIFF4), and Sheet Substream (BIFF5-BIFF8):
â
DEFAULTROWHEIGHT â5.31
â
DEFCOLWIDTH
â5.32
ââ COLINFO
â5.18
â
DIMENSION
â5.35
ââ Row Block(s)
Groups of rows with cells (â4.7.2)
â
STANDARDWIDTH
â5.101 (BIFF4-BIFF8 only)
4.7.2 Row Block
Definition: Row Block
All cells in the Cell Table are divided into blocks of 32 consecutive rows, called Row Blocks. The first Row
Block starts with the first used row in that sheet. Inside each Row Block there will occur ROW records describing
the properties of the rows, and cell records with all the cell contents in this Row Block.
Example: The first used cell in the sheet is located in row 10, or row 10 is the first formatted row. The first Row
Block will contain the rows 10âŚ41, the second Row Block will contain the rows 42âŚ73, and so on.
Each Row Block contains ROW records describing the row properties (in ascending order), followed by all cell records
in this block. The cell records are stored row by row (ascending), and in each row from left to right. A used row either
contains any (filled or formatted) cells or is changed in another way (for instance height or default formatting). If a row
is not used, there will not occur a ROW record in the Row Block.
Structure of a Row Block in the Worksheet Stream (BIFF2-BIFF4) or in the Sheet Substream (BIFF5-BIFF8):
ââ ROW
Properties of the used rows (â5.88)
ââ Cell Block(s)
Cell records for all used cells (â4.7.3)
Stream offsets to the cell records of each row
â
DBCELL
(BIFF5-BIFF8 only, â5.29)
90
4.7 Cell Table and Row Blocks
4.7.3 Cell Block
Definition: Cell Block
A Cell Block is in most cases simply a single cell record. In BIFF2 it may be preceded by an IXFE record
containing the index to an XF record.
Structure of a common Cell Block in a Row Block, BIFF2-BIFF8:
â
IXFE
Index to XF (BIFF2 only, â5.62)
BLANK
â5.7
BOOLERR
â5.10
INTEGER
â5.60 (BIFF2 only)
LABEL
â5.63 (BIFF2-BIFF8)
LABELSST
â5.65 (BIFF8 only)
â
MULBLANK
â5.68 (BIFF5-BIFF8)
MULRK
â5.69 (BIFF5-BIFF8)
NUMBER
â5.71
RK
â5.87 (BIFF3-BIFF8)
RSTRING
â5.89 (BIFF5-BIFF8)
If the cell contains a formula, there may occur additional records for array formulas (â4.8), shared formulas (â4.8),
multiple operation tables (â4.9), and/or the result string.
Structure of a Formula Cell Block in a Row Block, BIFF2-BIFF8:
â
IXFE
Index to XF (BIFF2 only, â5.62)
â
FORMULA
â5.50
ARRAY
Top left cell of an array formula (â5.4)
SHAREDFMLA
Top left cell of a shared formula (BIFF5-BIFF8, â5.94)
â
DATATABLE
Top left cell of a multiple operations table (â5.24)
DATATABLE2
Top left cell of a multiple operations table (â5.25)
â
STRING
Formula cell returns a string value (â5.102)
91
4 Worksheet/Workbook Stream
4.7.4 Finding Cells in a Row Block
⢠Finding Cells in a Row Block (BIFF2-BIFF4)
In BIFF2-BIFF4, the ROW record contains a stream offset, pointing to the cell records of the respective row. The offset
value of the first ROW record in a Row Block represents the difference between the start of the second ROW record and
the first cell record. The offset of the second ROW record contains the size of all cell records of the first row, and so on.
If a row does not contain any cells, the offset to the cells in the next filled row is stored.
Example: A Row Block contains one cell per row in the rows 10, 11, and 12. Row 13 is not used, the height of
row 14 is changed (but it does not contain a cell). Row 15 contains a cell again. In this example, the first column
shows the absolute stream position of each record.
048EH
ROW
Row = 10, offset = 0050H
04A2H
ROW
Row = 11, offset = 000EH
04B6H
ROW
Row = 12, offset = 0012H
04CAH
ROW
Row = 14, offset = 000EH (no record for row 13)
04DEH
ROW
Row = 15, offset = 0000H
04F2H
RK
Address = A10
0500H
NUMBER
Address = A11
0512H
RK
Address = A12
0520H
NUMBER
Address = A15
The base position for the calculation of all cell record positions is the start of the second ROW record, 04A2H.
This is for convenience: After reading the first ROW record it is possible to calculate the position of the first cell
record, using the current stream position and the offset contained in the ROW record.
⢠The first ROW record describes row 10. The cell records of this row start in 04A2H + 0050H = 04F2H.
⢠The second ROW record describes row 11. The cell records start in 04A2H + 0050H + 000EH = 0500H.
⢠The third ROW record describes row 12. The cell records of row 12 start in
04A2H + 0050H + 000EH + 0012H = 0512H.
⢠The fourth ROW record describes row 14. It does not contain cell records. So the offset points to the cells of
the next used row (row 15).
The stream position is 04A2H + 0050H + 000EH + 0012H + 000EH = 0520H.
⢠The last ROW record record describes row 15. Because for row 14 the stream position for row 15 is calculated
already, this ROW record contains the offset 0000H. The stream position evaluates to the correct value
04A2H + 0050H + 000EH + 0012H + 000EH + 0000H = 0520H.
If the size of all cell records of a row exceeds FFFFH, the respective ROW record will contain the offset 0000H. From
this row on, the offsets cannot be used anymore to calculate stream positions.
92
4.7 Cell Table and Row Blocks
⢠Finding Cells in a Row Block (BIFF5-BIFF8)
In BIFF5-BIFF8 the DBCELL record (â5.29) follows the cell records and contains exactly the stream offsets which the
ROW records would contain in BIFF2-BIFF4. In the DBCELL record this offset list is lead by an offset to the first
ROW record in this Row Block. This offset is a positive value, although it points backwards to an earlier stream
position. While no record would occur in BIFF2-BIFF4 for empty Row Blocks, in BIFF5-BIFF8 a DBCELL record is
written for each and every Row Block.
Example: A Row Block contains one cell per row in the rows 10, 11, and 12. Row 13 is not used, the height of
row 14 is changed (but it does not contain a cell). Row 15 contains a cell again. In this example, the first column
shows the absolute stream position of each record.
07B2H
ROW
Row = 10 (Record size with header = 0014H)
07C6H
ROW
Row = 11
07DAH
ROW
Row = 12
07EEH
ROW
Row = 14 (no record for row 13)
0802H
ROW
Row = 15
0816H
RK
Address = A10
0824H
NUMBER
Address = A11
0836H
RK
Address = A12
0844H
NUMBER
Address = A15
0856H
DBCELL
Offset to first ROW record = 00A4H
Offsets = 0050H, 000EH, 0012H, 000EH, 0000H
The base position for the calculation of all cell record positions is the start of the second ROW record, 07C6H. It
is calculated from the position of the DBCELL record (contained in the INDEX record, â4.7.5), the first offset
this DBCELL record contains, and the size of the first ROW record:
0856H - 00A4H + 0014H = 07B2H + 0014H = 07C6H.
The calculation of the cell record positions works equally to the example for BIFF2-BIFF4 above (using 07C6H
as base stream position).
If the size of all cell records of a row exceeds FFFFH, the respective position in the DBCELL record will contain the
offset 0000H. From this point on, the offsets cannot be used anymore to calculate stream positions.
93
4 Worksheet/Workbook Stream
4.7.5 Finding Row Blocks in a Worksheet
Sometimes it may be useful to jump directly to a specific cell in the Worksheet Stream or Sheet Substream. The first step
is to find the Row Block which contains the cell. How to find a cell inside the Row Block is described in â4.7.4.
The INDEX record (â5.59) stores the index to the first used row and stream offsets for each Row Block in the sheet.
⢠Finding Row Blocks in BIFF2-BIFF4
In BIFF2-BIFF4 the INDEX record contains an array with the stream positions of the first ROW record of each Row
Block. This array contains also positions for empty Row Blocks. In this case the position of the next extant Row Block is
used.
Example: A worksheet contains data in the rows 2, 4, 65, and 100. The range of used rows in the INDEX record
is 2âŚ101 (last used row + 1). There are 4 Row Blocks in the sheet: 2âŚ33, 34âŚ65, 66âŚ97, and 98âŚ130. The
third Row Block is empty.
0000H
BOF
Type = worksheet
Sheet records
002EH
INDEX
Row range = 2âŚ101
Offsets = 049AH, 04DEH, 0500H, 0500H
Sheet records
049AH
ROW
Row = 2
04AEH
ROW
Row = 4
Cell records for this Row Block
04DEH
ROW
Row = 65
Cell records for this Row Block
0500H
ROW
Row = 100
Cell records for this Row Block
Sheet records
EOF
Because the third Row Block is empty, the third offset in the INDEX record array points to the fourth Row Block.
94
4.7 Cell Table and Row Blocks
⢠Finding Row Blocks in BIFF5-BIFF8
In BIFF5-BIFF8 the INDEX record contains an array with the stream positions of the DBCELL record (â5.29)
following the cell records in each Row Block. Because the DBCELL record is mandatory, a Row Block cannot be empty
anymore.
Example: A worksheet contains data in the rows 2, 4, 65, and 100. The range of used rows in the INDEX record
is 2âŚ101 (last used row + 1). There are 4 Row Blocks in the sheet: 2âŚ33, 34âŚ65, 66âŚ97, and 98âŚ130. The
third Row Block is empty except its DBCELL record.
0835H
BOF
Type = worksheet
0849H
INDEX
Row range = 2âŚ101
Offsets = 09A9H, 09D7H, 09E1H, 0A0BH
Sheet records
ROW
Row = 2
ROW
Row = 4
Cell records for this Row Block
09A9H
DBCELL
ROW
Row = 65
Cell records for this Row Block
09D7H
DBCELL
09E1H
DBCELL
ROW
Row = 100
Cell records for this Row Block
0A0BH
DBCELL
Sheet records
EOF
95
4 Worksheet/Workbook Stream
4.8 Array Formulas and Shared Formulas
An array formula (BIFF2-BIFF8) and a shared formula (BIFF5-BIFF8) is a formula spanning over a range of cells. Array
formulas are handled different from single cell formulas in a spreadsheet. Shared formulas are only an optimisation to
decrease the file size, they are not distinguishable from other cell formulas. Naturally an array formula cannot be a
shared formula at the same time. Shared formulas are created for instance when filling a cell range from a single formula
cell.
In general an array or shared formula is stored only once in a file, either in the ARRAY record (â5.4) for array formulas,
or in the SHAREDFMLA record (â5.94) for shared formulas. These records are part of the Formula Cell Block
(â4.7.2). They immediately follow the first FORMULA record (â5.50) for this range20. All array or shared formula cells
contain a reference to the formula data. This reference (tExp token, â3.10.1) consists of the cell address of the top left
cell of the range. In this way each formula cell can be associated with its formula data.
If a formula returns a string value, a STRING record (â5.102) follows the FORMULA record normally. In the case of
array and shared formulas, this STRING record follows the ARRAY or SHAREDFMLA record.
Example: A document contains, among other cells, an array formula in A2:B3, a single formula cell in D2, and a
shared formula in F2:F3, which returns string values.
ROW
Row = 1 (row 2 in user interface)
ROW
Row = 2 (row 3 in user interface)
FORMULA
Address = A2, is array formula, cell range origin = A2
ARRAY
Range = A2:B3, token array of the array formula
FORMULA
Address = B2, is array formula, cell range origin = A2
FORMULA
Address = D2, token array of the formula
FORMULA
Address = F2, is shared formula, cell range origin = F2
SHAREDFMLA
Range = F2:F3, token array of the shared formula
STRING
Result of previous formula (cell F2)
Cell records
FORMULA
Address = A3, is array formula, cell range origin = A2
FORMULA
Address = B3, is array formula, cell range origin = A2
FORMULA
Address = F3, is shared formula, cell range origin = F2
STRING
Result of previous formula (cell F3)
Cell records
20 For shared formulas the first FORMULA record may not be the top-left cell of the range. It is possible to overwrite single cells of a
shared formula range without invalidating the shared formula itself (the remaining formula cells).
96
4.9 Multiple Operation Tables
4.9 Multiple Operation Tables
A multiple operation table is a cell range filled with results of a given series of formulas and input values. Three different
kinds of multiple operations are supported:
1) A column with formulas is aggregated with a row of input values.
2) A row with formulas is aggregated with a column of input values.
3) A column and a row of input values are aggregated using one formula.
The formulas and input values are not included in the actual operation table. They must be located in the column left of
the table and in the row above the table. In case 3), the single formula is in the cell at top left of the table (outside).
All formulas should refer to a specific cell, the âinput cellâ. On calculation, this cell reference is replaced by the
respective value from the input value range in each formula. If the input values are located in the column, the input cell is
called âcolumn input cellâ, otherwise ârow input cellâ. In case 3) there is a column value range and a row value range.
Therefore both kinds of input cells are required here. The following examples show how multiple operation tables work.
Example for a multiple operation table in the range C2:D3, with formulas in a row (C1:D1 implicitly), and input
values in the column (B2:B3 implicitly). The table has been created with A1 as input cell. The highlighted range
is the operation table. The example shows the calculated formulas, but they are not really contained there.
A
B
C
D
E
1
Input cell
=A1^2
=SQRT(A1)
2
4 =B2^2
=SQRT(B2)
3
9 =B3^2
=SQRT(B3)
Example for a multiple operation table in the range C2:D3, with input values in column and row (C1:D1 and
B2:B3 implicitly, formula in B1). The table has been created with A1 as row input cell and A2 as column input
cell. Again, the highlighted range is the operation table.
A
B
C
D
E
1
Row input cell
=A1^A2
4
5
2
Column input cell
2 =C1^B2
=D1^B2
3
3 =C1^B3
=D1^B3
Similar to array and shared formulas a multiple operation table is described only once in a file. The DATATABLE
record (â5.24) is used for that, and possibly the DATATABLE2 record (â5.25) in BIFF2. These records are part of the
Formula Cell Block (â4.7.2). They immediately follow the first FORMULA record (â5.50) for this table. Each cell in
the table (which are all formula cells) contain a single tTbl token (â3.10.2) only. The token consists of the cell address
of the top left cell of the table. In this way each cell can be associated with the description of the table.
If a formula returns a string value, a STRING record (â5.102) follows the FORMULA record normally. In the case of
multiple operation table, this STRING record follows the DATATABLE or DATATABLE2 record.
Example: A document contains, among other cells, a multiple operation table in C2:D3.
ROW
Row = 1 (row 2 in user interface)
ROW
Row = 2 (row 3 in user interface)
FORMULA
Address = C2, is multiple operation, cell range origin = C2
DATATABLE
Range = C2:D3, table mode, input cell
FORMULA
Address = D2, is multiple operation, cell range origin = C2
Cell records
FORMULA
Address = C3, is array formula, cell range origin = C2
FORMULA
Address = D3, is array formula, cell range origin = C2
Cell records
97
4 Worksheet/Workbook Stream
4.10 Internal and External References
This chapter describes all types of 3D and external references. In detail, this could be:
⢠A reference to a cell or a cell range of another sheet in the same workbook (3D reference);
⢠A reference to a cell or a cell range of a sheet in another workbook (external reference);
⢠A reference to a global or local defined name (internal name);
⢠A reference to a defined name in another workbook (external name);
⢠An external function (add-in, sheet macro, Basic macro);
⢠A DDE link;
⢠An OLE link.
For external references and external names a combination of XCT and CRN records will occur. These records store
values of cells of the document. If the external document cannot be found, these values will be used to get the result of
an external reference. An XCT record (â5.114) contains the number of following CRN records. A CRN record (â5.23)
stores the contents of one cell or a sequence of cells of one row. Fragmentary cell ranges or cell ranges spanning over
more than one row are split into several CRN records. 3D references do not use these records because the referenced
cells are located in the own document.
It is possible to determine whether the cached cell values (the XCT and CRN records) will be stored in the file. In BIFF3
and BIFF4 this option is stored in the SHEETPR record (â5.97). From BIFF5 on the optional record BOOKBOOL
(â5.9) contains this option.
For all the following examples an external document âexample.xlsâ is used. It contains 3 sheets named âExtSheet1â,
âExtSheet2â and âExtSheet3â.
98
4.10 Internal and External References
4.10.1 References in BIFF2-BIFF4
2do
99
4 Worksheet/Workbook Stream
4.10.2 References in BIFF5
The data of references is spread in several Link Tables.
Definition: Global Link Table
The Global Link Table contains reference data used by internal defined names. It is located in the Workbook
Globals Substream (â4.2.4) and is followed by the list of DEFINEDNAME records containing definitions of all
internal defined names. If no names are defined in the document, or none of the defined names needs any
reference data, the Global Link Table will not occur.
Definition: Local Link Table
The reference data used in sheets (for example cell formulas) is stored in Local Link Tables inside the Sheet
Substreams (â4.2.4). Each worksheet that uses references contains its own Local Link Table.
⢠Structure of the Link Table
Common structure of the Link Table, BIFF5:
â
EXTERNCOUNT
â5.40
ââ EXTERNSHEET Blocks
Settings for a referenced worksheet or document
There are three different kinds of EXTERNSHEET Blocks, all starting with an EXTERNSHEET record.
The Internal EXTERNSHEET Sheet Block represents a referenced worksheet in the own document. The EXTERN-
SHEET record contains the sheet name only. There will not be any other records following it.
Common structure of an Internal EXTERNSHEET Sheet Block, BIFF5:
â
EXTERNSHEET
â5.41
The External EXTERNSHEET Sheet Block represents a referenced worksheet in an external document. The EXTERN-
SHEET record contains the URL of the document together with the sheet name. It is followed by cached cell contents if
enabled (see record BOOKBOOL, â5.9).
Common structure of an External EXTERNSHEET Sheet Block, BIFF5:
â
EXTERNSHEET
â5.41
â
XCT
â5.114
ââ CRN
â5.23
The EXTERNSHEET Document Block represents a complete external document (for example used for external names,
add-in functions, or DDE links). The EXTERNSHEET record only contains the URL of the document without a sheet
name. It is followed by external name definitions.
Common structure of an EXTERNSHEET Document Block, BIFF5:
â
EXTERNSHEET
â5.41
ââ EXTERNALNAME
â5.39
100
4.10 Internal and External References
⢠External and 3D References
External and 3D references are represented in a formula by the tokens tRef3d (â3.9.15) or tArea3d (â3.9.16). These
tokens contain an index to an EXTERNSHEET record located in the own Local Link Table and indexes to the first and
last referenced sheet.
For 3D references, the tokens contain a negative EXTERNSHEET index, indicating a reference into the own workbook.
The absolute value is the one-based index of the EXTERNSHEET record that contains the name of the first sheet. The
tokens additionally contain absolute indexes of the first and last referenced sheet. These indexes are independent of the
EXTERNSHEET record list. If the referenced sheets do not exist anymore, these indexes contain the value â1 (3D
reference to a deleted sheet), and an EXTERNSHEET record with the special name â<04H>â (own document) is used.
Each external reference contains the positive one-based index to an EXTERNSHEET record containing the URL of the
external document and the name of the sheet used. The sheet index fields of the tokens are not used.
Example: A document with 7 sheets (named from âSheet1â to âSheet7â) contains on âSheet1â the formulas
=Sheet2!A1,
=Sheet1!A1,
=SUM(Sheet4:Sheet6!A1:B3),
=SUM([example.xls]ExtSheet1!A1:B2) (contents: A1=1.11, B1=2.22, A2=3.33, B2=4.44),
=[example.xls]ExtSheet3!A1 (contents: âABCDâ), and
=Sheet8!A1.
The Local Link Table of Sheet1 contains 7 EXTERNSHEET Sheet Blocks:
EXTERNCOUNT Number of EXTERNSHEET records = 7
EXTERNSHEET 1 Name = â<03H>Sheet2â
EXTERNSHEET 2 Name = â<02H>â (own sheet, â2.5.9)
EXTERNSHEET 3 Name = â<03H>Sheet4â
EXTERNSHEET 4 Name = â<03H>Sheet6â
EXTERNSHEET 5 Name = â<01H>[example.xls]ExtSheet1â
XCT
Number of CRN = 2
CRN 0
Cell range = A1:B1, contents = 1.11, 2.22
CRN 1
Cell range = A2:B2, contents = 3.33, 4.44
EXTERNSHEET 6 Name = â<01H>[example.xls]ExtSheet3â
XCT
Number of CRN = 1
CRN 0
Cell range = A1, contents = âABCDâ
EXTERNSHEET 7 Name = â<04H>â (own workbook, â2.5.9)
Inside of the first formula the cell reference is represented by the token tRef3d (â3.9.15). The third formula
contains the token tArea3d (â3.9.16). The last formula contains a tRef3d token which refers to the last
EXTERNSHEET record and contains â1 as sheet indexes.
101
4 Worksheet/Workbook Stream
⢠Internal Names
All internal names are stored in the Global Link Table in a list of DEFINEDNAME records (â5.33). There exist two
types of internal names: global names which are valid in the whole workbook and local names which are attached to a
specific sheet. For instance the local name âMyCellâ of the sheet âSheet1â can be used from everywhere in the
workbook by entering =Sheet1!MyCell. Each DEFINEDNAME record contains the name itself and a one-based
index to the preceding EXTERNSHEET records to indicate a local name, or the index zero to indicate a global name.
Inside of a formula a global name or a local name of the own sheet is represented by the token tName (â3.9.1) with a
one-based index to the DEFINEDNAME record list. Local names from other sheets (with explicitly denoted sheet name)
are represented by the token tNameX (â3.9.14) with an index to a special EXTERNSHEET record and an index to the
DEFINEDNAME record list.
In defined names, only 3D references are allowed. The special syntax =!<reference> allowed in defined names only
(<reference> being a 2D cell reference or range reference) makes it possible to refer to cells or ranges in the same
sheet that contains the formula cell with the defined name.
Example: A document contains the global name âGlobalNameâ, and the local names âSheet1!LocalNameâ and
âSheet2!LocalNameâ. In âSheet1â there are the formulas
=GlobalName,
=LocalName,
=Sheet1!LocalName, and
=Sheet2!LocalName.
The defined name âGlobalNameâ contains the formula
=!$A$1.
The Global Link Table (together with the list of DEFINEDNAME records) contains the following records:
EXTERNCOUNT
Number of EXTERNSHEET records = 3
EXTERNSHEET 1
Name = â<00H>â (Current sheet for defined names, â2.5.9)
EXTERNSHEET 2
Name = â<03H>Sheet1â
EXTERNSHEET 3
Name = â<03H>Sheet2â
DEFINEDNAME 1
Name = âGlobalNameâ, EXTERNSHEET = 0 (Global)
Formula = tRef3d token with EXTERNSHEET = â1 (negative
one-based index to EXTERNSHEET 1, â3.9.15)
DEFINEDNAME 2
Name = âLocalNameâ, EXTERNSHEET = 2 (Sheet1)
DEFINEDNAME 3
Name = âLocalNameâ, EXTERNSHEET = 3 (Sheet2)
The Local Link Table of Sheet1 contains the following records:
EXTERNCOUNT
Number of EXTERNSHEET records = 1
EXTERNSHEET 1
Name = â<04H>â (Unspecified sheet in own workbook, â2.5.9)
The two former formulas contain a tNameV token each. The token in the first formula refers to DEFIN-
EDNAME 1 and the token in the second formula to DEFINEDNAME 2.
The two latter formulas contain a tNameXV token each. Both contain a reference to EXTERNSHEET 1 in the
Local Link Table. The token in the third formula refers to DEFINEDNAME 2 and the last formula refers to
DEFINEDNAME 3.
102
4.10 Internal and External References
⢠External Names
In Excel, formulas can use defined names located in another workbook, called âexternal namesâ. The definitions for
external names are stored in a combination of EXTERNSHEET Sheet Blocks and EXTERNSHEET Document Blocks.
The EXTERNSHEET Sheet Blocks contain the source document and sheet names the external names are located in, and
the cached cell contents. Following a single EXTERNSHEET Document Block that only contains the source document
name and the external name definitions themselves. This is repeated for each external document.
Inside of a formula an external name is represented by the token tNameX (â3.9.14). It contains the one-based index to
the EXTERNSHEET record (of the EXTERNSHEET Document Block) and a one-based index to an EXTERNALNAME
record inside this block. Each EXTERNALNAME record refers to a preceding EXTERNSHEET record containing the
sheet name.
Example: A document contains the formulas
=example.xls!GlobalName (location: ExtSheet3!C33; contents: 33),
=[example.xls]ExtSheet3!LocalName (location: ExtSheet1!B22; contents: âABCDâ),
=[example.xls]ExtSheet1!LocalName (location: ExtSheet1!A11; contents: 11), and
=another_example.xls!GlobalName (location: ExtSheet2!B2; contents: 2).
The Local Link Table of Sheet1 contains two EXTERNSHEET Sheet Blocks followed by an EXTERNSHEET
Document Block for the document âexample.xlsâ; and one EXTERNSHEET Sheet Block and one EXTERN-
SHEET Document Block for the document âanother_example.xlsâ:
EXTERNCOUNT
Number of EXTERNSHEET records = 5
EXTERNSHEET 1
Name = â<01H>[example.xls]ExtSheet1â
XCT
Number of CRN = 2
CRN 0
Cell range = A11, contents = 11
CRN 1
Cell range = B22, contents = âABCDâ
EXTERNSHEET 2
Name = â<01H>[example.xls]ExtSheet3â
XCT
Number of CRN = 1
CRN 0
Cell range = C33, contents = 33
EXTERNSHEET 3
Name = â<01H>example.xlsâ
EXTERNALNAME 1 Name = âGlobalNameâ, EXTERNSHEET = 0 (global),
Formula = â=[example.xls]ExtSheet3!C33â
EXTERNALNAME 2 Name = âLocalNameâ, EXTERNSHEET = 2,
Formula = â=[example.xls]ExtSheet1!B22â
EXTERNALNAME 3 Name = âLocalNameâ, EXTERNSHEET = 1,
Formula = â=[example.xls]ExtSheet1!A11â
EXTERNSHEET 4
Name = â<01H>[another_example.xls]ExtSheet2â
XCT
Number of CRN = 1
CRN 0
Cell range = B2, contents = 2
EXTERNSHEET 5
Name = â<01H>another_example.xlsâ
EXTERNALNAME 1 Name = âGlobalNameâ, EXTERNSHEET = 0 (global),
Formula = â=[another_example.xls]ExtSheet2!B2â
All formulas in the example above contain the token tNameXV.
The tokens of the first three formulas refer to EXTERNSHEET 3 (the EXTERNSHEET Document Block of
âexample.xlsâ). Each token refers to the respective EXTERNALNAME record following this EXTERNSHEET
record. For instance, the third formula refers to EXTERNALNAME 3 which contains the name âLocalNameâ
and refers to EXTERNSHEET 1. EXTERNSHEET 1 is used to obtain the sheet name of the external name. The
name is completed to â[example.xls]ExtSheet1!LocalNameâ.
The tNameXV token of the last formula refers to EXTERNSHEET 5 (the EXTERNSHEET Document Block of
âanother_example.xlsâ). Because EXTERNSHEET 5 describes a global external name, the name is directly
completed to âanother_example.xls!GlobalNameâ.
103
4 Worksheet/Workbook Stream
⢠Add-In Functions
If a worksheet uses add-in functions, a special EXTERNALNAME record containing the byte sequence 01H 3AH will
occur. It is followed by the names of all used add-in functions, each inside of an EXTERNALNAME record.
Example: A document contains the formulas =ISODD(1) and =ISEVEN(1).
The Local Link Table of Sheet1 contains an EXTERNSHEET Document Block with the special EXTERN-
SHEET record for add-in functions:
EXTERNCOUNT
Number of EXTERNSHEET records = 1
EXTERNSHEET 1
Name = â<3AH>â (add-in)
EXTERNALNAME 1 Name = âISODDâ
EXTERNALNAME 2 Name = âISEVENâ
The add-in function names are represented by tNameXR tokens in the formula, here referring to EXTERN-
SHEET 1 and to the respective EXTERNALNAME record. The token is the first argument of the
EXTERN.CALL function, which invokes the call of the add-in function.
⢠DDE Links, OLE Links
DDE links and OLE links expect the name of the server application (DDE) or the class name (OLE) and the name of a
source document. These items are encoded in an EXTERNSHEET record. It is followed by EXTERNALNAME records
with additional data of the links. An EXTERNALNAME record contains the item (data source range) or the identifier of
the OLE object data storage. Inside a formula, a DDE link or OLE data link is represented by the token tNameXV
(â3.9.14). An OLE object link contains a tNameX token in its OBJ record.
Example: A document contains a DDE link and an OLE data link to the range A1:B2 of Sheet1 in the Excel
document âD:\example.xlsâ and a linked OLE object to the bitmap file âD:\example.bmpâ.
The Local Link Table of Sheet1 contains two EXTERNSHEET Document Blocks, one for the DDE link, one for
the OLE data link, and one for the linked OLE object:
EXTERNCOUNT
Number of EXTERNSHEET records = 1
EXTERNSHEET 1
Name = âexcel<03H>D:\[example.xls]Sheet1â
(Server = âexcelâ; Topic = âD:\[example.xls]Sheet1â)
EXTERNALNAME 1 Type = DDE link, representing the âStdDocumentNameâ
identifier
Item = âStdDocumentNameâ
EXTERNALNAME 2 Type = DDE link
Item = âA1:B2â
EXTERNSHEET 2
Name = âExcel.Sheet.5<03H>D:\example.xlsâ
(Server = âExcel.Sheet.5â; Topic = âD:\example.xlsâ)
EXTERNALNAME 1 Type = OLE link
Item = â!Sheet1!A1:B2â
EXTERNSHEET 3
Name = âPackage<03H>D:\example.bmpâ
(Class name = âPackageâ; Document = âD:\example.bmpâ)
EXTERNALNAME 1 Type = OLE link
Storage = 00012345H (storage name = âLNK00012345â)
104
4.10 Internal and External References
4.10.3 References in BIFF8
The main data of all types of references is stored in the Link Table inside the Workbook Globals Substream (â4.2.5). All
formulas use only indexes for specific references. The Link Table itself is optional and occurs only, if there are any
references in the document.
Common structure of the Link Table, BIFF8:
ââ EXTERNALBOOK Blocks
Settings for a referenced document
â
EXTERNSHEET
â5.41
ââ DEFINEDNAME
â5.33
Each referenced document is represented by an EXTERNALBOOK Block. It starts with an EXTERNALBOOK record. It
contains the name of the document and the names of its sheets. It is followed by additional records that allow to deref-
erence the data in the document. After the last EXTERNALBOOK Block occurs only one EXTERNSHEET record. It
contains a list with indexes to the SUPBOOKs for each used reference anywhere in the document. Formulas use indexes
into this EXTERNSHEET list.
Example: A document contains (among other references) the two formulas
=[example.xls]ExtSheet2!A1 and
=[example.xls]ExtSheet1!A1.
EXTERNALBOOK
Any content
Block 0
Document = âexample.xlsâ
EXTERNALBOOK
Sheet 0 = âExtSheet1â
Block 1
Sheet 1 = âExtSheet2â
Sheet 2 = âExtSheet3â
EXTERNALBOOK
Any content
Block 2
EXTERNSHEET
REF 0 = any reference
REF 1 = {EXTERNALBOOK = 1, sheet range = 1âŚ1}
REF 2 = any reference
REF 3 = {EXTERNALBOOK = 1, sheet range = 0âŚ0}
REF 4 = any reference
The first formula uses REF 1 in the EXTERNSHEET record. REF 1 refers to EXTERNALBOOK Block 1 and
sheet range 1âŚ1. This means, the document âexample.xlsâ is used (document of EXTERNALBOOK Block 1)
and the name of the sheet is âExtSheet2â (sheet 1 of EXTERNALBOOK Block 1). In the same way, the second
formula uses REF 3 in the EXTERNSHEET record. All list entries inside of the EXTERNSHEET record are
unique. For instance all formulas in the workbook referring to sheet âExtSheet2â of the document âexample.xlsâ
use REF 1. All other EXTERNALBOOK Blocks and REFs are placeholders for other references in this example.
Common structure of an EXTERNALBOOK Block, BIFF8:
â
EXTERNALBOOK
â5.38
ââ EXTERNALNAME
â5.39
â
XCT
â5.114
ââ ââ CRN
â5.23
The EXTERNALBOOK Block may contain cached values of cells in the referenced document. These values are stored in
several XCT and CRN records.
105
4 Worksheet/Workbook Stream
⢠External and 3D References
The EXTERNALBOOK for the own document has a special format: It contains only the number of all sheets and the
byte sequence 01H 04H instead of the sheet names. The sheet range indexes in the EXTERNSHEET record refer to the
position of the sheets (zero-based). If a referenced sheet does not exist anymore, the sheet index â1 will occur (deleted
3D reference).
Example: A document with 7 sheets (named from âSheet1â to âSheet7â) contains the formulas
=Sheet2!A1,
=SUM(Sheet4:Sheet6!A1:B3),
=SUM([example.xls]ExtSheet1!A1:B2) (contents: A1=1.11, B1=2.22, A2=3.33, B2=4.44),
=[example.xls]ExtSheet3!A1 (contents: âABCDâ), and
=Sheet8!A1.
EXTERNALBOOK 0 Number of sheets: 7
01H 04H (own workbook)
EXTERNALBOOK 1 Number of sheets: 3
Document = âexample.xlsâ
Sheet 0 = âExtSheet1â
Sheet 1 = âExtSheet2â
Sheet 2 = âExtSheet3â
XCT
Number of CRN = 2, sheet = 0 (ExtSheet1)
CRN 0
Cell range = A1:B1, contents = 1.11, 2.22
CRN 1
Cell range = A2:B2, contents = 3.33, 4.44
XCT
Number of CRN = 1, sheet = 2 (ExtSheet3)
CRN 0
Cell range = A1, contents = âABCDâ
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = 1âŚ1}
REF 1 = {EXTERNALBOOK = 0, sheet range = 3âŚ5}
REF 2 = {EXTERNALBOOK = 1, sheet range = 0âŚ0}
REF 3 = {EXTERNALBOOK = 1, sheet range = 1âŚ1}
REF 4 = {EXTERNALBOOK = 0, sheet range = â1âŚâ1}
Inside of the first formula the cell reference is represented by the token tRef3d (â3.9.15). The second formula
contains the token tArea3d (â3.9.16).
106
4.10 Internal and External References
⢠Internal Names
All internal names are stored in a list of DEFINEDNAME records (â5.33) that follows the EXTERNSHEET record.
There exist two types of internal names: global names which are valid in the whole workbook and local names which are
attached to a specific sheet. For instance the local name âMyCellâ of the sheet âSheet1â can be used from everywhere in
the workbook by entering =Sheet1!MyCell. Each DEFINEDNAME record contains the name itself and a one-
based sheet index. The index zero indicates a global name. If the document contains local names, a special REF entry
will be created in the EXTERNSHEET record. It contains the index to the internal EXTERNALBOOK and the sheet
range â2âŚâ2.
Inside of a formula a global name or a local name of the own sheet is represented by the token tName (â3.9.1) with a
one-based index to the DEFINEDNAME record list. Local names from other sheets (with explicitly denoted sheet name)
are represented by the token tNameX (â3.9.14) with an index to the special REF entry of the EXTERNSHEET record
and an index to the DEFINEDNAME record list.
In defined names, only 3D references are allowed. The special syntax =!<reference> allowed in defined names only
(<reference> being a 2D cell reference or range reference) makes it possible to refer to cells or ranges in the same
sheet that contains the formula cell with the defined name.
Example for internal names: A document contains the global name âGlobalNameâ, and the local names âSheet1!
LocalNameâ and âSheet2!LocalNameâ. In âSheet1â there are the formulas
=GlobalName,
=LocalName,
=Sheet1!LocalName, and
=Sheet2!LocalName.
The defined name âGlobalNameâ contains the formula
=!$A$1.
EXTERNALBOOK 0 Number of sheets: 3
01H 04H (own workbook)
EXTERNALBOOK 1 Number of sheets: 0
Document = â<00H>â (Current sheet for defined names, â2.5.9)
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = 0âŚ0}
REF 1 = { EXTERNALBOOK = 0, sheet range = â2âŚâ2}
REF 2 = { EXTERNALBOOK = 1, sheet range = â2âŚâ2}
DEFINEDNAME 1
Name = âGlobalNameâ, sheet (one-based) = 0 (Global)
Formula = tRef3d token to REF 2 (â3.9.15)
DEFINEDNAME 2
Name = âLocalNameâ, sheet (one-based) = 1 (Sheet1)
DEFINEDNAME 3
Name = âLocalNameâ, sheet (one-based) = 2 (Sheet2)
The first formula in the example above contains the token tNameV referring to DEFINEDNAME 1 and the
second formula the same token referring to DEFINEDNAME 2.
The two latter formulas contain the token tNameXV with a reference to REF 1 in the EXTERNSHEET record.
REF 1 refers to EXTERNALBOOK 0 with the special sheet indexes for defined names. The token of the third
formula refers to DEFINEDNAME 2 and the token of the last formula refers to DEFINEDNAME 3.
107
4 Worksheet/Workbook Stream
⢠External Names
In Excel, formulas can use defined names located in another workbook, called âexternal namesâ. In this case for each
name an EXTERNALNAME record (â5.39) occurs after the EXTERNALBOOK record. The EXTERNALNAME
record contains the name itself and the one-based index to the sheet name of the EXTERNALBOOK record. Again the
index zero indicates a global name. If an EXTERNALBOOK contains external names, a special REF entry will be
created in the EXTERNSHEET record. It contains the index to the EXTERNALBOOK and the sheet range â2âŚâ2.
Inside of a formula an external name is represented by the token tNameX (â3.9.14). It contains the index to the special
REF entry inside of the EXTERNSHEET record and the index to an EXTERNALNAME record (one-based).
Example: A document contains the formulas
=example.xls!GlobalName (location: ExtSheet3!C33; contents: 33),
=[example.xls]ExtSheet3!LocalName (location: ExtSheet1!B22; contents: âABCDâ), and
=[example.xls]ExtSheet1!LocalName (location: ExtSheet1!A11; contents: 11).
EXTERNALBOOK 0 Document = âexample.xlsâ
Sheet 0 = âExtSheet1â
Sheet 1 = âExtSheet2â
Sheet 2 = âExtSheet3â
EXTERNALNAME 1 Name = âGlobalNameâ, sheet (one-based) = 0 (Global),
Formula = â=[example.xls]ExtSheet3!C33â
EXTERNALNAME 2 Name = âLocalNameâ, sheet (one-based) = 3 (ExtSheet3),
Formula = â=[example.xls]ExtSheet1!B22â
EXTERNALNAME 3 Name = âLocalNameâ, sheet (one-based) = 1 (ExtSheet1),
Formula = â=[example.xls]ExtSheet1!A11â
XCT
Number of CRN = 2, sheet = 0 (ExtSheet1)
CRN 0
Cell range = A11, contents = 11
CRN 1
Cell range = B22, contents = âABCDâ
XCT
Number of CRN = 1, sheet = 2 (ExtSheet3)
CRN 0
Cell range = C33, contents = 33
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = â2âŚâ2}
All formulas in the example above contain the token tNameXV with a reference to REF 0 in the EXTERN-
SHEET record. REF 0 refers to EXTERNALBOOK 0 with the special sheet indexes for defined names.
Therefore the EXTERNALNAME records of EXTERNALBOOK 0 are used.
The token of the first formula refers to EXTERNALNAME 1, the token of the second formula refers to EXTER-
NALNAME 2, and the token of the last formula refers to EXTERNALNAME 3.
⢠Add-In Functions
If a workbook uses add-in functions, a special EXTERNALBOOK containing the byte sequence 01H 3AH will occur. It
is followed by the names of all used add-in functions, each inside of an EXTERNALNAME record. A special REF entry
with the sheet range â2âŚâ2 will be inserted into the EXTERNSHEET reference list.
Example: A document contains the formulas =ISODD(1) and =ISEVEN(1).
EXTERNALBOOK 0 01H 3AH (add-in)
EXTERNALNAME 1 Name = âISODDâ
EXTERNALNAME 2 Name = âISEVENâ
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = â2âŚâ2}
The add-in function names are represented by tNameXR tokens in the formula, here referring to REF 0 and to
the respective EXTERNALNAME record. The token is the first argument of the EXTERN.CALL function,
which invokes the call of the add-in function.
108
4.10 Internal and External References
⢠DDE Links, OLE Links
DDE links and OLE links expect the name of the server application (DDE) or the class name (OLE) and the name of a
source document. These items are encoded in an EXTERNSHEET record. It is followed by EXTERNALNAME records
with additional data of the links. An EXTERNALNAME record contains the item (data source range) or the identifier of
the OLE object data storage. Inside a formula, a DDE link or OLE data link is represented by the token tNameXV
(â3.9.14). An OLE object link contains a tNameX token in its OBJ record.
Example: A document contains a DDE link and an OLE data link to the range A1:B2 of Sheet1 in the Excel
document âD:\example.xlsâ and a linked OLE object to the bitmap file âD:\example.bmpâ.
EXTERNALBOOK 0 Server application = âexcelâ
Topic = âD:\[example.xls]Sheet1â
EXTERNALNAME 1 Type = DDE link, representing the âStdDocumentNameâ
identifier
Item = âStdDocumentNameâ
EXTERNALNAME 2 Type = DDE link
Item = âA1:B2â
EXTERNALBOOK 1 Class name = âExcel.Sheet.8â
Document = âD:\example.xlsâ
EXTERNALNAME 1 Type = OLE link
Item = â!Sheet1!A1:B2â
EXTERNALBOOK 2 Class name = âPackageâ
Document = âD:\example.bmpâ
EXTERNALNAME 1 Type = OLE link
Storage = 00012345H (storage name = âLNK00012345â)
EXTERNSHEET
REF 0 = {EXTERNALBOOK = 0, sheet range = â2âŚâ2}
REF 1 = {EXTERNALBOOK = 1, sheet range = â2âŚâ2}
REF 2 = {EXTERNALBOOK = 2, sheet range = â2âŚâ2}
109
4 Worksheet/Workbook Stream
4.11 Shared String Table (BIFF8)
4.11.1 The SST Record
Definition: Shared String Table
A BIFF8 workbook collects the strings of all text cells in a global list, the Shared String Table. This table is
located in the record SST in the Workbook Globals Substream (â4.2.5).
An SST record may be followed by an EXTSST record which stores stream positions for a string hash table.
Common structure of the Shared String Table, BIFF8:
â
SST
â5.100
â
EXTSST
â5.42
Text cells are represented by LABELSST records (â5.65) which contain indexes into the SST record. For reading Excel
files, only the SST record and the LABELSST records are important.
Example: A workbook contains anywhere the strings âAAAâ, âBBBâ and âCCCâ.
BOF
Type = workbook globals
Workbook globals records
SST
Total number of strings in document = 4, strings in SST = 3
String 0 = âAAAâ
String 1 = âBBBâ
String 2 = âCCCâ
EXTSST
See below
Workbook globals records
EOF
BOF
Type = worksheet
Cell records
LABELSST
String index = 0 (results in âAAAâ)
LABELSST
String index = 2 (results in âCCCâ)
Cell records
LABELSST
String index = 1 (results in âBBBâ)
LABELSST
String index = 0 (results in âAAAâ)
Cell records
EOF
110
4.11 Shared String Table (BIFF8)
4.11.2 The EXTSST Record
The EXTSST record is used by Excel to create a string hash table, while loading the document. It contains stream
positions of specific strings in the SST record. The SST record will be divided into several portions, which all contain
the same number of strings. The first string in each portion will be referenced in the EXTSST record. It is not required to
write an EXTSST record when exporting an Excel document.
The following example shows the absolute stream position in the first column and the relative record position
(including the record headers) in the second column. The SST record is too long so that some of the strings are
following in the CONTINUE record.
Abs. stream offset Rel. rec. offset
Contents
Description
00020000H
0000H
00FCH
SST identifier
00020002H
0002H
1000H
Size of the SST record
00020004H
0004H
00000011H
Total number of strings in the document
00020008H
0008H
00000011H
Number of unique strings following
0002000CH
000CH
String 0 (total size = 0100H bytes)
0002010CH
010CH
String 1 (total size = 0200H bytes)
0002030CH
030CH
String 2 (total size = 0100H bytes)
âŽ
âŽ
âŽ
00020800H
0800H
String 8 (total size = 0100H bytes)
âŽ
âŽ
âŽ
00021004H
0000H
003CH
CONTINUE identifier
00021006H
0002H
0320H
Size of the CONTINUE record
00021008H
0004H
Continuation of string 14 (size = 0020H bytes)
00021028H
0024H
String 15 (total size = 0100H bytes)
00021128H
0124H
String 16 (total size = 0200H bytes)
00021328H
0000H
00FFH
EXTSST identifier
0002132AH
0002H
001AH
Size of the EXTSST record
0002132CH
0004H
0008H
8 strings in each portion
0002132EH
0006H
0002000CH
Absolute stream position of string 0
00021332H
000AH
000CH
Relative record position of string 0 (in SST)
00021334H
000CH
0000H
Not used
00021336H
000EH
00020800H
Absolute stream position of string 8
0002133AH
0012H
0800H
Relative record position of string 8 (in SST)
0002133CH
0014H
0000H
Not used
0002133EH
0016H
00021128H
Absolute stream position of string 16
00021342H
001AH
0124H
Relative record position of string 16 (in CONTINUE)
00021344H
001CH
0000H
Not used
111
4 Worksheet/Workbook Stream
4.12 Conditional Formatting Table (BIFF8)
Definition: Conditional Formatting Table
The settings of conditional formattings are stored for each sheet in the Conditional Formatting Table. It is
contained in the Sheet Substream following the cell records (â4.2.5).
Structure of the Conditional Formatting Table, BIFF8:
â
CFHEADER
â5.15
ââ ââ CFRULE
â5.16
Each CFHEADER record in this table with its following CFRULE records describes identical conditional formatting
attributes for several cells in the worksheet.
4.13 Hyperlink Table (BIFF8)
Definition: Hyperlink Table
Hyperlinks are stored for each sheet in the Hyperlink Table. It is contained in the Sheet Substream following the
cell records (â4.2.5).
Structure of the Hyperlink Table, BIFF8:
â
HYPERLINK
â5.58
ââ
â
QUICKTIP
â5.83
Each HYPERLINK record in this table describes a hyperlink. The optional QUICKTIP record contains a tool tip that
occurs when the mouse pointer is over the hyperlink cell.
4.14 Data Validity Table (BIFF8)
Definition: Data Validity Table
Data validity settings are stored for each sheet in the Data Validity Table. It is contained in the Sheet Substream
following the cell records (â4.2.5).
Structure of the Data Validity Table, BIFF8:
â
DATAVALIDATIONS â5.27
ââ DATAVALIDATION
â5.26
A DATAVALIDATIONS record introduces the list of DATAVALIDATION records. The DATAVALIDATIONS record
contains the number of DATAVALIDATION records. Each DATAVALIDATION record contains data validity settings
for and the addresses of all affected cells.
112
4.15 AutoFilter, Advanced Filter
4.15 AutoFilter, Advanced Filter
2do
4.16 Scenarios
2do
4.17 Web Queries (BIFF8)
2do
113
4 Worksheet/Workbook Stream
4.18 Worksheet/Workbook Protection
An Excel document may contain different types of protection.
Definition: Worksheet/workbook protection
Worksheet/workbook protection protects specific contents of the worksheet or workbook, for instance window
settings, cell contents, or objects.
Definition: File protection
File protection protects the file itself, either sets to read-only, or restricts read and write access. File protection
does not care about the contents of the document. This type of protection is described in the next chapter
(â4.19).
Not all records regarding protection must occur in the stream. If a record is omitted, the corresponding item is not active
(for instance: omitting the OBJECTPROTECT record leaves objects unprotected). For the position of the mentioned
records in the substreams see â4.2.
4.18.1 Single Worksheet Protection (BIFF2-BIFF4)
Definition: Worksheet Protection Block
Several records in the Worksheet Protection Block determine the protected items in the sheet.
PROTECT protects the cell contents, WINDOWPROTECT protects the window settings, and OBJECTPROTECT
protects the embedded objects. The PASSWORD record contains the hash value of the password (â4.18.4) used to
protect the sheet. All the mentioned records occur always, if the file was written by Excel, but may be omitted.
If a protection password is set in the PASSWORD record, the read/write file protection (â4.19) will be enabled, which
causes encryption of the file (â4.19.1) in every case. If this protection is not enabled manually while saving the file, the
built-in password âVelvetSweatshopâ is used, not the password set for worksheet protection.
Structure of the Worksheet Protection Block, BIFF2-BIFF4:
â
PROTECT
Cell contents: 1 = protected (â5.82)
â
WINDOWPROTECT
Window settings: 1 = protected (â5.111)
â
OBJECTPROTECT
Embedded objects: 1 = protected (â5.72)
â
PASSWORD
Hash value of the password; 0 = No password (â5.76)
4.18.2 Sheet Protection in a Workbook (BIFF5-BIFF8)
The PROTECT record in the Worksheet Protection Block indicates that the sheet is protected. There may follow a
SCENPROTECT record or/and an OBJECTPROTECT record. The optional PASSWORD record contains the hash
value of the password used to protect the sheet (â4.18.4). In BIFF8, there may occur additional records following the
cell records in the Sheet Substream (â4.2.5).
Sheet protection with password does not cause to switch on read/write file protection. Therefore the file will not be
encrypted.
Structure of the Worksheet Protection Block, BIFF5-BIFF8:
â
PROTECT
Worksheet contents: 1 = protected (â5.82)
â
OBJECTPROTECT
Embedded objects: 1 = protected (â5.72)
â
SCENPROTECT
Scenarios: 1 = protected (â5.91)
â
PASSWORD
Hash value of the password; 0 = no password (â5.76)
114
4.18 Worksheet/Workbook Protection
4.18.3 Workbook Protection (BIFF5-BIFF8)
Definition: Workbook Protection Block
The Workbook Protection Block in the Workbook Globals Substream determines the protected items in the entire
workbook.
The PROTECT record protects the workbook contents and the WINDOWPROTECT record protects the window
settings. The PASSWORD record contains the hash value of the password used to protect the workbook (â4.18.4). All
the mentioned records occur always, if the file was written by Excel, but may be omitted.
If a protection password is set in the PASSWORD record, the read/write file protection (â4.19) will be enabled, which
causes encryption of the file (â4.19.1) in every case. If this protection is not enabled manually while saving the file, the
built-in password âVelvetSweatshopâ is used, not the password set for workbook protection.
Structure of the Workbook Protection Block:
â
WINDOWPROTECT
Window settings: 1 = protected (â5.111)
â
PROTECT
Workbook contents: 1 = protected (â5.82)
â
PASSWORD
Hash value of the password; 0 = no password (â5.76)
â
PROT4REV
Shared workbook: 1 = protected
â
PROT4REVPASS
Hash value of the shared password; 0 = no password
4.18.4 Password Hash Value
In several records the hash value of a password is stored, used for later verification of an entered password. The length of
the password is restricted to 15 characters.
The following pseudo-code algorithm shows how to create such a hash value from a given byte-string password:
ALGORITHM Get_Password_Hash( password )
1) hash â 0 ; char_index â char_count â character count of password
2) char_index â char_index - 1
3) char â character from password with index char_index {0 is leftmost character}
4) hash â hash XOR char
5) rotate the lower 15 bits of hash left by 1 bit
6) IF char_index > 0 THEN JUMP 2)
7) RETURN hash XOR char_count XOR CE4BH
115
4 Worksheet/Workbook Stream
Example: The password is âabcdefghijâ (10 characters).
Step
char_index
char (step 3)
hash (step 4)
hash (step 5)
1)
10
0000H
2) - 5)
9
6AH ('j')
006AH
00D4H
2) - 5)
8
69H ('i')
00BDH
017AH
2) - 5)
7
68H ('h')
0112H
0224H
2) - 5)
6
67H ('g')
0243H
0486H
2) - 5)
5
66H ('f')
04E0H
09C0H
2) - 5)
4
65H ('e')
09A5H
134AH
2) - 5)
3
64H ('d')
132EH
265CH
2) - 5)
2
63H ('c')
263FH
4C7EH
2) - 5)
1
62H ('b')
4C1CH
1839H
2) - 5)
0
61H ('a')
1858H
30B0H
7)
FEF1H
116
4.19 File Protection
4.19 File Protection
A file might be protected with a password against modifying (write protection), or against opening at all (read/write
protection). These passwords are set in the Save-As dialogue of Excel.
⢠Write protection (BIFF3-BIFF8): The WRITEPROT record marks the file to be protected against modifying. The
password to unprotect the file is stored in the FILESHARING record. Write protection does not cause to encrypt the
file.
⢠Read/write protection (BIFF2-BIFF8): A FILEPASS record occurs containing stream encryption information, which
includes the encrypted password. All following records are encrypted (â4.19.1).
Definition: File Protection Block
The records of the File Protection Block describe the file protection and are the first records in a file (â4.2).
Structure of the File Protection Block:
File is write protected (BIFF3-BIFF8,
â
WRITEPROT
â5.113), password in
FILESHARING
â
FILEPASS
File is read/write-protected, encryption information (â5.43)
â
WRITEACCESS
User name (BIFF3-BIFF8, â5.112)
â
FILESHARING
File sharing options (BIFF3-BIFF8, â5.44)
4.19.1 BIFF2-BIFF5 XOR Stream Encryption
Encryption takes place for the contents of a record. The record header (record identifier and size) is not encrypted. There
are a few records or data fields that are never encrypted either:
⢠The entire BOF record (â5.8)
⢠The entire INTERFACEHDR record
⢠The stream position field in the SHEET record (â5.95)
Stream encryption takes place in several steps:
4) get the password from the user
5) create hash value (16-bit, â4.18.4) and encryption key (16-bit, see below) from the password
6) store hash value and encryption key in FILEPASS record (â5.43)
7) create the 128-bit sized key sequence from password and encryption key (see below)
8) encrypt all following records using the key sequence (see below)
Stream decryption works similar to encryption:
9) get the password from the user
10) create hash value (16-bit, â4.18.4) and encryption key (16-bit, see below) from the password
11) compare with values contained in FILEPASS record
12) if password is correct, create the 128-bit sized key sequence from password and encryption key (see below)
13) decrypt all following records using the key sequence (see below)
117
4 Worksheet/Workbook Stream
⢠BIFF2-BIFF5 Encryption Key
The 16-bit encryption key is used for the BIFF2-BIFF5 XOR stream encryption algorithm (â4.19.1). It is calculated
from the password. The FILEPASS record stores this key and the hash value (â4.18.4) of the password (the hash value
is not used to encrypt the data). The length of the password is restricted to 15 characters.
The following pseudo-code algorithm shows how to create the encryption key from a given byte-string password:
ALGORITHM Get_Encryption_Key_XOR( password )
1) key â 0 ; key_base â 8000H ; key_final â FFFFH ; char_index â 0
2) char_count â character count of password
3) char â character from password with index char_index {right-to-left, 0 is rightmost}
4) char â char AND 7FH
{use only the lower 7 bits of each character}
5) bit_index â 0
6) rotate the lower 16 bits of key_base left by 1 bit
7) IF (least significant bit of key_base) = 1 THEN key_base â key_base XOR 1020H
8) rotate the lower 16 bits of key_final left by 1 bit
9) IF (least significant bit of key_final) = 1 THEN key_final â key_final XOR 1020H
10) IF (bit with index bit_index in char) = 1 THEN key â key XOR key_base
11) bit_index â bit_index + 1
12) IF bit_index < 8 THEN JUMP 6)
13) char_index â char_index + 1
14) IF char_index < char_count THEN JUMP 3)
15) RETURN key XOR key_final
⢠BIFF2-BIFF5 Encryption Key Sequence
The encryption sequence is needed to encrypt or decrypt the record contents. It is generated from the password and the
encryption key (which is generated from the password too, see above). The size of the encryption key sequence is always
128 bit.
The following pseudo-code algorithm shows how to create the encryption key from a given byte-string password (and the
encryption key âkeyâ):
ALGORITHM Get_Key_Sequence_XOR( password, key )
1) char_count â character count of password
2) create a sequence key_seq[] containing 16 bytes
3) fill the first char_count bytes of key_seq[] with all characters of password
4) fill the remaining (16 â char_count) bytes of key_seq[] with the first bytes of the sequence
{ BBH,FFH,FFH,BAH,FFH,FFH,B9H,80H,00H,BEH,0FH,00H,BFH,0FH,00H }
5) key_lower â lower 8 bits of key ; key_upper â upper 8 bits of key
6) seq_index â 0
7) key_seq[seq_index] â key_seq[seq_index] XOR key_lower
8) key_seq[seq_index + 1] â key_seq[seq_index + 1] XOR key_upper
9) seq_index â seq_index + 2
10) IF seq_index < 16 THEN JUMP 7)
11) rotate all bytes of key_seq left by 2 bits
12) RETURN key_seq[]
118
4.19 File Protection
⢠BIFF2-BIFF5 Stream Encryption
To encrypt record data, a 128-bit sized key sequence is used, which has been generated from a password before (see
above). All stream data is encrypted in blocks of 16 bytes using the key sequence. In every data block, each byte is
encoded using the corresponding byte of the key sequence. The offset pointer into the key sequence is reinitialised
whenever a new record is started. The initial value of this offset is dependent on the stream position and size of the new
record (it does not simply restart at 0). For details see the following algorithm.
The following pseudo-code algorithm shows how to encrypt the data of an entire record (assuming that stream points to
the start of the record data):
ALGORITHM Write_Record_XOR( stream, record_data[], record_size, key_seq[]
)
1) key_index â ((position of stream) + record_size) AND 0FH
2) record_index â 0
3) IF record_index = record_size THEN RETURN
4) data_byte = record_data[record_index] XOR key_seq[key_index]
5) rotate all 8 bits of data_byte right by 3 bits
6) write data_byte to stream
7) key_index â (key_index + 1) AND 0FH
{rotate inside key_seq[]}
8) record_index â record_index + 1
9) JUMP 3)
⢠BIFF2-BIFF5 Stream Decryption
To decrypt record data, a 128-bit sized key sequence is used, which has been generated from a password before (see
above). Decryption works similar to encryption (see above), but in reversed order of operations.
The following pseudo-code algorithm shows how to decrypt the data of an entire record (assuming that stream points to
the start of the record data):
ALGORITHM Read_Record_XOR( stream, record_size, key_seq[] )
1) key_index â ((position of stream) + record_size) AND 0FH
2) create a sequence record_data[] containing record_size bytes
3) record_index â 0
4) IF record_index = record_size THEN RETURN record_data[]
5) data_byte â read 1 byte from stream
6) rotate all 8 bits of data_byte left by 3 bits
7) record_data[record_index] â data_byte XOR key_seq[key_index]
8) key_index â (key_index + 1) AND 0FH
{rotate inside key_seq[]}
9) record_index â record_index + 1
10) JUMP 4)
119
5 Worksheet/Workbook Records
5
Worksheet/Workbook Records
The filled dot âââ means, that Excel supports the record on import and export. The unfilled dot âââ means, that Excel
can read the record, but does not write it anymore in the respective BIFF version. An empty field denotes that the record
is not supported, or that the identifier has been changed in this BIFF version.
5.1 Overview, Ordered by Record Identifier
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0000H
DIMENSION
â
0001H
BLANK
â
0002H
INTEGER
â
0003H
NUMBER
â
0004H
LABEL
â
0005H
BOOLERR
â
0006H
FORMULA
â
â
â
0007H
STRING
â
0008H
ROW
â
0009H
BOF
â
000AH
EOF
â
â
â
â
â
000BH
INDEX
â
000CH
CALCCOUNT
â
â
â
â
â
000DH
CALCMODE
â
â
â
â
â
000EH
PRECISION
â
â
â
â
â
000FH
REFMODE
â
â
â
â
â
0010H
DELTA
â
â
â
â
â
0011H
ITERATION
â
â
â
â
â
0012H
PROTECT
â
â
â
â
â
0013H
PASSWORD
â
â
â
â
â
0014H
HEADER
â
â
â
â
â
0015H
FOOTER
â
â
â
â
â
0016H
EXTERNCOUNT
â
â
â
0017H
EXTERNSHEET
â
â
â
â
â
0018H
DEFINEDNAME
â
â
â
120
5.1 Overview, Ordered by Record Identifier
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0019H
WINDOWPROTECT
â
â
â
â
â
001AH
VERTICALPAGEBREAKS
â
â
â
â
â
001BH
HORIZONTALPAGEBREAKS
â
â
â
â
â
001CH
NOTE
â
â
â
â
â
001DH
SELECTION
â
â
â
â
â
001EH
FORMAT
â
â
001FH
BUILTINFMTCOUNT
â
0020H
COLUMNDEFAULT
â
0021H
ARRAY
â
0022H
DATEMODE
â
â
â
â
â
0023H
EXTERNALNAME
â
â
â
0024H
COLWIDTH
â
0025H
DEFAULTROWHEIGHT
â
0026H
LEFTMARGIN
â
â
â
â
â
0027H
RIGHTMARGIN
â
â
â
â
â
0028H
TOPMARGIN
â
â
â
â
â
0029H
BOTTOMMARGIN
â
â
â
â
â
002AH
PRINTHEADERS
â
â
â
â
â
002BH
PRINTGRIDLINES
â
â
â
â
â
002FH
FILEPASS
â
â
â
â
â
0031H
FONT
â
â
â
0032H
FONT2
â
0036H
DATATABLE
â
0037H
DATATABLE2
â
003CH
CONTINUE
â
â
â
â
â
003DH
WINDOW1
â
â
â
â
â
003EH
WINDOW2
â
0040H
BACKUP
â
â
â
â
â
0041H
PANE
â
â
â
â
â
0042H
CODEPAGE
â
â
â
â
â
0043H
XF
â
0044H
IXFE
â
0045H
FONTCOLOR
â
004DH
PLS
â
â
â
â
â
0051H
DCONREF
â
â
â
â
â
0055H
DEFCOLWIDTH
â
â
â
â
â
0056H
BUILTINFMTCOUNT
â
â
0059H
XCT
â
â
â
â
005AH
CRN
â
â
â
â
005BH
FILESHARING
â
â
â
â
005CH
WRITEACCESS
â
â
â
â
005EH
UNCALCED
â
â
â
â
005FH
SAVERECALC
â
â
â
â
0063H
OBJECTPROTECT
â
â
â
â
121
5 Worksheet/Workbook Records
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
007DH
COLINFO
â
â
â
â
0080H
GUTS
â
â
â
â
0081H
SHEETPR
â
â
â
â
0082H
GRIDSET
â
â
â
â
0083H
HCENTER
â
â
â
â
0084H
VCENTER
â
â
â
â
0085H
SHEET
â
â
0086H
WRITEPROT
â
â
â
â
008CH
COUNTRY
â
â
â
â
008DH
HIDEOBJ
â
â
â
â
0090H
SORT
â
â
0092H
PALETTE
â
â
â
â
0099H
STANDARDWIDTH
â
â
â
00A0H
SCL
â
â
â
00A1H
PAGESETUP
â
â
â
00ABH
GCW
â
â
00BDH
MULRK
â
â
00BEH
MULBLANK
â
â
00D6H
RSTRING
â
â
00D7H
DBCELL
â
â
00DAH
BOOKBOOL
â
â
00DDH
SCENPROTECT
â
â
00E0H
XF
â
â
00E5H
MERGEDCELLS
â
00E9H
BITMAP
â
00EFH
PHONETICPR
â
00FCH
SST
â
00FDH
LABELSST
â
00FFH
EXTSST
â
015FH
LABELRANGES
â
0160H
USESELFS
â
0161H
DSF
â
01AEH
EXTERNALBOOK
â
01B0H
CFHEADER
â
01B2H
DATAVALIDATIONS
â
01B8H
HYPERLINK
â
01BEH
DATAVALIDATION
â
0200H
DIMENSION
â
â
â
â
0201H
BLANK
â
â
â
â
0203H
NUMBER
â
â
â
â
0204H
LABEL
â
â
â
â
0205H
BOOLERR
â
â
â
â
0206H
FORMULA
â
0207H
STRING
â
â
â
â
122
5.1 Overview, Ordered by Record Identifier
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0208H
ROW
â
â
â
â
0209H
BOF
â
020BH
INDEX
â
â
â
â
0218H
DEFINEDNAME
â
â
0221H
ARRAY
â
â
â
â
0223H
EXTERNALNAME
â
â
0225H
DEFAULTROWHEIGHT
â
â
â
â
0231H
FONT
â
â
0236H
DATATABLE
â
â
â
â
023EH
WINDOW2
â
â
â
â
0243H
XF
â
027EH
RK
â
â
â
â
0293H
STYLE
â
â
â
â
0406H
FORMULA
â
0409H
BOF
â
041EH
FORMAT
â
â
â
0443H
XF
â
04BCH
SHAREDFMLA
â
â
0800H
QUICKTIP
â
0809H
BOF
â
â
0862H
SHEETLAYOUT
â
0867H
SHEETPROTECTION
â
0868H
RANGEPROTECTION
â
123
5 Worksheet/Workbook Records
5.2 Overview, Ordered by Record Names
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0021H 0221H
ARRAY
â
â
â
â
â
0040H
BACKUP
â
â
â
â
â
00E9H
BITMAP
â
0001H 0201H
BLANK
â
â
â
â
â
0*09H
BOF
â
â
â
â
â
00DAH
BOOKBOOL
â
â
0005H 0205H
BOOLERR
â
â
â
â
â
0029H
BOTTOMMARGIN
â
â
â
â
â
001FH 0056H
BUILTINFMTCOUNT
â
â
â
000CH
CALCCOUNT
â
â
â
â
â
000DH
CALCMODE
â
â
â
â
â
01B0H
CFHEADER
â
01B1H
CFRULE
â
0042H
CODEPAGE
â
â
â
â
â
007DH
COLINFO
â
â
â
â
0020H
COLUMNDEFAULT
â
0024H
COLWIDTH
â
003CH
CONTINUE
â
â
â
â
â
008CH
COUNTRY
â
â
â
â
005AH
CRN
â
â
â
â
0036H 0236H
DATATABLE
â
â
â
â
â
0037H
DATATABLE2
â
01BEH
DATAVALIDATION
â
01B2H
DATAVALIDATIONS
â
0022H
DATEMODE
â
â
â
â
â
00D7H
DBCELL
â
â
0051H
DCONREF
â
â
â
â
â
0025H 0225H
DEFAULTROWHEIGHT
â
â
â
â
â
0055H
DEFCOLWIDTH
â
â
â
â
â
0018H 0218H
DEFINEDNAME
â
â
â
â
â
0010H
DELTA
â
â
â
â
â
0000H 0200H
DIMENSION
â
â
â
â
â
0161H
DSF
â
000AH
EOF
â
â
â
â
â
01AEH
EXTERNALBOOK
â
0023H 0223H
EXTERNALNAME
â
â
â
â
â
0016H
EXTERNCOUNT
â
â
â
â
0017H
EXTERNSHEET
â
â
â
â
â
00FFH
EXTSST
â
002FH
FILEPASS
â
â
â
â
â
005BH
FILESHARING
â
â
â
â
124
5.2 Overview, Ordered by Record Names
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0031H 0231H
FONT
â
â
â
â
â
0032H
FONT2
â
0045H
FONTCOLOR
â
0015H
FOOTER
â
â
â
â
â
001EH 041EH
FORMAT
â
â
â
â
â
0*06H
FORMULA
â
â
â
â
â
00ABH
GCW
â
â
0082H
GRIDSET
â
â
â
â
0080H
GUTS
â
â
â
â
0083H
HCENTER
â
â
â
â
0014H
HEADER
â
â
â
â
â
008DH
HIDEOBJ
â
â
â
â
001BH
HORIZONTALPAGEBREAKS
â
â
â
â
â
01B8H
HYPERLINK
â
000BH 020BH
INDEX
â
â
â
â
â
0002H
INTEGER
â
0011H
ITERATION
â
â
â
â
â
0044H
IXFE
â
0004H 0204H
LABEL
â
â
â
â
â
015FH
LABELRANGES
â
00FDH
LABELSST
â
0026H
LEFTMARGIN
â
â
â
â
â
00E5H
MERGEDCELLS
â
00BEH
MULBLANK
â
â
00BDH
MULRK
â
â
001CH
NOTE
â
â
â
â
â
0003H 0203H
NUMBER
â
â
â
â
â
0063H
OBJECTPROTECT
â
â
â
â
00A1H
PAGESETUP
â
â
â
0092H
PALETTE
â
â
â
â
â
0041H
PANE
â
â
â
â
â
0013H
PASSWORD
â
â
â
â
â
00EFH
PHONETICPR
â
004DH
PLS
â
â
â
â
â
000EH
PRECISION
â
â
â
â
â
002BH
PRINTGRIDLINES
â
â
â
â
â
002AH
PRINTHEADERS
â
â
â
â
â
0012H
PROTECT
â
â
â
â
â
0800H
QUICKTIP
â
0868H
RANGEPROTECTION
â
000FH
REFMODE
â
â
â
â
â
0027H
RIGHTMARGIN
â
â
â
â
â
027EH
RK
â
â
â
â
0008H 0208H
ROW
â
â
â
â
â
125
5 Worksheet/Workbook Records
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
00D6H
RSTRING
â
â
005FH
SAVERECALC
â
â
â
â
00DDH
SCENPROTECT
â
â
00A0H
SCL
â
â
â
001DH
SELECTION
â
â
â
â
â
04BCH
SHAREDFMLA
â
â
0085H
SHEET
â
â
0862H
SHEETLAYOUT
â
0081H
SHEETPR
â
â
â
â
0867H
SHEETPROTECTION
â
0090H
SORT
â
â
00FCH
SST
â
0099H
STANDARDWIDTH
â
â
â
0007H 0207H
STRING
â
â
â
â
â
0293H
STYLE
â
â
â
â
0028H
TOPMARGIN
â
â
â
â
â
005EH
UNCALCED
â
â
â
â
0160H
USESELFS
â
0084H
VCENTER
â
â
â
â
001AH
VERTICALPAGEBREAKS
â
â
â
â
â
003DH
WINDOW1
â
â
â
â
â
003EH 023EH
WINDOW2
â
â
â
â
â
0019H
WINDOWPROTECT
â
â
â
â
â
005CH
WRITEACCESS
â
â
â
â
0086H
WRITEPROT
â
â
â
â
0059H
XCT
â
â
â
â
0*43H 00E0H
XF
â
â
â
â
â
126
5.3 Overview, Ordered by BIFF Versions
5.3 Overview, Ordered by BIFF Versions
5.3.1 New Records
⢠All Records in BIFF2
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0000H 0200H
DIMENSION
â
â
â
â
â
0001H 0201H
BLANK
â
â
â
â
â
0002H
INTEGER
â
0003H 0203H
NUMBER
â
â
â
â
â
0004H 0204H
LABEL
â
â
â
â
â
0005H 0205H
BOOLERR
â
â
â
â
â
0*06H
FORMULA
â
â
â
â
â
0007H 0207H
STRING
â
â
â
â
â
0008H 0208H
ROW
â
â
â
â
â
0*09H
BOF
â
â
â
â
â
000AH
EOF
â
â
â
â
â
000BH 020BH
INDEX
â
â
â
â
â
000CH
CALCCOUNT
â
â
â
â
â
000DH
CALCMODE
â
â
â
â
â
000EH
PRECISION
â
â
â
â
â
000FH
REFMODE
â
â
â
â
â
0010H
DELTA
â
â
â
â
â
0011H
ITERATION
â
â
â
â
â
0012H
PROTECT
â
â
â
â
â
0013H
PASSWORD
â
â
â
â
â
0014H
HEADER
â
â
â
â
â
0015H
FOOTER
â
â
â
â
â
0016H
EXTERNCOUNT
â
â
â
â
0017H
EXTERNSHEET
â
â
â
â
â
0018H 0218H
DEFINEDNAME
â
â
â
â
â
0019H
WINDOWPROTECT
â
â
â
â
â
001AH
VERTICALPAGEBREAKS
â
â
â
â
â
001BH
HORIZONTALPAGEBREAKS
â
â
â
â
â
001CH
NOTE
â
â
â
â
â
001DH
SELECTION
â
â
â
â
â
001EH 041EH
FORMAT
â
â
â
â
â
001FH 0056H
BUILTINFMTCOUNT
â
â
â
0020H
COLUMNDEFAULT
â
0021H 0221H
ARRAY
â
â
â
â
â
0022H
DATEMODE
â
â
â
â
â
0023H 0223H
EXTERNALNAME
â
â
â
â
â
0024H
COLWIDTH
â
127
5 Worksheet/Workbook Records
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0025H 0225H
DEFAULTROWHEIGHT
â
â
â
â
â
0026H
LEFTMARGIN
â
â
â
â
â
0027H
RIGHTMARGIN
â
â
â
â
â
0028H
TOPMARGIN
â
â
â
â
â
0029H
BOTTOMMARGIN
â
â
â
â
â
002AH
PRINTHEADERS
â
â
â
â
â
002BH
PRINTGRIDLINES
â
â
â
â
â
002FH
FILEPASS
â
â
â
â
â
0031H 0231H
FONT
â
â
â
â
â
0032H
FONT2
â
0036H 0236H
DATATABLE
â
â
â
â
â
0037H
DATATABLE2
â
003CH
CONTINUE
â
â
â
â
â
003DH
WINDOW1
â
â
â
â
â
003EH 023EH
WINDOW2
â
â
â
â
â
0040H
BACKUP
â
â
â
â
â
0041H
PANE
â
â
â
â
â
0042H
CODEPAGE
â
â
â
â
â
0*43H 00E0H
XF
â
â
â
â
â
0044H
IXFE
â
0045H
FONTCOLOR
â
004DH
PLS
â
â
â
â
â
0051H
DCONREF
â
â
â
â
â
0055H
DEFCOLWIDTH
â
â
â
â
â
⢠New Records in BIFF3
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0059H
XCT
â
â
â
â
005AH
CRN
â
â
â
â
005BH
FILESHARING
â
â
â
â
005CH
WRITEACCESS
â
â
â
â
005EH
UNCALCED
â
â
â
â
005FH
SAVERECALC
â
â
â
â
0063H
OBJECTPROTECT
â
â
â
â
007DH
COLINFO
â
â
â
â
027EH
RK
â
â
â
â
0080H
GUTS
â
â
â
â
0081H
SHEETPR
â
â
â
â
0082H
GRIDSET
â
â
â
â
0083H
HCENTER
â
â
â
â
0084H
VCENTER
â
â
â
â
0086H
WRITEPROT
â
â
â
â
008CH
COUNTRY
â
â
â
â
128
5.3 Overview, Ordered by BIFF Versions
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
008DH
HIDEOBJ
â
â
â
â
0092H
PALETTE
â
â
â
â
0293H
STYLE
â
â
â
â
⢠New Records in BIFF4
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0099H
STANDARDWIDTH
â
â
â
00A0H
SCL
â
â
â
00A1H
PAGESETUP
â
â
â
00ABH
GCW
â
â
⢠New Records in BIFF5
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0085H
SHEET
â
â
0090H
SORT
â
â
00BDH
MULRK
â
â
00BEH
MULBLANK
â
â
00D6H
RSTRING
â
â
00D7H
DBCELL
â
â
00DAH
BOOKBOOL
â
â
00DDH
SCENPROTECT
â
â
04BCH
SHAREDFMLA
â
â
⢠New Records in BIFF8
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
00E5H
MERGEDCELLS
â
00E9H
BITMAP
â
00EFH
PHONETICPR
â
00FCH
SST
â
00FDH
LABELSST
â
00FFH
EXTSST
â
015FH
LABELRANGES
â
0160H
USESELFS
â
0161H
DSF
â
01AEH
EXTERNALBOOK
â
01B0H
CFHEADER
â
01B1H
CFRULE
â
01B2H
DATAVALIDATIONS
â
01B8H
HYPERLINK
â
129
5 Worksheet/Workbook Records
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
01BEH
DATAVALIDATION
â
0800H
QUICKTIP
â
0862H
SHEETLAYOUT
â
0867H
SHEETPROTECTION
â
0868H
RANGEPROTECTION
â
130
5.3 Overview, Ordered by BIFF Versions
5.3.2 Deleted Records
⢠Records Deleted in BIFF3
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0002H
INTEGER
â
0020H
COLUMNDEFAULT
â
0024H
COLWIDTH
â
0032H
FONT2
â
0037H
DATATABLE2
â
0044H
IXFE
â
0045H
FONTCOLOR
â
⢠Records Deleted in BIFF5
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
001FH 0056H
BUILTINFMTCOUNT
â
â
â
⢠Records Deleted in BIFF8
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
0016H
EXTERNCOUNT
â
â
â
â
00ABH
GCW
â
â
131
5 Worksheet/Workbook Records
5.4 ARRAY
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0021H
0221H
0221H
0221H
0221H
This record stores the token array of an array formula. It is not a real cell record, but follows the first FORMULA record
(â5.50) of the array cell range. For more information about array formulas see â4.8.
Record ARRAY, BIFF2:
Offset
Size
Contents
0
6
The cell range address of the array formula (â2.5.14)
6
1
0 = Do not recalculate the array formula, 1 = Always recalculate array formula
7
var.
Token array of the array formula (â3)
Record ARRAY, BIFF3-BIFF4:
Offset
Size
Contents
0
6
The cell range address of the array formula (â2.5.14)
6
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Always recalculate array formula
1
0002H
1 = Calculate array formula on open
8
var.
Token array of the array formula (â3)
Record ARRAY, BIFF5-BIFF8:
Offset
Size
Contents
6
The cell range address of the array formula (â2.5.14). Column indexes are always 8-bit
0
values, also in BIFF8.
6
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Always recalculate array formula
1
0002H
1 = Calculate array formula on open
8
4
Not used
12
var.
Token array of the array formula (â3)
132
5.5 BACKUP
5.5 BACKUP
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0040H
0040H
0040H
0040H
0040H
This record contains a Boolean value determining whether Excel makes a backup of the file while saving.
Record BACKUP, BIFF2-BIFF8:
Offset
Size
Contents
0
2
1 = Create a backup on saving
5.6 BITMAP
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00E9H
This record is part of the Page Settings Block (â4.4). It stores the background bitmap of a worksheet.
Record BITMAP, BIFF8:
Offset
Size
Contents
0
2
Unknown value 0009H
2
2
Unknown value 0001H
4
4
Total size of the following record data, without this field (including CONTINUE records)
8
2
Unknown value 000CH
10
2
Unknown value 0000H
12
2
Width of the picture (width), in pixel
14
2
Height of the picture (height), in pixel
16
2
Number of planes, must be 0001H
18
2
Colour depth, must be 0018H (24 bit true-colour)
20
var.
Pixel data (array of height lines of the bitmap, from bottom line to top line, see below)
In each line all pixels are written from left to right. Each pixel is stored as 3-byte array: the red, green, and blue
component of the colour of the pixel, in this order. The size of each line is aligned to multiples of 4 by inserting zero
bytes after the last pixel.
Example of the bitmap data for a 3 Ă 3 image, each entry represents one byte. The three pixels of one line are
stored in 9 bytes, therefore each line is expanded to 12 bytes (next multiple of 4).
Offset
Contents
Remarks
20
R
G
B
R
G
B
R
G
B
0
0
0
Third (bottom) line of the bitmap
32
R
G
B
R
G
B
R
G
B
0
0
0
Second line of the bitmap
44
R
G
B
R
G
B
R
G
B
0
0
0
First (top) line of the bitmap
133
5 Worksheet/Workbook Records
5.7 BLANK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0001H
0201H
0201H
0201H
0201H
This record represents an empty cell. It contains the cell address and formatting information.
Record BLANK, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
Record BLANK, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
134
5.8 BOF â Beginning of File
5.8 BOF â Beginning of File
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0009H
0209H
0409H
0809H
0809H
The BOF record is the first record of any kind of stream or substream:
⢠The Worksheet Stream (â4.1.1) and the Chart Stream (â7.1.1)
⢠All substreams in the Workbook Stream (the Sheet Substream and the Workbook Globals Substream, â4.1.2, and the
Chart Substream, â7.1.2)
⢠The Workspace Stream.
A BOF record will never be encrypted, regardless of its type and position in the stream.
If a BIFF8 version of Excel (Excel 8.0 and newer) writes a BIFF5 workbook, it writes a wrong BIFF version in BOF
! records of the Sheet Substreams. Only the leading BOF record of the Workbook Globals Substream contains the
correct value and should be used to determine the BIFF version for the entire stream.
5.8.1 BOF Records Written by Excel
Record BOF, BIFF2 (record identifier is 0009H):
Offset
Size
Contents
0
2
BIFF version (not used)
2
2
Type of the following data:
0010H = Sheet
0020H = Chart
0040H = Macro sheet
Record BOF, BIFF3 (record identifier is 0209H) and BIFF4 (record identifier is 0409H):
Offset
Size
Contents
0
2
BIFF version (not used)
2
2
Type of the following data:
0010H = Sheet
0020H = Chart
0040H = Macro sheet
0100H = Workspace (BIFF3W/BIFF4W only)
4
2
Not used
Record BOF, BIFF5 (record identifier is 0809H):
Offset
Size
Contents
0
2
BIFF version (always 0500H for BIFF5). Should only be used, if this record is the leading
workbook globals BOF (see above).
2
2
Type of the following data:
0005H = Workbook globals
0006H = Visual Basic module
0010H = Sheet or dialogue (see SHEETPR, â5.97)
0020H = Chart
0040H = Macro sheet
0100H = Workspace (BIFF5W only)
4
2
Build identifier, must not be 0
6
2
Build year
135
5 Worksheet/Workbook Records
Record BOF, BIFF8 (record identifier is 0809H):
Offset
Size
Contents
0
2
BIFF version (always 0600H for BIFF8)
2
2
Type of the following data:
0005H = Workbook globals
0006H = Visual Basic module
0010H = Sheet or dialogue (see SHEETPR, â5.97)
0020H = Chart
0040H = Macro sheet
0100H = Workspace (BIFF8W only)
4
2
Build identifier, must not be 0
6
2
Build year, must not be 0
8
4
File history flags
12
4
Lowest Excel version that can read all records in this file
5.8.2 BOF Records Written by Other External Tools
Various external tools write non-standard BOF records with the record identifier 0809H (determining a BIFF5-BIFF8
BOF record), but with a different BIFF version field. In this case, the record identifier is ignored, and only the version
field is used to set the BIFF version of the workbook.
Record BOF (record identifier is 0809H):
Offset
Size
Contents
0
2
BIFF version:
0000H = BIFF5
0200H = BIFF2
0300H = BIFF3
0400H = BIFF4
0500H = BIFF5
0600H = BIFF8
2
2
Type of the following data:
0005H = Workbook globals
0006H = Visual Basic module
0010H = Sheet or dialogue (see SHEETPR, â5.97)
0020H = Chart
0040H = Macro sheet
0100H = Workspace
[4]
var.
(optional) Additional fields of a BOF record, should be ignored
136
5.9 BOOKBOOL
5.9 BOOKBOOL
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00DAH
00DAH
This record contains a Boolean value determining whether to save values linked from external workbooks (CRN records,
â5.23 and XCT records, â5.114). In BIFF3 and BIFF4 this option is stored in the SHEETPR record (â5.97). See
â4.10 for details about external references.
Record BOOKBOOL, BIFF5-BIFF8:
Offset
Size
Contents
0
2
0 = Save external linked values; 1 = Do not save external linked values
5.10 BOOLERR
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0005H
0205H
0205H
0205H
0205H
This record represents a Boolean value or error value cell.
Record BOOLERR, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
7
1
Boolean or error value (type depends on the following byte)
8
1
0 = Boolean value; 1 = Error code
Record BOOLERR, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
1
Boolean or error value (type depends on the following byte)
7
1
0 = Boolean value; 1 = Error code
If the value field is a Boolean value, it will contain 0 for FALSE and 1 for TRUE. See â2.5.6 for a list of error codes.
137
5 Worksheet/Workbook Records
5.11 BOTTOMMARGIN
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0029H
0029H
0029H
0029H
0029H
This record is part of the Page Settings Block (â4.4). It contains the bottom page margin of the current worksheet.
Record BOTTOMMARGIN, BIFF2-BIFF8:
Offset
Size
Contents
0
8
Bottom page margin in inches (IEEE 754 floating-point value, 64-bit double precision)
5.12 BUILTINFMTCOUNT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001FH
0056H
0056H
â
â
This record contains the number of following FORMAT records (â5.49) that contain built-in number formats. All
additional FORMAT records contain user-defined number formats. Note that the record identifier changes in BIFF3.
Record BUILTINFMTCOUNT, BIFF2-BIFF4:
Offset
Size
Contents
0
2
Number of following FORMAT records containing built-in number formats
138
5.13 CALCCOUNT
5.13 CALCCOUNT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000CH
000CH
000CH
000CH
000CH
This record is part of the Calculation Settings Block (â4.3). It specifies the maximum number of times the formulas
should be iteratively calculated. This is a fail-safe against mutually recursive formulas locking up a spreadsheet appli-
cation.
Record CALCCOUNT, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Maximum number of iterations allowed in circular references
5.14 CALCMODE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000DH
000DH
000DH
000DH
000DH
This record is part of the Calculation Settings Block (â4.3). It specifies whether to calculate formulas manually,
automatically or automatically except for multiple table operations.
Record CALCMODE, BIFF2-BIFF8:
Offset
Size
Contents
0
2
â1 = automatically except for multiple table operations
0 = manually
1 = automatically (default)
5.15 CFHEADER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01B0H
This record is part of the Conditional Formatting Table (â4.12). It contains a list of cell range addresses for all cells
with equal conditional formatting. It is followed by a list of CFRULE records (up to 3 records in BIFF8, â5.16) which
contain the conditions and cell formatting attributes.
Record CFHEADER, BIFF8:
Offset
Size
Contents
0
2
Number of following CFRULE records
2
2
1 = Conditionally formatted cells need recalculation or redraw
4
8
Cell range address of the range enclosing all conditionally formatted ranges (â2.5.14)
12
var.
Cell range address list of all conditionally formatted ranges (â2.5.15)
The record contains the cell range address list and the minimal cell range enclosing all the ranges from this list.
Example: This record describes the cells B9, G3:I8 and E15. The address of the cell range enclosing this list is
B3:I15.
139
5 Worksheet/Workbook Records
5.16 CFRULE â Conditional Formatting Rule
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01B1H
This record is part of the Conditional Formatting Table (â4.12). A list of CFRULE records is always following a
CFHEADER record (â5.15). Each CFRULE record contains a condition and the formatting attributes applied to the
cells specified in the CFHEADER record, if the condition is met.
There are some restrictions in the usage of conditional formattings:
⢠In the user interface of Microsoft Excel it is possible to modify the font style (boldness and posture), the text colour,
the underline style, and the strikeout style. It is not possible to change the used font, the font height, and the
escapement style, though it is possible to specify these attributes in this record which are correctly displayed by Excel.
⢠It is not possible to change a border line style, but to preserve the line colour, and vice versa. The user interface only
offers thin line styles, but files containing other line styles work correctly too. Diagonal lines are not supported at all,
but can be stored in this record.
⢠It is not possible to set the background pattern colour to âNo colourâ (using system window background colour) and
to preserve the pattern style of the cell. âNo colourâ will always set the pattern to transparent.
⢠Alignment and protection attributes can be stored, but are not supported at all.
⢠A changed number formatting cannot be stored in this record.
⢠Record Contents
Record CFRULE, BIFF8:
Offset
Size
Contents
0
1
Type of the conditional formatting:
01H = Compare with current cell value (the comparison specified below is used)
02H = Evaluate a formula (condition is met if formula evaluates to a value not equal to 0)
1
1
Comparison operator:
00H = No comparison (only valid for formula type, see above)
01H = Between
05H = Greater than
02H = Not between
06H = Less than
03H = Equal
07H = Greater or equal
04H = Not equal
08H = Less or equal
2
2
Size of the formula data for first value or formula (sz1)
4
2
Size of the formula data for second value or formula (sz2, used for second part of
âBetweenâ and âNot betweenâ comparison, this field is 0 for other comparisons)
6
4
Option flags (see below)
10
2
Not used
[12]
118
(optional, only if font = 1, see option flags) Font formatting block, see below
[var]
8
(optional, only if align = 1, see option flags) Alignment formatting block, see below
[var.]
8
(optional, only if bord = 1, see option flags) Border formatting block, see below
[var.]
4
(optional, only if patt = 1, see option flags) Pattern formatting block, see below
[var.]
2
(optional, only if prot = 1, see option flags) Protection formatting block, see below
var.
sz1
Formula data for first value or formula (RPN token array without size field, â3)
var.
sz2
Formula data for second value or formula (RPN token array without size field, â3)
140
5.16 CFRULE â Conditional Formatting Rule
⢠Option Flags
If none of the formatting attributes is set, the option flags field contains 00000000H. The following table assumes that
the conditional formatting contains at least one modified formatting attribute (there is at least one of the formatting
blocks in the record).
All flags describing a modified attribute contain the value 02, if the conditinal formatting changes the respective
! attribute, and 12, if the original cell formatting is preserved. The flags for modified font attributes are not contained
in this option flags field, but in the font formatting block itself.
Bit
Mask
Name
Contents
0
00000001H
a
lign
-
h
or
0 = Horizontal alignment modified
1
00000002H
a
lign
-
v
er
0 = Vertical alignment modified
2
00000004H
a
lign
-
w
rap
0 = Text wrapped flag modified
3
00000008H
a
lign
-
r
ot
0 = Text rotation modified
4
00000010H
a
lign
-
j
ustlast
0 = Justify last line flag modified
5
00000020H
a
lign
-
i
ndent
0 = Indentation modified
6
00000040H
a
lign
-
s
hrink
0 = Shrink to fit flag modified
7
00000080H
Always 12
8
00000100H
p
rot
-
l
ocked
0 = Cell locked flag modified
9
00000200H
p
rot
-
h
idden
0 = Cell hidden flag modified
10
00000400H
b
ord
-
l
eft
0 = Left border style and colour modified
11
00000800H
b
ord
-
r
ight
0 = Right border style and colour modified
12
00001000H
b
ord
-
t
op
0 = Top border style and colour modified
13
00002000H
b
ord
-
b
ot
0 = Bottom border style and colour modified
14
00004000H
b
ord
-
t
l-br
0 = Top-left to bottom-right border flag modified
15
00008000H
b
ord
-
b
l-tr
0 = Bottom-left to top-right border flag modified
16
00010000H
p
att
-
s
tyle
0 = Pattern style modified
17
00020000H
p
att
-
c
ol
0 = Pattern colour modified
18
00040000H
p
att
-
b
gcol
0 = Pattern background colour modified
21-19
00380000H
Always 1112
26
04000000H
font
1 = Record contains font formatting block
27
08000000H
align
1 = Record contains alignment formatting block
28
10000000H
bord
1 = Record contains border formatting block
29
20000000H
patt
1 = Record contains pattern formatting block
30
40000000H
prot
1 = Record contains protection formatting block
31
80000000H
a
lign
-
t
extdir
0 = Text direction modified
141
5 Worksheet/Workbook Records
⢠Font Formatting Block
Offset
Size
Contents
0
64
Font name (Unicode string, 8-bit string length, â2.5.3). The empty string (length 0)
preserves the font name of the current cell. The remaining bytes of this fixed-size block
(always 64 bytes) are not used.
64
4
Font height (in twips = 1/20 of a point); or â1 to preserve the cell font height
68
4
Font options:
Bit
Mask
Contents
1
00000002H Posture: 0 = Normal; 1 = Italic (only if f ont - s tyle = 0)
3
00000008H Outline: 0 = Off; 1 = On (only if f ont - o utline = 0)
4
00000010H Shadow: 0 = Off; 1 = On (only if f ont - s hadow = 0)
5
00000020H Condense: 0 = Off; 1 = On (only if fo
nt
-
co
nd
= 0)
7
00000080H Cancellation: 0 = Off; 1 = On (only if f ont - c anc = 0)
72
2
Font weight (100-1000, only if fo
nt
-
st
yle
= 0).
Standard values are 0190H (400) for normal text and 02BCH (700) for bold text.
74
2
Escapement type (only if fo
nt
-
es
c
= 0):
0 = None
1 = Superscript
2 = Subscript
76
1
Underline type (only if fo
nt
-
un
derl
= 0):
00H = None
01H = Single
21H = Single accounting
02H = Double
22H = Double accounting
77
3
Not used
80
4
Font colour index (â5.74); or â1 to preserve the cell font colour
84
4
Not used
88
4
Option flags for modified font attributes:
Bit
Mask
Name
Contents
1
00000002H f
ont
-
s
tyle
0 = Font style (posture/boldness) modified
3
00000008H f
ont
-
o
utline
0 = Font outline modified
4
00000010H f
ont
-
s
hadow
0 = Font shadow modified
5
00000020H f
ont
-
c
ond
0 = Font condense modified
7
00000080H f
ont
-
c
anc
0 = Font cancellation modified
92
4
0 = Escapement type modified, 1 = preserved (fo
nt
-
es
c
)
96
4
0 = Underline type modified, 1 = preserved (fo
nt
-
un
derl
)
100
4
Always 00000001H
104
4
Always 00000001H
108
8
Not used
116
2
Always 0001H
142
5.16 CFRULE â Conditional Formatting Rule
⢠Alignment Formatting Block
Offset
Size
Contents
0
1
Alignment and text break:
Bit
Mask
Contents
2-0
07H
Horizontal alignment (see XF_HOR_ALIGN constant list in XF
record â5.115, only if a
lign
-
h
or
= 0)
3
08H
Text wrapped: 0 = off; 1 = On (only if a
lign
-
w
rap
= 0)
6-4
70H
Vertical alignment (see XF_VERT_ALIGN constant list in XF
record â5.115, only if a
lign
-
v
er
= 0)
7
80H
Justify last line: 0 = off; 1 = On (only if a
lign
-
j
ustlast
= 0)
1
1
Text rotation angle (see XF_ROTATION constant list in XF record â5.115, only if
a
lign
-
r
ot
= 0)
2
2
Indentation, shrink to cell size, and text direction:
Bit
Mask
Contents
3-0
000FH
Indent level (only if al
ign
-
in
dent
= 0)
4
0010H
Shrink contents: 0 = off; 1 = On (only if al
ign
-
sh
rink
= 0)
7-6
00C0H
Text direction: 0 = According to context; 1 = Left-to-right; 2 =
Right-to-left (only if al
ign
-
te
xtdir
= 0)
4
2
Relative indentation (255 = absolute indentation, only if a
lign
-
i
ndent
= 0)
6
2
Not used
⢠Border Formatting Block
Offset
Size
Contents
0
4
Border line styles and colors:
Bit
Mask
Contents
3-0
0000000FH Left line style (only if bo
rd
-
le
ft
= 0, â2.5.11)
7-4
000000F0H Right line style (only if bo
rd
-
ri
ght
= 0, â2.5.11)
11-8
00000F00H Top line style (only if b ord - t op = 0, â2.5.11)
15-12
0000F000H Bottom line style (only if b ord - b ot = 0, â2.5.11)
22-16
007F0000H Colour index (â5.74) for left line (only if bo
rd
-
le
ft
= 0)
29-23
3F800000H Colour index (â5.74) for right line (only if bo
rd
-
ri
ght
= 0)
30
40000000H Top-left to bottom-right line on/off (only if b ord - t l-br = 0)
31
80000000H Bottom-left to top-right line on/off (only if b ord - b l-tr = 0)
4
4
Bit
Mask
Contents
6-0
0000007FH Colour index (â5.74) for top line (only if b ord - t op = 0)
13-7
00003F80H Colour index (â5.74) for bottom line (only if bo
rd
-
bo
t
= 0)
20-14
001FC000H Colour index (â5.74) for diagonal line colour (only if
b
ord
-
t
l-br
= 0 or if bo
rd
-
bl
-tr
= 0)
24-21
01E00000H Diagonal line style (only if b ord - t l-br = 0 or if
b
ord
-
b
l-tr
= 0, â2.5.11)
143
5 Worksheet/Workbook Records
⢠Pattern Formatting Block
Offset
Size
Contents
0
2
Fill pattern style:
Bit
Mask
Contents
15-10
FC00H
Fill pattern style (only if p
att
-
s
tyle
= 0, â2.5.12)
2
2
Fill pattern colour indexes:
Bit
Mask
Contents
6-0
007FH
Colour index (â5.74) for pattern (only if p
att
-
c
ol
= 0)
13-7
3F80H
Colour index (â5.74) for pattern background (only if
pa
tt
-
bg
col
= 0)
⢠Protection Formatting Block
Offset
Size
Contents
0
2
Protection flags:
Bit
Mask
Contents
0
01H
Cell locked on/off (only if p
rot
-
l
ocked
= 0)
1
02H
Formula hidden on/off (only if pr
ot
-
hi
dden
= 0)
144
5.17 CODEPAGE
5.17 CODEPAGE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0042H
0042H
0042H
0042H
0042H
This record stores the text encoding used to write byte strings, stored as MS Windows code page identifier.
The CODEPAGE record in BIFF8 always contains the code page 1200 (UTF-16, â2.5.3). Therefore it is not
! possible to obtain the encoding used for a protection password (it is not UTF-16).
Record CODEPAGE, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Code page identifier used for byte string text encoding21:
016FH =
367 = ASCII
01B5H =
437 = IBM PC CP-437 (US)
02D0H =
720 = IBM PC CP-720 (OEM Arabic)
02E1H =
737 = IBM PC CP-737 (Greek)
0307H =
775 = IBM PC CP-775 (Baltic)
0352H =
850 = IBM PC CP-850 (Latin I)
0354H =
852 = IBM PC CP-852 (Latin II (Central European))
0357H =
855 = IBM PC CP-855 (Cyrillic)
0359H =
857 = IBM PC CP-857 (Turkish)
035AH =
858 = IBM PC CP-858 (Multilingual Latin I with Euro)
035CH =
860 = IBM PC CP-860 (Portuguese)
035DH =
861 = IBM PC CP-861 (Icelandic)
035EH =
862 = IBM PC CP-862 (Hebrew)
035FH =
863 = IBM PC CP-863 (Canadian (French))
0360H =
864 = IBM PC CP-864 (Arabic)
0361H =
865 = IBM PC CP-865 (Nordic)
0362H =
866 = IBM PC CP-866 (Cyrillic (Russian))
0365H =
869 = IBM PC CP-869 (Greek (Modern))
036AH =
874 = Windows CP-874 (Thai)
03A4H =
932 = Windows CP-932 (Japanese Shift-JIS)
03A8H =
936 = Windows CP-936 (Chinese Simplified GBK)
03B5H =
949 = Windows CP-949 (Korean (Wansung))
03B6H =
950 = Windows CP-950 (Chinese Traditional BIG5)
04B0H = 1200 = UTF-16 (BIFF8)
04E2H = 1250 = Windows CP-1250 (Latin II) (Central European)
04E3H = 1251 = Windows CP-1251 (Cyrillic)
04E4H = 1252 = Windows CP-1252 (Latin I) (BIFF4-BIFF5)
04E5H = 1253 = Windows CP-1253 (Greek)
04E6H = 1254 = Windows CP-1254 (Turkish)
04E7H = 1255 = Windows CP-1255 (Hebrew)
04E8H = 1256 = Windows CP-1256 (Arabic)
04E9H = 1257 = Windows CP-1257 (Baltic)
04EAH = 1258 = Windows CP-1258 (Vietnamese)
0551H = 1361 = Windows CP-1361 (Korean (Johab))
2710H = 10000 = Apple Roman
8000H = 32768 = Apple Roman
8001H = 32769 = Windows CP-1252 (Latin I) (BIFF2-BIFF3)
21 For more information see http://en.wikipedia.org/wiki/Character_encoding.
145
5 Worksheet/Workbook Records
5.18 COLINFO
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
007DH
007DH
007DH
007DH
This record specifies the width and default cell formatting for a given range of columns.
In BIFF3, if a COLINFO record is missing for a column, the width specified in the record DEFCOLWIDTH (â5.32) is
used instead.
In BIFF4-BIFF5, the width set in this record is only used, if the corresponding bit for this column is cleared in the GCW
record (â5.51), otherwise the column width set in the DEFCOLWIDTH record (â5.32) is used (the STANDARD-
WIDTH record (â5.101) is always ignored in this case).
In BIFF8, if a COLINFO record is missing for a column, the width specified in the record STANDARDWIDTH
(â5.101) is used. If this record is also missing, the column width of the record DEFCOLWIDTH (â5.32) is used
instead.
This record also specifies a default XF record (â5.115) to use for cells in the columns that are not described by any cell
record (which contain the XF index for that cell). Additionally, the option flags field contains hidden, outline, and
collapsed options applied at the columns.
In BIFF2, the column width is stored in the record COLWIDTH (â5.20) and default column formatting in the record
COLUMNDEFAULT (â5.19).
Record COLINFO, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index to first column in the range
2
2
Index to last column in the range
4
2
Width of the columns in 1/256 of the width of the zero character, using default font (first
FONT record in the file)
6
2
Index to XF record (â5.115) for default column formatting
8
2
Option flags:
Bits
Mask
Contents
0
0001H
1 = Columns are hidden
10-8
0700H
Outline level of the columns (0 = no outline)
12
1000H
1 = Columns are collapsed
10
2
Not used
146
5.19 COLUMNDEFAULT
5.19 COLUMNDEFAULT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0020H
â
â
â
â
This record contains default formatting attributes for a given range of columns. The formatting attributes are stored
separate for each column in the given range. From BIFF3 on the record COLINFO (â5.18) is used to specify default
column formatting.
Record COLUMNDEFAULT, BIFF2:
Offset
Size
Contents
0
2
Index to first column referred in this record (fc)
2
2
Index to last column referred in this record (lc)
4
3ânc
List of nc=lc-fc+1 cell attribute structures (3 bytes each, â2.5.13)
4+3ânc
2
Not used
5.20 COLWIDTH
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0024H
â
â
â
â
This record specifies the width for a given range of columns. If a column does not have a corresponding COLWIDTH
record, the width specified by the record DEFCOLWIDTH (â5.32) is used instead. From BIFF3 on the record
COLINFO (â5.18) is used to specify the column width.
Offset
Size
Contents
0
1
Index to first column
1
1
Index to last column
2
2
Width of the columns in 1/256 of the width of the zero character, using default font (first
FONT record in the file)
147
5 Worksheet/Workbook Records
5.21 CONTINUE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
003CH
003CH
003CH
003CH
003CH
Whenever the content of a record exceeds the given limits (see table), the record must be split. Several CONTINUE
records containing the additional data are added after the parent record.
BIFF version
Maximum data size of a record
BIFF2-BIFF5
2080 bytes (2084 bytes including record header)
BIFF8
8224 bytes (8228 bytes including record header)
Record CONTINUE, BIFF2-BIFF8:
Offset
Size
Contents
0
var.
Data continuation of the previous record
Unicode strings are split in a special way. At the beginning of each CONTINUE record the option flags byte is repeated.
Only the character size flag will be set in this flags byte, the Rich-Text flag and the Far-East flag are set to zero.
In each CONTINUE record it is possible that the character size changes from 8-bit characters to 16-bit characters
! and vice versa.
Never a Unicode string is split until and including the first character. That means, all header fields (string length,
! option flags, optional Rich-Text size, and optional Far-East data size) and the first character of the string have to
occur together in the leading record, or have to be moved completely into the CONTINUE record.
Formatting runs (â2.5.1) cannot be split between their components (character index and FONT record index). If a
! string is split between two formatting runs, the option flags field will not be repeated in the CONTINUE record.
Example: The remaining size of a record may be 10 bytes (it has 8214 bytes of data). Now the string âABCDE-
GHΊIâ has to be stored in this record. âΊâ is the capital Greek character Omega with the Unicode character code
03A9H.
Note: The records are shown with their headers to make the example clearer.
Offset
Size
Contents
Description
0
2
Any record identifier
2
2
2020H (8224)
Record data size
4
8214
Any data
8218
2
000AH (10)
Unicode string character count
8220
1
00H
Unicode string option flags (8-bit characters)
8221
7
41H 42H ⌠47H
8-bit character array âABCDEFGâ
8228
2
003CH
Record identifier CONTINUE
8230
2
0007H (7)
Record data size
8232
1
01H
Unicode string option flags (16-bit characters)
8233
2
0048H
16-bit character âHâ
8235
2
03A9H
16-bit character âΊâ
8237
2
0049H
16-bit character âIâ
148
5.22 COUNTRY
5.22 COUNTRY
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
008CH
008CH
008CH
008CH
This record stores two Windows country identifiers. The first represents the user interface language of the Excel version
that has saved the file, and the second represents the system regional settings at the time the file was saved.
Record COUNTRY, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Windows country identifier of the user interface language of Excel
2
2
Windows country identifier of the system regional settings
The following table shows most of the used country identifiers. Most of these identifiers are equal to the international
country calling codes22.2324252627282930
ID Country
ID Country
ID Country
ID Country
ID Country
ID Country
1
USA23
66
Thailand
240
Equatorial Guinea26
350
Gibraltar26
506
Costa Rica
692
Marshall Islands26
2
Canada24
81
Japan
241
Gabon26
351
Portugal
507
Panama
850
North Korea26
7
Russia25
82
South Korea
242
Congo26
352
Luxembourg
508
St. Pierre26
852
Hong Kong S.A.R.
20
Egypt
84
Viet Nam
243
Zaire27
353
Ireland
509
Haiti26
853
Macao S.A.R.
27
South Africa
86
PR China
244
Angola26
354
Iceland
590
Guadeloupe26
855
Cambodia26
30
Greece
90
Turkey
245
Guinea-Bissau26
355
Albania
591
Bolivia
856
Laos26
31
Netherlands
91
India
246
Diego Garcia26
356
Malta26
592
Guyana26
880
Bangladesh26
32
Belgium
92
Pakistan
247
Ascension Island26
357
Cyprus26
593
Ecuador
886
Taiwan
33
France
93
Afghanistan26
248
Seychelles26
358
Finland
594
French Guiana26
960
Maldives
34
Spain
94
Sri Lanka26
249
Sudan26
359
Bulgaria
595
Paraguay
961
Lebanon
36
Hungary
95
Burma (Myanmar)26
250
Rwanda26
370
Lithuania
596
Martinique26
962
Jordan
39
Italy
212
Morocco
251
Ethiopia26
371
Latvia
597
Suriname26
963
Syria
40
Romania
213
Algeria
252
Somalia26
372
Estonia
598
Uruguay
964
Iraq
41
Switzerland
216
Tunisia
253
Djibouti26
373
Moldova26
599
Netherlands Antilles26
965
Kuwait
43
Austria
218
Libya
254
Kenya
374
Armenia
670
East Timor26
966
Saudi Arabia
44
United Kingdom
220
Gambia26
255
Tanzania26
375
Belarus30
672
Antarctica26
967
Yemen
45
Denmark
221
Senegal27
256
Uganda26
376
Andorra26
673
Brunei Darussalam
968
Oman
46
Sweden
222
Mauritania26
257
Burundi26
377
Monaco
674
Narupu26
970
Palestine26
47
Norway
223
Mali27
258
Mozambique26
378
San Marino26
675
Papua New Guinea26
971
U.A.E.
48
Poland
224
Guinea26
259
Zanzibar26
379
Vatican City26
676
Tonga26
972
Israel
49
Germany
225
CĂ´te d'Ivoire27
260
Zambia26
380
Ukraine
677
Solomon Islands26
973
Bahrain
51
Peru
226
Burkina Farso26
261
Madagascar26
381
Serbia
678
Vanuatu26
974
Qatar
52
Mexico
227
Niger26
262
Reunion Island27
385
Croatia
679
Fiji26
975
Bhutan26
53
Cuba26
228
Togo26
263
Zimbabwe
386
Slovenia
680
Palau26
976
Mongolia
54
Argentinia
229
Benin26
264
Namibia26
387
Bosnia, Herzegovina26
681
Wallis and Futuna26
977
Nepal26
55
Brazil
230
Mauritius26
265
Malawi26
389
Macedonia
682
Cook Islands26
981
Iran29
56
Chile
231
Liberia26
266
Lesotho26
420
Czech
683
Niue Island26
992
Tajikistan30
57
Colombia
232
Sierra Leone26
267
Botswana26
421
Slovak
684
American Samoa26
993
Turkmenistan26
58
Venezuela
233
Ghana26
268
Swaziland26
423
Liechtenstein28
685
Western Samoa26
994
Azerbaijan
60
Malaysia
234
Nigeria26
269
Comoros, Mayotte26
500
Falkland Islands26
686
Kiribati26
995
Georgia
61
Australia
235
Chad26
290
St. Helena26
501
Belize
687
New Caledonia26
996
Kyrgyzstan
62
Indonesia
236
Central African Rep.26
291
Eritrea26
502
Guatemala
688
Tuvalu26
998
Uzbekistan30
63
Philippines
237
Cameroon27
297
Aruba26
503
El Salvador
689
French Polynesia26
64
New Zealand
238
Cape Verde26
298
Faeroe Islands
504
Honduras
690
Tokelau26
65
Singapore
239
Sao Tome26
299
Green Island26
505
Nicaragua
691
Micronesia26
22 Source: http://en.wikipedia.org/wiki/List_of_country_calling_codes
23 Including the countries of the North America Numbering Plan (NANP), e.g. Bahamas, Dominican Republic, Jamaica, Puerto Rico.
24 Real country calling code of Canada is 1.
25 Including Kazakhstan and Tatarstan.
26 Not used in Windows.
27 Windows uses France (33) instead.
28 Windows uses Switzerland (41) instead.
29 Real country calling code of Iran is 98.
30 Windows uses Russia (7) instead.
149
5 Worksheet/Workbook Records
5.23 CRN
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
005AH
005AH
005AH
005AH
This record stores the contents of an external cell or cell range. An external cell range has one row only. If a cell range
spans over more than one row, several CRN records will be created. See â4.10 for details about external references.
Record CRN, BIFF3-BIFF8:
Offset
Size
Contents
0
1
Index to last column inside of the referenced sheet (lc)
1
1
Index to first column inside of the referenced sheet (fc)
2
2
Index to row inside of the referenced sheet
4
var.
List of lc-fc+1 constant values (â2.5.7)
150
5.24 DATATABLE â Multiple Operation Table
5.24 DATATABLE â Multiple Operation Table
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0036H
0236H
0236H
0236H
0236H
This record stores information about a multiple operation table in the sheet. It follows the first FORMULA record
(â5.50) of the cell range containing the operation table. For more information about multiple operations see â4.9.
In BIFF2, a multiple operation with two data source ranges is stored in the DATATABLE2 record, see â5.25. From
BIFF3 on, the DATATABLE record is able to represent this kind of multiple operation too.
Record DATATABLE, BIFF2:
Offset
Size
Contents
0
6
Cell range address of the multiple operation table range (â2.5.14)
6
1
0 = Do not recalculate the table, 1 = Always recalculate the table
7
1
0 = Input data is in the column left of the table, formulas are in the row above the table
1 = Input data is in the row above the table, formulas are in the column left of the table
8
2
Row index of the input cell
10
2
Column index of the input cell
Record DATATABLE, BIFF3-BIFF8:
Offset
Size
Contents
0
6
Cell range address of the multiple operation table range (â2.5.14). Column indexes are
always 8-bit values, also in BIFF8.
6
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Always recalculate array formula
1
0002H
1 = Calculate array formula on open
2
0004H
0 = Input data is in the column left of the table, formulas are in the
row above the table
1 = Input data is in the row above the table, formulas are in the
column left of the table
3
0008H
1 = Table uses row and column input data (2-dimensional mode)
4
0010H
1 = First input cell has been deleted (BIFF8 only)
5
0020H
1 = Second input cell has been deleted (BIFF8 only)
8
2
Row index of first input cell (in 2D mode, this is the ârow input cellâ)
10
2
Column index of first input cell (in 2D mode, this is the ârow input cellâ)
12
2
Row index of second input cell (2D mode only, for the âcolumn input cellâ)
14
2
Column index of second input cell (2D mode only, for the âcolumn input cellâ)
151
5 Worksheet/Workbook Records
5.25 DATATABLE2 â Multiple Operation Table
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0037H
â
â
â
â
In BIFF2 this record stores information about a multiple operation table in a sheet using two independent input ranges.
It follows the first FORMULA record (â5.50) of the cell range containing the operation table. For more information
about multiple operations see â4.9. From BIFF3 on, the DATATABLE record (â5.24) contains this kind of multiple
operation too.
Record DATATABLE2, BIFF2:
Offset
Size
Contents
0
6
Cell range address of the multiple operation table range (â2.5.14)
6
1
0 = Do not recalculate the table, 1 = Always recalculate the table
7
1
Not used
8
2
Row index of first input cell (ârow input cellâ)
10
2
Column index of first input cell (ârow input cellâ)
12
2
Row index of second input cell (âcolumn input cellâ)
14
2
Column index of second input cell (âcolumn input cellâ)
152
5.26 DATAVALIDATION
5.26 DATAVALIDATION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01BEH
This record is part of the Data Validity Table (â4.14). It stores data validity settings and a list of cell ranges which
contain these settings. The âprompt boxâ appears while editing such a cell. The âerror boxâ appears, if the entered value
does not fit the conditions. The data validity settings of a sheet are stored in a list of DATAVALIDATION records
which is preceded by a DATAVALIDATIONS record (â5.27). If a string is empty and the default text should appear in
the prompt box or error box, the string must contain a single zero character (string length will be 1).
Record DATAVALIDATION, BIFF8:
Offset
Size
Contents
0
4
Option flags (see below)
4
var.
Title of the prompt box (Unicode string, 16-bit string length, â2.5.3)
var.
var.
Title of the error box (Unicode string, 16-bit string length, â2.5.3)
var.
var.
Text of the prompt box (Unicode string, 16-bit string length, â2.5.3)
var.
var.
Text of the error box (Unicode string, 16-bit string length, â2.5.3)
var.
2
Size of the formula data for first condition (sz1)
var.
2
Not used
var.
sz1
Formula data for first condition (RPN token array without size field, â3)
var.
2
Size of the formula data for second condition (sz2)
var.
2
Not used
var.
sz2
Formula data for second condition (RPN token array without size field, â3)
var.
var.
Cell range address list with all affected ranges (â2.5.15)
Option flags field:
Bit
Mask
Contents
3-0
0000000FH
Data type:
00H = Any value
04H = Date
01H = Integer values
05H = Time
02H = Decimal values
06H = Text length
03H = User defined list
07H = Formula
6-4
00000070H
Error style:
00H = Stop
01H = Warning
02H = Info
7
00000080H
1 = In list type validity the string list is explicitly given in the formula
8
00000100H
1 = Empty cells allowed
9
00000200H
1 = Suppress the drop down arrow in list type validity
18
00040000H
1 = Show prompt box if cell selected
19
00080000H
1 = Show error box if invalid values entered
23-20
00F00000H
Condition operator:
00H = Between
04H = Greater than
01H = Not between
05H = Less than
02H = Equal
06H = Greater or equal
03H = Not equal
07H = Less or equal
In list type validity it is possible to enter an explicit string list. This string list is stored as tStr token (â3.8.2). The string
items are separated by zero characters. There is no zero character at the end of the string list.
Example for a string list with the 3 strings A, B, and C: âA<00H>B<00H>Câ (contained in a tStr token, string
length is 5).
153
5 Worksheet/Workbook Records
5.27 DATAVALIDATIONS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01B2H
This record is the list header of the Data Validity Table (â4.14) in the current sheet.
Record DATAVALIDATIONS, BIFF8:
Offset
Size
Contents
0
2
Option flags:
Bit
Mask
Contents
0
0001H
0 = Prompt box not visible
1 = Prompt box currently visible
1
0002H
0 = Prompt box has fixed
1 = Prompt box appears at cell
position
2
0004H
1 = Cell validity data cached in following DATAVALIDATION
records
2
4
Horizontal position of the prompt box, if it has fixed position, in pixel
6
4
Vertical position of the prompt box, if it has fixed position, in pixel
10
4
Object identifier of the drop down arrow object for a list box (â6), if a list box is visible at
the current cursor position, FFFFFFFFH otherwise
14
4
Number of following DATAVALIDATION records (â5.26)
5.28 DATEMODE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0022H
0022H
0022H
0022H
0022H
This record specifies the base date for displaying date values. All dates are stored as count of days past this base date. In
BIFF2-BIFF4 this record is part of the Calculation Settings Block (â4.3). In BIFF5-BIFF8 it is stored in the Workbook
Globals Substream.
Record DATEMODE, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Base date is 1899-Dec-31 (the cell value 1 represents 1900-Jan-01)
1 = Base date is 1904-Jan-01 (the cell value 1 represents 1904-Jan-02)
154
5.29 DBCELL
5.29 DBCELL
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00D7H
00D7H
This record is written once in a Row Block. It contains relative offsets to calculate the stream position of the first cell
record for each row. The offset list in this record contains as many offsets as ROW records are present in the Row Block.
For details about calculation of cell record positions see â4.7.
Record DBCELL, BIFF5-BIFF8:
Offset
Size
Contents
0
4
Relative offset to first ROW record in the Row Block (difference between record position
of this record and the ROW record; positive offset for an earlier stream position)
4
2ânm
Array of nm relative offsets (16-bit values) to calculate stream position of the first cell
record for the respective row (â4.7.2). nm is the number of ROW records in this Row
Block
5.30 DCONREF â Data Consolidation Reference
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0051H
0051H
0051H
0051H
0051H
2do
155
5 Worksheet/Workbook Records
5.31 DEFAULTROWHEIGHT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0025H
0225H
0225H
0225H
0225H
This record specifies the default height and default flags for rows that do not have a corresponding ROW record
(â5.88).
Record DEFAULTROWHEIGHT, BIFF2:
Offset
Size
Contents
0
2
Default height for unused rows, in twips = 1/20 of a point
Bit
Mask
Contents
0-14
7FFFH
Default height for unused rows, in twips = 1/20 of a point
15
8000H
1 = Row height not changed manually
Record DEFAULTROWHEIGHT, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Row height and default font height do not match
1
0002H
1 = Row is hidden
2
0004H
1 = Additional space above the row
3
0008H
1 = Additional space below the row
2
2
Default height for unused rows, in twips = 1/20 of a point
5.32 DEFCOLWIDTH
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0055H
0055H
0055H
0055H
0055H
This record specifies the default column width for columns that do not have a specific width set using the records
COLWIDTH (BIFF2, â5.20), COLINFO (BIFF3-BIFF8, â5.18), or STANDARDWIDTH (â5.101).
Record DEFCOLWIDTH, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Column width in characters, using the width of the zero character from default font (first
FONT record in the file). Excel adds some extra space to the default width, depending on
the default font and default font size. The algorithm how to exactly calculate the resulting
column width is not known.
Example: The default width of 8 set in this record results in a column width of
8.43 using Arial font with a size of 10 points.
156
5.33 DEFINEDNAME
5.33 DEFINEDNAME
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0018H
0218H
0218H
0018H
0018H
This record is part of a Link Table (â4.10). It contains the name and the token array of an internal defined name. Token
arrays of defined names contain tokens with aberrant token classes (â3.2).
Record DEFINEDNAME, BIFF2:
Offset
Size
Contents
0
1
Option flags:
Bit
Mask
Contents
1
02H
1 = Function macro or command macro
2
04H
1 = Complex function (array formula or user defined)
1
1
If name is function macro or command macro (see option flags above):
01H = Function macro, 02H = Command macro
2
1
Keyboard shortcut (only for command macro names)
3
1
Length of the name (character count, ln)
4
1
Size of the formula data (sz)
5
ln
Character array of the name
5+ln
sz
Formula data (RPN token array without size field, â3)
5+ln+sz
1
Duplicate of the formula data size field (sz)
Record DEFINEDNAME, BIFF3-BIFF4:
Offset
Size
Contents
0
2
Option flags, see below
2
1
Keyboard shortcut (only for command macro names, see below)
3
1
Length of the name (character count, ln)
4
2
Size of the formula data (sz)
6
ln
Character array of the name
6+ln
sz
Formula data (RPN token array without size field, â3)
157
5 Worksheet/Workbook Records
Record DEFINEDNAME, BIFF5:
Offset
Size
Contents
0
2
Option flags, see below
2
1
Keyboard shortcut (only for command macro names, see below)
3
1
Length of the name (character count, ln)
4
2
Size of the formula data (sz)
6
2
0 = Global name, otherwise index to EXTERNSHEET record (one-based)
8
2
0 = Global name, otherwise index to sheet (one-based)
10
1
Length of menu text (character count, lm)
11
1
Length of description text (character count, ld)
12
1
Length of help topic text (character count, lh)
13
1
Length of status bar text (character count, ls)
14
ln
Character array of the name
14+ln
sz
Formula data (RPN token array without size field, â3)
14+ln+sz
lm
Character array of menu text
var.
ld
Character array of description text
var.
lh
Character array of help topic text
var.
ls
Character array of status bar text
Record DEFINEDNAME, BIFF8:
Offset
Size
Contents
0
2
Option flags, see below
2
1
Keyboard shortcut (only for command macro names, see below)
3
1
Length of the name (character count, ln)
4
2
Size of the formula data (sz)
6
2
Not used
8
2
0 = Global name, otherwise index to sheet (one-based)
10
1
Length of menu text (character count, lm)
11
1
Length of description text (character count, ld)
12
1
Length of help topic text (character count, lh)
13
1
Length of status bar text (character count, ls)
14
var.
Name (Unicode string without length field, â2.5.3)
var.
sz
Formula data (RPN token array without size field, â3)
[var.]
var.
(optional, only if lm > 0) Menu text (Unicode string without length field, â2.5.3)
[var.]
var.
(optional, only if ld > 0) Description text (Unicode string without length field, â2.5.3)
[var.]
var.
(optional, only if lh > 0) Help topic text (Unicode string without length field, â2.5.3)
[var.]
var.
(optional, only if ls > 0) Status bar text (Unicode string without length field, â2.5.3)
158
5.33 DEFINEDNAME
⢠Option Flags
Bit
Mask
Flag name
Contents
0
0001H
hidden
0 = Visible
1 = Hidden
1
0002H
func
0 = Command macro
1 = Function macro
2
0004H
vbasic
0 = Sheet macro
1 = VisualBasic macro
3
0008H
macro
0 = Standard name
1 = Macro name (see below)
4
0010H
complex
0 = Simple formula
1 = Complex formula (array
formula or user defined)
5
0020H
builtin
0 = User-defined name
1 = Built-in name (see below)
11-6
0FC0H
funcgroup
Function group (BIFF4-BIFF8), only if macro = 1, must be >0 then
1 = Financial
8 = Logical
2 = Date & Time
9 = Information
3 = Math & Trig
10 = Commands
4 = Statistical
11 = Customizing
5 = Lookup & Reference
12 = Macro Control
6 = Database
13 = DDE/External
7 = Text
14 = User Defined
12
1000H
binary
0 = Formula definition
1 = Binary data (BIFF5-BIFF8)
⢠Macro Names
If the macro flag in the option flags field is set to 1 (see above), the defined name specifies a macro function or
procedure. The type of the macro is specified by the flags func, vbasic, and funcgroup (all these flags must be 0,
if the defined name is not a macro).
Command macros (macro = 1, func = 0) are shown in the âSelect Macroâ dialog of Excel. Function macros
(macro = 1, func = 1) are shown in the âInsert Functionâ dialog of Excel. They will be inserted into the function
group specified by funcgroup. If the flag vbasic is set, the name refers to a macro in the VisualBasic project,
otherwise to a sheet macro.
⢠Built-In Names
In BIFF2, the built-in names are written with their full name and differ in localised versions of Excel. From BIFF3 on
only an index to a built-in names is stored. If the builtin flag of the option flags field is set (see above), the name
string contains only one character with the following meaning:
Character Built-in name
Character Built-in name
<00H>
Consolidate_Area
<07H>
Pint_Titles
<01H>
Auto_Open
<08H>
Recorder
<02H>
Auto_Close
<09H>
Data_Form
<03H>
Extract
<0AH>
Auto_Activate (BIFF5-BIFF8)
<04H>
Database
<0BH>
Auto_Deactivate (BIFF5-BIFF8)
<05H>
Criteria
<0CH>
Sheet_Title (BIFF5-BIFF8)
<06H>
Print_Area
<0DH>
_FilterDatabase (BIFF8)
In BIFF5, the name â_FilterDatabaseâ (used to define filtered cell ranges) occurs as full name, not with its index.
! The builtin flag of the option flags field is not set for this name.
159
5 Worksheet/Workbook Records
5.34 DELTA
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0010H
0010H
0010H
0010H
0010H
This record is part of the Calculation Settings Block (â4.3). It stores the maximum change of the result to exit an
iteration.
Record DELTA, BIFF2-BIFF8:
Offset
Size
Contents
0
8
Maximum change in iteration (IEEE 754 floating-point value, 64-bit double precision)
5.35 DIMENSION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0000H
0200H
0200H
0200H
0200H
This record contains the range address of the used area in the current sheet.
Record DIMENSION, BIFF2:
Offset
Size
Contents
0
2
Index to first used row
2
2
Index to last used row, increased by 1
4
2
Index to first used column
6
2
Index to last used column, increased by 1
Record DIMENSION, BIFF3-BIFF5:
Offset
Size
Contents
0
2
Index to first used row
2
2
Index to last used row, increased by 1
4
2
Index to first used column
6
2
Index to last used column, increased by 1
8
2
Not used
Record DIMENSION, BIFF8:
Offset
Size
Contents
0
4
Index to first used row
4
4
Index to last used row, increased by 1
8
2
Index to first used column
10
2
Index to last used column, increased by 1
12
2
Not used
160
5.36 DSF â Double Stream File
5.36 DSF â Double Stream File
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0161H
This record specifies if the BIFF8 workbook document contains an additional BIFF5 Workbook Stream with the name
âBookâ (â2.3.3).
Record DSF, BIFF8:
Offset
Size
Contents
0
2
0 = Only the BIFF8 âWorkbookâ stream is present
1 = Additional BIFF5 âBookâ stream is in the file
A double stream file can be read by Excel 5.0 and Excel 7.0, and still contains all new features added to BIFF8 (which
are left out in the BIFF5 âBookâ stream).
5.37 EOF â End of File
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000AH
000AH
000AH
000AH
000AH
This record has no content. It indicates the end of a record block with leading BOF record (â5.8). This could be the end
of the workbook globals, a worksheet, a chart, etc.
161
5 Worksheet/Workbook Records
5.38 EXTERNALBOOK â External Workbook
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01AEH
This record mainly stores the URL of an external document and a list of sheet names inside this document. Furthermore
it is used to store DDE and OLE links, or to indicate an internal 3D reference or an add-in function. See â4.10.3 for
details about external references in BIFF8.
5.38.1 External References
An EXTERNALBOOK record for external references stores the URL and a list of sheet names.
Record EXTERNALBOOK for external references, BIFF8:
Offset
Size
Contents
0
2
Number of sheet names (nm)
2
var.
Encoded URL without sheet name (â2.5.9). Unicode string, 16-bit string length (â2.5.3).
var.
var.
List of nm sheet names (Unicode strings with 16-bit string length, â2.5.3)
5.38.2 Internal References
In each file occurs an EXTERNALBOOK that is used for internal 3D references. It stores the number of sheets of the
own document.
Record EXTERNALBOOK for 3D references, BIFF8:
Offset
Size
Contents
0
2
Number of sheets in this document
2
2
01H 04H (relict of BIFF5, the byte string â<04H>â, see â2.5.9)
5.38.3 Add-In Functions
Add-in function names are stored in EXTERNNAME records following this EXTERNALBOOK record.
Record EXTERNALBOOK for add-in functions, BIFF8:
Offset
Size
Contents
0
2
0001H
2
2
01H 3AH (relict of BIFF5, the byte string â:â, see EXTERNSHEET record, â5.41)
162
5.38 EXTERNALBOOK â External Workbook
5.38.4 DDE Links, OLE Links
The EXTERNALBOOK record of a DDE link or an OLE link contains the name of the server application (DDE) or the
class name (OLE) and the name of a source document. These names are encoded in one string.
Record EXTERNALBOOK for DDE links and OLE links, BIFF8:
Offset
Size
Contents
0
2
0000H
2
var.
Encoded source document name (â2.5.10). Unicode string, 16-bit string length (â2.5.3).
163
5 Worksheet/Workbook Records
5.39 EXTERNALNAME
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0023H
0223H
0223H
0023H
0023H
This record contains the name of an external defined name, the name of an Analysis add-in function, a DDE item or an
OLE item.
5.39.1 Record Contents (BIFF2)
In BIFF2, all EXTERNNAME records follow an EXTERNSHEET record that contains the URL of the source
document. See â4.10.1 for details about external references in BIFF2.
Record EXTERNNAME, BIFF2-BIFF4:
Offset
Size
Contents
0
var.
Name (byte string, 8-bit string length, â2.5.2)
var.
var.
Formula data (RPN token array, â3)
Record EXTERNNAME for DDE links, BIFF2:
Offset
Size
Contents
0
var.
DDE item name (byte string, 8-bit string length, â2.5.2)
[var.]
var.
(optional) Last received results of the DDE link (constant value array, â2.5.8)
5.39.2 Record Contents (BIFF3-BIFF4)
In BIFF3-BIFF4, all EXTERNNAME records follow an EXTERNSHEET record that contains the URL of the source
document. See â4.10.1 for details about external references in BIFF3-BIFF4.
Record EXTERNNAME for external names (BIFF3-BIFF4) and Analysis add-in functions (BIFF4):
Offset
Size
Contents
0
2
Option flags (see below)
2
var.
Name (byte string, 8-bit string length, â2.5.2). See DEFINEDNAME record (â5.33) for a
list of built-in names, if the built-in flag is set in the option flags above.
var.
var.
Formula data (RPN token array, â3)
Record EXTERNNAME for DDE links, BIFF3-BIFF4:
Offset
Size
Contents
0
2
Option flags (see below)
2
var.
DDE item name (byte string, 8-bit string length, â2.5.2)
[var.]
var.
(optional) Last received results of the DDE link (constant value array, â2.5.8)
Option flags for external names (BIFF3-BIFF4):
Bit
Mask
Contents
0
0001H
0 = Standard name; 1 = Built-in name
1
0002H
0 = Manual link; 1 = Automatic link (DDE links only)
2
0004H
1 = Picture link (DDE links only)
164
5.39 EXTERNALNAME
5.39.3 Record Contents (BIFF5-BIFF8)
In BIFF5, all EXTERNNAME records follow an EXTERNSHEET record that contains the URL of the source document
without a sheet name. EXTERNNAME records representing external defined names refer to earlier EXTERNSHEET
records containing the sheet name in that document. See â4.10.2 for details about external references in BIFF5.
In BIFF8, all EXTERNNAME records follow the EXTERNALBOOK record (â5.38) that contains the URL of the
source document. See â4.10.3 for details about external references in BIFF8.
Record EXTERNNAME for external names and Analysis add-in functions, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Option flags (see below)
2
2
0 for global names, or:
BIFF5: One-based index to EXTERNSHEET record containing the sheet name,
BIFF8: One-based index to sheet list in preceding EXTERNALBOOK record.
4
2
Not used
6
var.
BIFF5: Name (byte string, 8-bit string length, â2.5.2).
BIFF8: Name (Unicode string, 8-bit string length, â2.5.3).
See DEFINEDNAME record (â5.33) for a list of built-in names, if the built-in flag is set
in the option flags above.
var.
var.
Formula data (RPN token array, â3)
Record EXTERNNAME for DDE links and OLE links, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Option flags (see below)
2
4
Storage identifier (OLE links only)
6
var.
DDE/OLE item name
BIFF5: byte string, 8-bit string length (â2.5.2)
BIFF8: Unicode string, 8-bit string length (â2.5.3)
[var.]
var.
(optional) Last received results of the DDE or OLE link (constant value array, â2.5.8)
Option flags for external names (BIFF5-BIFF8)
Bit
Mask
Contents
0
0001H
0 = Standard name; 1 = Built-in name
1
0002H
0 = Manual link; 1 = Automatic link (DDE links and OLE links only)
2
0004H
1 = Picture link (DDE links and OLE links only)
3
0008H
1 = This is the âStdDocumentNameâ identifier (DDE links only)
4
0010H
1 = OLE link
14-5
7FE0H
Clipboard format of last successful update (DDE links and OLE links only)
15
8000H
1 = Iconified picture link (BIFF8 OLE links only)
165
5 Worksheet/Workbook Records
5.40 EXTERNCOUNT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0016H
0016H
0016H
0016H
â
This record contains the number of following EXTERNSHEET records. In BIFF8 this record is omitted because there
occurs only one EXTERNSHEET record. See â4.10.1 for details about external references in BIFF2-BIFF4 and
â4.10.2 for BIFF5.
Record EXTERNCOUNT, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Number of following EXTERNSHEET records (â5.41)
5.41 EXTERNSHEET
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0017H
0017H
0017H
0017H
0017H
5.41.1 Record Contents (BIFF2-BIFF5)
In the file format versions up to BIFF5 this record stores the name of an external document and a sheet name inside of
this document. See â4.10.1 for details about external references in BIFF2-BIFF4 and â4.10.2 for BIFF5.
Record EXTERNSHEET, BIFF2-BIFF5:
Offset
Size
Contents
0
var.
Encoded document and sheet name (â2.5.9). Byte string, 8-bit string length (â2.5.2).
The string length field is decreased by 1, if the EXTERNSHEET stores a reference to one of the own sheets (first
! character is 03H). Example: The formula =Sheet2!A1 contains a reference to an EXTERNSHEET record with the
string â<03H>Sheet2â. The string consists of 7 characters but the string length field contains the value 6.
If a formula uses an add-in function, a special EXTERNSHEET record will occur, followed by an EXTERNNAME
record with the name of the function.
Record EXTERNSHEET for add-in functions, BIFF2-BIFF5:
Offset
Size
Contents
0
2
01H 3AH (byte string, 8-bit string length, containing the colon â:â)
166
5.41 EXTERNSHEET
5.41.2 Record Contents (BIFF8)
In BIFF8 the record stores a list with indexes to EXTERNALBOOK records (list of REF structures, â5.38). See
â4.10.3 for details about external references in BIFF8.
Record EXTERNSHEET, BIFF8:
Offset
Size
Contents
0
2
Number of following REF structures (nm)
2
6ânm
List of nm REF structures. Each REF contains the following data:
Offset
Size
Contents
0
2
Index to EXTERNALBOOK record
2
2
Index to first sheet in EXTERNALBOOK sheet list
4
2
Index to last sheet in EXTERNALBOOK sheet list
5.42 EXTSST â Extended SST
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00FFH
This record occurs in conjunction with the SST record (â5.100). It is used by Excel to create a hash table with stream
offsets to the SST record to optimise string search operations. Excel may not shorten this record if strings are deleted
from the shared string table, so the last part might contain invalid data. The stream indexes in this record divide the SST
into portions containing a constant number of strings. See â4.11 for more information about shared string tables. It is
not required to write this record when exporting an Excel document.
Record EXTSST, BIFF8:
Offset
Size
Contents
0
2
Number of strings in a portion, this number is î8
2
var.
List of OFFSET structures for all portions. Each OFFSET contains the following data:
Offset
Size
Contents
0
4
Absolute stream position of first string of the portion
4
2
Position of first string of the portion inside of current record,
including record header. This counter restarts at zero, if the SST
record is continued with a CONTINUE record.
6
2
Not used
167
5 Worksheet/Workbook Records
5.43 FILEPASS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
002FH
002FH
002FH
002FH
002FH
This record is part of the File Protection Block (â4.19). It contains information about the read/write password of the
file. All record contents following this record will be encrypted (â4.19.1).
5.43.1 Record Contents (BIFF2-BIFF5)
Record FILEPASS, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Encryption key calculated from the read/write password (â4.19.1)
2
2
Hash value calculated from the read/write password (â4.18.4)
5.43.2 Record Contents (BIFF8)
From BIFF8 on it is possible to use different encryption algorithms.
Record FILEPASS, BIFF8, for BIFF2-BIFF5 weak XOR encryption:
Offset
Size
Contents
0
2
0000H = BIFF2-BIFF5 weak XOR encryption
2
2
Encryption key calculated from the read/write password (â4.19.1)
4
2
Hash value calculated from the read/write password (â4.18.4)
Record FILEPASS, BIFF8, for BIFF8 standard encryption:
Offset
Size
Contents
0
2
0001H = BIFF8 standard encryption or strong encryption
2
2
not used, should be equal to next field (0001H)
4
2
0001H = BIFF8 standard encryption
6
16
Unique document identifier used to initialise the encryption algorithm
22
16
Encrypted document identifier used to verify the entered password
38
16
Digest used to verify the entered password
168
5.43 FILEPASS
Record FILEPASS, BIFF8, for BIFF8 strong encryption (available only in Excel 10.0 (Excel XP) and later):
Offset
Size
Contents
0
2
0001H = BIFF8 standard encryption or strong encryption
2
2
not used, should be equal to next field (0002H)
4
2
0002H = BIFF8 strong encryption
6
4
Option flags:
Bit
Mask
Contents
2
00000004H
Always 12
3
00000008H
1 = Do not encrypt document properties
10
var.
FILEPASS Info Block (see below)
var.
4
Size of unique document identifier (uidl)
var.
uidl
Unique document identifier used to initialise the encryption algorithm
var.
uidl
Encrypted document identifier used to verify the entered password
var.
4
Size of following verification digest (dl)
var.
dl
Digest used to verify the entered password
FILEPASS Info Block, BIFF8, for BIFF8 strong encryption:
Offset
Size
Contents
0
4
Size of the following data in this block, without this field
4
4
Repeated option flags from main record (see above)
8
4
Not used
12
4
Stream encryption algorithm identifier:
00006801H = RC4 (Ron's Code 4)
00006802H = SEAL (Secure Encryption Algorithm)
16
4
Password hashing algorithm identifier:
00008001H = MD2 (Message Digest 2)
00008002H = MD4 (Message Digest 4)
00008003H = MD5 (Message Digest 5)
00008004H = SHA-1 (Secure Hash Algorithm)
20
4
Hash key length (bits)
24
4
Cryptographic provider type:
00000001H = RSA
0000000CH = RSA SChannel
0000000DH = DSS and Diffie-Hellman
00000012H = DH SChannel
00000018H = RSA and AES
28
8
Not used
36
var.
Cryptographic provider name, Unicode character array with trailing null character
169
5 Worksheet/Workbook Records
5.44 FILESHARING
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
005BH
005BH
005BH
005BH
This record is part of the File Protection Block (â4.19). It contains information about write protection, for instance the
write protection password. The write protection state of the file is switched on with the WRITEPROT record (â5.113).
Record FILESHARING, BIFF2-BIFF8:
Offset
Size
Contents
0
2
1 = Recommend read-only state while loading the file
2
2
Hash value calculated from the read-only password (â4.18.4)
4
var.
User name of the file creator
BIFF2-BIFF5: Byte string, 8-bit string length (â2.5.2)
BIFF8:
Unicode string, 16-bit string length (â2.5.3)
170
5.45 FONT
5.45 FONT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0031H
0231H
0231H
0031H
0031H
This record contains information about a used font, including character formatting. All FONT records occur together in a
sequential list. Other records referencing a FONT record contain an index into this list.
The font with index 4 is omitted in all BIFF versions. This means the first four fonts have zero-based indexes, and
! the fifth font and all following fonts are referenced with one-based indexes.
Record FONT, BIFF2:
Offset
Size
Contents
0
2
Height of the font (in twips = 1/20 of a point)
2
2
Option flags, see below
4
var.
Font name (byte string, 8-bit string length, â2.5.2)
A FONTCOLOR record (â5.47) containing the font colour may follow.
Record FONT, BIFF3-BIFF4:
Offset
Size
Contents
0
2
Height of the font (in twips = 1/20 of a point)
2
2
Option flags, see below
4
2
Colour index (â5.74)
6
var.
Font name (byte string, 8-bit string length, â2.5.2)
Record FONT, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Height of the font (in twips = 1/20 of a point)
2
2
Option flags, see below
4
2
Colour index (â5.74)
6
2
Font weight (100-1000). Standard values are 0190H (400) for normal text and 02BCH
(700) for bold text.
8
2
Escapement type:
0000H = None
0001H = Superscript
0002H = Subscript
10
1
Underline type:
00H = None
01H = Single
21H = Single accounting
02H = Double
22H = Double accounting
11
1
Font family:
00H = None (unknown or don't care)
01H = Roman (variable width, serifed)
02H = Swiss (variable width, sans-serifed)
03H = Modern (fixed width, serifed or sans-serifed)
04H = Script (cursive)
05H = Decorative (specialised, for example Old English, Fraktur)
12
1
Character set (used by all cell records containing byte strings), see below
13
1
Not used
14
var.
Font name:
BIFF5: Byte string, 8-bit string length (â2.5.2)
BIFF8: Unicode string, 8-bit string length (â2.5.3)
171
5 Worksheet/Workbook Records
Option flags, BIFF2-BIFF8:
Bit
Mask
Contents
0
0001H
1 = Characters are bold (redundant in BIFF5-BIFF8, see below)
1
0002H
1 = Characters are italic
2
0004H
1 = Characters are underlined (redundant in BIFF5-BIFF8, see below)
3
0008H
1 = Characters are struck out
4
0010H
1 = Characters are outlined
5
0020H
1 = Characters are shadowed
6
0040H
1 = Characters are condensed
7
0080H
1 = Characters are extended
Character set, BIFF5-BIFF8:
Character set
Character set
00H = 0 = ANSI Latin
A2H = 162 = ANSI Turkish
01H = 1 = System default
A3H = 163 = ANSI Vietnamese
02H = 2 = Symbol
B1H = 177 = ANSI Hebrew
4DH = 77 = Apple Roman
B2H = 178 = ANSI Arabic
80H = 128 = ANSI Japanese Shift-JIS
BAH = 186 = ANSI Baltic
81H = 129 = ANSI Korean (Hangul)
CCH = 204 = ANSI Cyrillic
82H = 130 = ANSI Korean (Johab)
DEH = 222 = ANSI Thai
86H = 134 = ANSI Chinese Simplified GBK
EEH = 238 = ANSI Latin II (Central European)
88H = 136 = ANSI Chinese Traditional BIG5
FFH = 255 = OEM Latin I
A1H = 161 = ANSI Greek
In BIFF5-BIFF8, the boldness and underline flags are still set in the options field, but not used on reading the font. Font
weight and underline type are specified in separate fields instead. The character set specifies the encoding used by cell
records that contain byte strings, for instance LABEL (â5.63), RSTRING (â5.89), FORMULA (â5.50), or STRING
(â5.102).
172
5.46 FONT2
5.46 FONT2
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0032H
â
â
â
â
This record stores additional system-specific data about the font described in the preceding FONT record (â5.45). This
record is optional. The contents of this record are unknown.
5.47 FONTCOLOR
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0045H
â
â
â
â
This record stores the colour of the font that is described in the preceding FONT record (â5.45). From BIFF3 on, the
colour index is part of the FONT record.
Record FONTCOLOR, BIFF2:
Offset
Size
Contents
0
2
Font colour index for the font described in the preceding FONT record:
0000H = 000000H = EGA Black
0004H = 0000FFH = EGA Blue
0001H = FFFFFFH = EGA White
0005H = FFFF00H = EGA Yellow
0002H = FF0000H = EGA Red
0006H = FF00FFH = EGA Magenta
0003H = 00FF00H = EGA Green
0007H = 00FFFFH = EGA Cyan
7FFFH = Automatic (system window text colour)
These values are equal to the colour indexes described in the PALETTE record (â5.74).
5.48 FOOTER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0015H
0015H
0015H
0015H
0015H
This record is part of the Page Settings Block (â4.4). It specifies the page footer string for the current worksheet. If this
record is not present or completely empty (record size is 0), the sheet does not contain a page footer.
Record FOOTER for non-empty page footer, BIFF2-BIFF8:
Offset
Size
Contents
0
var.
Page footer string
BIFF2-BIFF5:
Non-empty byte string, 8-bit string length (â2.5.2)
BIFF8:
Non-empty Unicode string, 16-bit string length (â2.5.3)
The structure of the page footer string is equal to the page header string. For a detailed description see HEADER record,
â5.55.
173
5 Worksheet/Workbook Records
5.49 FORMAT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001EH
001EH
041EH
041EH
041EH
This record contains information about a number format. All FORMAT records occur together in a sequential list.
In BIFF2-BIFF4 other records referencing a FORMAT record contain a zero-based index into this list. From BIFF5 on
the FORMAT record contains the index itself that will be used by other records.
Record FORMAT, BIFF2-BIFF3:
Offset
Size
Contents
0
var.
Number format string (byte string, 8-bit string length, â2.5.2)
Record FORMAT, BIFF4-BIFF5:
Offset
Size
Contents
0
2
BIFF4: Not used
BIFF5: Format index used in other records
2
var.
Number format string (byte string, 8-bit string length, â2.5.2)
Record FORMAT, BIFF8:
Offset
Size
Contents
0
2
Format index used in other records
2
var.
Number format string (Unicode string, 16-bit string length, â2.5.3)
From BIFF5 on, the built-in number formats will be omitted. The built-in formats are dependent on the current regional
settings of the operating system. The following table shows which number formats are used by default in a US-English
environment. All indexes from 0 to 163 are reserved for built-in formats. The first user-defined format starts at 164.
The built-in number formats, BIFF5-BIFF8:313233
Index Type
Format string
Index Type
Format string
0
General
General
18
Time
h:mm AM/PM
1
Decimal
0
19
Time
h:mm:ss AM/PM
2
Decimal
0.00
20
Time
h:mm
3
Decimal
#,##0
21
Time
h:mm:ss
4
Decimal
#,##0.00
2232
Date/Time M/D/YY h:mm
531
Currency
"$"#,##0_);("$"#,##0)
37
Account.
_(#,##0_);(#,##0)
631
Currency
"$"#,##0_);[Red]("$"#,##0)
38
Account.
_(#,##0_);[Red](#,##0)
731
Currency
"$"#,##0.00_);("$"#,##0.00)
39
Account.
_(#,##0.00_);(#,##0.00)
831
Currency
"$"#,##0.00_);[Red]("$"#,##0.00)
40
Account.
_(#,##0.00_);[Red](#,##0.00)
9
Percent
0%
4131
Currency
_("$"* #,##0_);_("$"* (#,##0);_("$"* "-"_);_(@_)
10
Percent
0.00%
4231 33
Currency
_(* #,##0_);_(* (#,##0);_(* "-"_);_(@_)
11
Scientific
0.00E+00
4331
Currency
_("$"* #,##0.00_);_("$"* (#,##0.00);_("$"* "-"??_);_(@_)
12
Fraction
# ?/?
4431 33
Currency
_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)
13
Fraction
# ??/??
45
Time
mm:ss
1432
Date
M/D/YY
46
Time
[h]:mm:ss
15
Date
D-MMM-YY
47
Time
mm:ss.0
16
Date
D-MMM
48
Scientific
##0.0E+0
17
Date
MMM-YY
49
Text
@
31 These formats are always written by Excel, though they are built-in. They contain the currency symbol of the current locale as plain
text. It precedes or follows the value, according to the local settings. It is not required to write these formats.
32 These formats are taken from the Microsoft Windows regional settings. Changes of these system settings will be reflected in the
Excel document.
33 These formats contain a blind currency symbol (an underscore precedes each character), if it follows the value. This happens for
example in a German format with the Euro sign. Here the built-in format 42 looks like this: _-* #,##0 _âŹ_-;-* #,##0 _âŹ_-;_-* "-" _âŹ_-;_-
@_-
174
5.49 FORMAT
Some of the built-in number formats are only used in special locales. As an example, the following table shows special
Japanese formats:
Index Type
Format string
Index Type
Format string
27
Date
[$-0411]GE.M.D
50
Date
[$-0411]GE.M.D
28
Date
[$-0411]GGGE ĺš´ M ć D ćĽ
51
Date
[$-0411]GGGE ĺš´ M ć D ćĽ
29
Date
[$-0411]GGGE ĺš´ M ć D ćĽ
52
Date
[$-0411]YYYY ĺš´ M ć
30
Date
[$-0411]M/D/YY
53
Date
[$-0411]M ć D ćĽ
31
Date
[$-0411]YYYY ĺš´ M ć D ćĽ
54
Date
[$-0411]GGGE ĺš´ M ć D ćĽ
32
Time
[$-0411]h ć mm ĺ
55
Date
[$-0411]YYYY ĺš´ M ć
33
Time
[$-0411]h"ć"mm"ĺ"ss"ç§"
56
Date
[$-0411]M ć D ćĽ
34
Date
[$-0411]YYYY ĺš´ M ć
57
Date
[$-0411]GE.M.D
35
Date
[$-0411]M ć D ćĽ
58
Date
[$-0411]GGGE ĺš´ M ć D ćĽ
36
Date
[$-0411]GE.M.D
175
5 Worksheet/Workbook Records
5.50 FORMULA
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0006H
0206H
0406H
0006H
0006H
This record contains the token array and the result of a formula cell.
⢠Record Contents
Record FORMULA, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
7
8
Result of the formula (IEEE 754 floating-point value, 64-bit double precision)
15
1
0 = Do not recalculate, 1 = Recalculate always
16
var.
Formula data (RPN token array, â3)
Record FORMULA, BIFF3-BIFF4:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
8
Result of the formula. See below for details.
14
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Recalculate always
1
0002H
1 = Calculate on open
16
var.
Formula data (RPN token array, â3)
Record FORMULA, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
8
Result of the formula. See below for details.
14
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Recalculate always
1
0002H
1 = Calculate on open
3
0008H
1 = Part of a shared formula
16
4
Not used
20
var.
Formula data (RPN token array, â3)
176
5.50 FORMULA
⢠Result of the Formula
Dependent on the type of value the formula returns, the result field has the following format:
Result is a numeric value:
Offset
Size
Contents
0
8
IEEE 754 floating-point value (64-bit double precision)
Result is a string (the string follows in a STRING record, â5.102):
Offset
Size
Contents
0
1
00H (identifier for a string value)
1
5
Not used
6
2
FFFFH
Note: In BIFF8 the string must not be empty. For empty cells there is a special identifier defined (see below).
Result is a Boolean value:
Offset
Size
Contents
0
1
01H (identifier for a Boolean value)
1
1
Not used
2
1
0 = FALSE, 1 = TRUE
3
3
Not used
6
2
FFFFH
Result is an error value:
Offset
Size
Contents
0
1
02H (identifier for an error value)
1
1
Not used
2
1
Error code (â2.5.6)
3
3
Not used
6
2
FFFFH
Result is an empty cell (BIFF8), for example an empty string:
Offset
Size
Contents
0
1
03H (identifier for an empty cell)
1
5
Not used
6
2
FFFFH
177
5 Worksheet/Workbook Records
5.51 GCW â Global Column Width
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
00ABH
00ABH
â
This record contains a bitfield with one bit for every column in the worksheet, describing how to set the column width
for the respective column. If this record is omitted, all columns are using the default column width.
Record GCW, BIFF4-BIFF5:
Offset
Size
Contents
0
2
Size of the following bitfield (in bytes, always 0020H)
2
32
Bit field with one bit for every column in the worksheet. The first byte of the bitfield
contains flags for the first 8 columns (A to H), the second byte for the next 8 columns and
so on. Bit 0 (mask 0x01) of each byte is for the leftmost column in the column interval,
bit 7 (mask 0x80) is for the rightmost column.
If a bit is set, the corresponding column uses the width set in the STANDARDWIDTH
record (â5.101). If a bit is cleared, the corresponding column uses the width set in the
COLINFO record (â5.18) for this column.
If a bit is set, and the worksheet does not contain the STANDARDWIDTH record, or if the
bit is cleared, and the worksheet does not contain the COLINFO record, the DEFCOL-
WIDTH record (â5.32) of the worksheet will be used instead.
178
5.52 GRIDSET
5.52 GRIDSET
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0082H
0082H
0082H
0082H
This record specifies if the option to print sheet grid lines (record PRINTGRIDLINES, â5.80) has ever been changed.
Record GRIDSET, BIFF3-BIFF8:
Offset
Size
Contents
0
2
0 = Print grid lines option never changed
1 = Print grid lines option changed
5.53 GUTS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0080H
0080H
0080H
0080H
This record contains information about the layout of outline symbols.
Record GUTS, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Width of the area to display row outlines (left of the sheet), in pixel
2
2
Height of the area to display column outlines (above the sheet), in pixel
4
2
Number of visible row outline levels (used row levels + 1; or 0, if not used)
6
2
Number of visible column outline levels (used column levels + 1; or 0, if not used)
5.54 HCENTER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0083H
0083H
0083H
0083H
This record is part of the Page Settings Block (â4.4). It specifies if the sheet is centred horizontally when printed.
Record HCENTER, BIFF3-BIFF8:
Offset
Size
Contents
0
2
0 = Print sheet left aligned
1 = Print sheet centred horizontally
179
5 Worksheet/Workbook Records
5.55 HEADER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0014H
0014H
0014H
0014H
0014H
This record is part of the Page Settings Block (â4.4). It specifies the page header string for the current worksheet. If this
record is not present or completely empty (record size is 0), the sheet does not contain a page header.
Record HEADER for non-empty page header, BIFF2-BIFF8:
Offset
Size
Contents
0
var.
Page header string
BIFF2-BIFF5:
Non-empty byte string, 8-bit string length (â2.5.2)
BIFF8:
Non-empty Unicode string, 16-bit string length (â2.5.3)
The header string may contain special commands, for example placeholders for the page number, current date, or text
formatting attributes. These fields are represented by single letters (exception: font name and size, see below) with a
leading ampersand (â&â). If the ampersand is part of the regular header text, it will be duplicated (â&&â).
The page header is divided into 3 sections: the left, the centred, and the right section. Each section is introduced by a
special command. All text and all commands following are part of the selected section. Each section starts with the text
formatting specified in the default font (first FONT record in the file). Active formatting attributes from a previous
section do not go into the next section.
The following table shows all available commands:
Command Contents
Command Contents
&&
The â&â character itself
&L
Start of the left section
&C
Start of the centred section
&R
Start of the right section
&P
Current page number
&A
Sheet name (BIFF5-BIFF8)
&N
Page count
&F
File name without path
&D
Current date
&Z
File path without file name (BIFF8)
&T
Current time
&G
Picture (BIFF8)
&B
Bold on/off
&H
Shadowed text on/off
&I
Italic on/off
&O
Outlined text on/off
&U
Underlining on/off
&X
Superscript on/off (BIFF5-BIFF8)
&E
Double underlining on/off (BIFF5-BIFF8)
&Y
Subscript on/off (BIFF5-BIFF8)
&S
Strikeout on/off
More complex commands:
Command
Contents
&"<fontname>"
Set new font <fontname>
&"<fontname>,<fontstyle>"
Set new font with specified style <fontstyle>. The style <fontstyle> is in most cases
one of âRegularâ, âBoldâ, âItalicâ, or âBold Italicâ. But this setting is dependent on the
used font, it may differ (localised style names, or âStandardâ, âObliqueâ, ...). (BIFF5-
BIFF8)
&<fontheight>
Set font height in points (<fontheight> is a decimal value). If this command is followed
by a plain number to be printed in the header, it will be separated from the font height
with a space character.
In BIFF2 the commands differ in the localised versions of Excel.
!
180
5.56 HIDEOBJ
5.56 HIDEOBJ
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
008DH
008DH
008DH
008DH
This record specifies whether and how to show objects in the workbook.
Record HIDEOBJ, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Viewing mode for objects:
0 = Show all objects
1 = Show placeholders
2 = Do not show objects
5.57 HORIZONTALPAGEBREAKS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001BH
001BH
001BH
001BH
001BH
This record is part of the Page Settings Block (â4.4). It contains all horizontal manual page breaks.
Record HORIZONTALPAGEBREAKS, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Number of following row indexes (nm)
2
2ânm
List of nm row indexes. Each row index specifies the first row after the page break.
Record HORIZONTALPAGEBREAKS, BIFF8:
Offset
Size
Contents
0
2
Number of following row index structures (nm)
2
6ânm
List of nm row index structures. Each row index structure contains:
Offset
Size
Contents
0
2
Index to first row below the page break
2
2
Index to first column of this page break
4
2
Index to last column of this page break
The row indexes in the lists must be ordered ascending. If in BIFF8 a row contains several page breaks, they must be
ordered ascending by start column index.
181
5 Worksheet/Workbook Records
5.58 HYPERLINK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
01B8H
In Excel, every cell may contain a hyperlink. The HYPERLINK record refers to one cell address or a cell range where all
cells contain the same hyperlink. It is part of the Hyperlink Table in the Sheet Substream (â4.13). Every hyperlink can
contain a text mark and a description that is shown in the sheet instead of the real link. Text marks are appended behind
a link, separated by the hash sign (â#â).
Examples for text marks: www.example.org#table1 or C:\example.xls#Sheet1!A1.
Inside of this record strings are stored in several formats. Sometimes occurs the character count, otherwise the character
array size (in 16-bit character arrays the character count is half of the array size). Furthermore some strings are zero-
terminated, others not. They are stored either as 16-bit character arrays or as 8-bit character arrays, independent of the
characters.
5.58.1 Common Record Contents
Each HYPERLINK record starts with the same data items and continues with special data related to the current type of
hyperlink. It starts with a cell range. Each cell of this range will contain the same hyperlink.
Record HYPERLINK, BIFF8:
Offset
Size
Contents
0
8
Cell range address of all cells containing this hyperlink (â2.5.14)
8
16
GUID of StdLink:
D0H C9H EAH 79H F9H BAH CEH 11H 8CH 82H 00H AAH 00H 4BH A9H 0BH
(79EAC9D0-BAF9-11CE-8C82-00AA004BA90B)
24
4
Unknown value: 00000002H
28
4
Option flags (see below)
[32]
4
(optional, see option flags) Character count of description text, including trailing zero word
(dl)
[36]
2âdl
(optional, see option flags) Character array of description text, no Unicode string header,
always 16-bit characters, zero-terminated
[var.]
4
(optional, see option flags) Character count of target frame, including trailing zero word
(fl)
[var.]
2âfl
(optional, see option flags) Character array of target frame, no Unicode string header,
always 16-bit characters, zero-terminated
var.
var.
Special data (â5.58.2 and following)
[var.]
4
(optional, see option flags) Character count of the text mark, including trailing zero word
(tl)
[var.]
2âtl
(optional, see option flags) Character array of the text mark without â#â sign, no Unicode
string header, always 16-bit characters, zero-terminated
The special data parts in the following are described with relative offsets (starting again by zero). The real offset inside
of the record data (without header) is either 32 (without description) or 36+2âdl (with description).
182
5.58 HYPERLINK
⢠Option Flags
The option flags specify the following content of the record.
Bit
Mask
Contents
0
00000001H
0 = No link extant
1 = File link or URL
1
00000002H
0 = Relative file path
1 = Absolute path or URL
2 and 4
00000014H
0 = No description
1 (both bits) = Description
3
00000008H
0 = No text mark
1 = Text mark
7
00000080H
0 = No target frame
1 = Target frame
8
00000100H
0 = File link or URL
1 = UNC path (incl. server name)
5.58.2 Hyperlink containing a URL (Uniform Resource Locator)
These data fields occur for links which are not local files or files in the local network (for instance HTTP and FTP links
and e-mail addresses). The lower 9 bits of the option flags field must be 0.x00x.xx112 (x means optional, depending
on hyperlink content). The GUID could be used to distinguish a URL from a file link.
Offset
Size
Contents
0
16
GUID of URL Moniker:
E0H C9H EAH 79H F9H BAH CEH 11H 8CH 82H 00H AAH 00H 4BH A9H 0BH
(79EAC9E0-BAF9-11CE-8C82-00AA004BA90B)
16
4
Size of character array of the URL, including trailing zero word (us). There are us/2-1
characters in the following string.
20
us
Character array of the URL, no Unicode string header, always 16-bit characters, zero-
terminated
183
5 Worksheet/Workbook Records
5.58.3 Hyperlink to a Local File
These data fields are for links to files on local drives. The path of the file can be complete with drive letter (absolute) or
relative to the location of the workbook. The lower 9 bits of the option flags field must be 0.x00x.xxx12. The GUID
could be used to distinguish a URL from a file link.
Offset
Size
Contents
0
16
GUID of File Moniker:
03H 03H 00H 00H 00H 00H 00H 00H C0H 00H 00H 00H 00H 00H 00H 46H
(00000303-0000-0000-C000-000000000046)
16
2
Directory up-level count. Each leading â..\â in the file link is deleted and increases this
counter.
18
4
Character count of the shortened file path and name, including trailing zero byte (sl)
22
sl
Character array of the shortened file path and name in 8.3-DOS-format. This field can be
filled with a long file name too. No Unicode string header, always 8-bit characters, zero-
terminated.
22+sl
24
Unknown byte sequence:
FFH FFH ADH DEH
00H 00H 00H 00H
00H 00H 00H 00H
00H 00H 00H 00H
00H 00H 00H 00H
00H 00H 00H 00H
46+sl
4
Size of the following file link field including string length field and additional data field
(sz). If sz is zero, nothing will follow (except a text mark).
[50+sl]
4
(optional) Size of character array of the extended file path and name (xl). There are xl/2
characters in the following string.
[54+sl]
2
(optional) Unknown byte sequence: 03H 00H
[56+sl]
xl
(optional) Character array of the extended file path and name (xl), no Unicode string
header, always 16-bit characters, not zero-terminated
5.58.4 Hyperlink to a File with UNC (Universal Naming Convention) Path
These data fields are for UNC paths containing a server name (for instance â\\server\path\file.xlsâ). The lower 9 bits of
the option flags field must be 1.x00x.xx112.
Offset
Size
Contents
0
4
Character count of the UNC, including trailing zero word (fl)
4
2âfl
Character array of the UNC, no Unicode string header, always 16-bit characters, zero-
terminated.
5.58.5 Hyperlink to the Current Workbook
In this case only the text mark field is present (optional with description).
Example: The URL â#Sheet2!B1:C2â refers to the given range in the current workbook.
The lower 9 bits of the option flags field must be 0.x00x.1x002.
184
5.59 INDEX
5.59 INDEX
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000BH
020BH
020BH
020BH
020BH
This record stores the range of used rows and stream positions of several records of the current sheet. In particular the
position of the first DEFINEDNAME record and XF record is stored (BIFF2-BIFF4) and the position of a specific
record in each Row Block (the first ROW record in BIFF2-BIFF4, and the DBCELL record in BIFF5-BIFF8). This
stream position array also contains stream offsets to empty Row Blocks, they will point to the next extant Row Block.
The number of entries nm in this array can be calculated from the row range given in this record (rf is the index to the
first used row, rl is the index to the first row of unused tail of sheet): nm = (rl â rf â 1) / 32 + 1 (using integer
division).
For details about Row Blocks in a worksheet see â4.7.
Record INDEX, BIFF2:
Offset
Size
Contents
0
4
Absolute stream position of the first DEFINEDNAME record (â5.33)
4
2
Index to first used row (rf, 0-based)
6
2
Index to first row of unused tail of sheet (rl, last used row + 1, 0-based)
8
4ânm
Array of nm absolute stream positions to first ROW record (â5.88) of each Row Block
Record INDEX, BIFF3-BIFF4:
Offset
Size
Contents
0
4
Absolute stream position of the first DEFINEDNAME record (â5.33).
4
2
Index to first used row (rf, 0-based)
6
2
Index to first row of unused tail of sheet (rl, last used row + 1, 0-based)
8
4
Absolute stream position of the first XF record (â5.115).
12
4ânm
Array of nm absolute stream positions to first ROW record (â5.88) of each Row Block.
Record INDEX, BIFF5:
Offset
Size
Contents
0
4
Not used
4
2
Index to first used row (rf, 0-based)
6
2
Index to first row of unused tail of sheet (rl, last used row + 1, 0-based)
8
4
Absolute stream position of the DEFCOLWIDTH record (â5.32) of the current sheet. If
this record does not exist, the offset points to the record at the position where the
DEFCOLWIDTH record would occur.
12
4ânm
Array of nm absolute stream positions to the DBCELL record (â5.29) of each Row Block
Record INDEX, BIFF8:
Offset
Size
Contents
0
4
Not used
4
4
Index to first used row (rf, 0-based)
8
4
Index to first row of unused tail of sheet (rl, last used row + 1, 0-based)
12
4
Absolute stream position of the DEFCOLWIDTH record (â5.32) of the current sheet. If
this record does not exist, the offset points to the record at the position where the
DEFCOLWIDTH record would occur.
16
4ânm
Array of nm absolute stream positions to the DBCELL record (â5.29) of each Row Block
185
5 Worksheet/Workbook Records
5.60 INTEGER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0002H
â
â
â
â
This record represents a cell that contains an unsigned 16-bit integer value. If a value cannot be stored as a 16-bit
integer, a NUMBER record (â5.71) must be written. From BIFF3 on this record is replaced by the RK record (â5.87).
Record INTEGER, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
7
2
Unsigned 16-bit integer value
5.61 ITERATION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0011H
0011H
0011H
0011H
0011H
This record is part of the Calculation Settings Block (â4.3). It stores if iterations are allowed while calculating recursive
formulas.
Record ITERATION, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Iterations off; 1 = Iterations on
5.62 IXFE â Index to XF
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0044H
â
â
â
â
This record occurs in front of every cell record (for instance BLANK, INTEGER, NUMBER, LABEL, FORMULA) that
references to an XF record (â5.115) with an index greater than 62. The XF index field of the cell record consists only of
6 bits. The maximum value 63 is used to indicate a preceding IXFE record containing the real XF index. See â2.5.13 for
more details.
Record IXFE, BIFF2:
Offset
Size
Contents
0
2
Index to XF record (â5.115)
186
5.63 LABEL
5.63 LABEL
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0004H
0204H
0204H
0204H
0204H
This record represents a cell that contains a string. In BIFF8 it is usually replaced by the LABELSST record (â5.65).
Excel still uses this record, if it copies unformatted text cells to the clipboard.
Record LABEL, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
7
var.
Byte string, 8-bit string length (â2.5.2)
Record LABEL, BIFF3-BIFF5:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
var.
Byte string, 16-bit string length (â2.5.2)
Record LABEL, BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
var.
Unicode string, 16-bit string length (â2.5.3)
5.64 LABELRANGES
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
015FH
This record contains the addresses of all row and column label ranges in the current sheet.
Record LABELRANGES, BIFF8:
Offset
Size
Contents
0
var.
Cell range address list with all row label ranges (â2.5.15)
var.
var.
Cell range address list with all column label ranges (â2.5.15)
187
5 Worksheet/Workbook Records
5.65 LABELSST
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00FDH
This record represents a cell that contains a string. It replaces the LABEL record (â5.63) and RSTRING record (â5.89)
used in BIFF2-BIFF5. See â4.11 for more information about shared string tables.
Record LABELSST, BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
4
Index into SST record (â5.100)
5.66 LEFTMARGIN
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0026H
0026H
0026H
0026H
0026H
This record is part of the Page Settings Block (â4.4). It contains the left page margin of the current worksheet.
Record LEFTMARGIN, BIFF2-BIFF8:
Offset
Size
Contents
0
8
Left page margin in inches (IEEE 754 floating-point value, 64-bit double precision)
5.67 MERGEDCELLS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00E5H
This record contains the addresses of merged cell ranges in the current sheet.
Record MERGEDCELLS, BIFF8:
Offset
Size
Contents
0
var.
Cell range address list with merged ranges (â2.5.15)
If the record size exceeds the limit, it is not continued with a CONTINUE record, but another self-contained MERGED-
CELLS record is started. The limit of 8224 bytes per record results in a maximum number of 1027 merged ranges.
Example: A sheet contains 1040 merged cell ranges. The first MERGEDCELLS record contains a list of 1027
range addresses (the leading number of ranges is 1027 too). Following a second MERGEDCELLS record with
the remaining 13 merged ranges.
188
5.68 MULBLANK â Multiple BLANK
5.68 MULBLANK â Multiple BLANK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00BEH
00BEH
This record represents a cell range of empty cells. All cells are located in the same row.
Record MULBLANK, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to first column (fc)
4
2ânc
List of nc=lc-fc+1 16-bit indexes to XF records (â5.115)
4+2ânc
2
Index to last column (lc)
5.69 MULRK â Multiple RK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00BDH
00BDH
This record represents a cell range containing RK value cells. All cells are located in the same row.
Record MULRK, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to first column (fc)
4
6ânc
List of nc=lcâfc+1 XF/RK structures. Each XF/RK contains:
Offset
Size
Contents
0
2
Index to XF record (â5.115)
2
4
RK value (â2.5.5)
4+6ânc
2
Index to last column (lc)
189
5 Worksheet/Workbook Records
5.70 NOTE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001CH
001CH
001CH
001CH
001CH
This record represents a cell annotation.
Record NOTE, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Total length of the annotation string (character count, ln)
6
var.
Character array (8-bit characters). This character array will contain at most 2048
characters. If an annotation is longer than 2048 characters, the remaining string will be
written in one or more following NOTE records (see below). Nevertheless the string length
field ln in this record contains the total length of the annotation text.
Record NOTE for continuation of long notes, BIFF2-BIFF5:
Offset
Size
Contents
0
2
always FFFFH
2
2
Not used
4
2
Length of this part of the annotation string (character count, 1âŚ2048, ln)
6
var.
Character array containing ln characters (8-bit characters)
Example: An annotation contains 5000 characters. The string will be split into 3 parts: the first two NOTE
records contain 2048 characters each, and the third NOTE record contains the remaining 904 characters. The first
NOTE record contains the total length of the string (5000), the second and third record contain the local length
(2048 respectively 904).
Record NOTE, BIFF8:
2do
190
5.71 NUMBER
5.71 NUMBER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0003H
0203H
0203H
0203H
0203H
This record represents a cell that contains a floating-point value.
Record NUMBER, BIFF2:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
3
Cell attributes (â2.5.13)
7
8
IEEE 754 floating-point value (64-bit double precision)34
Record NUMBER, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
8
IEEE 754 floating-point value (64-bit double precision)34
5.72 OBJECTPROTECT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0063H
0063H
0063H
0063H
This record is part of the worksheet/workbook protection (â4.18). It determines whether the objects of the current sheet
are protected. Object protection is not active, if this record is omitted.
Record OBJECTPROTECT, BIFF3-BIFF8:
Offset
Size
Contents
0
2
0 = Objects not protected; 1 = Objects protected
34 For details about the internal structure of floating-point values see http://en.wikipedia.org/wiki/IEEE_floating-point_standard.
191
5 Worksheet/Workbook Records
5.73 PAGESETUP
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
00A1H
00A1H
00A1H
This record is part of the Page Settings Block (â4.4). It stores the page format settings of the current sheet. The pages
may be scaled in percent or by using an absolute number of pages. This setting is located in the SHEETPR record
(â5.97). If pages are scaled in percent, the scaling factor in this record is used, otherwise the âFit to pagesâ values. One
of the âFit to pagesâ values may be 0. In this case the sheet is scaled to fit only to the other value.
⢠Record Contents
Record PAGESETUP, BIFF4:
Offset
Size
Contents
0
2
Paper size (see below)
2
2
Scaling factor in percent
4
2
Start page number
6
2
Fit worksheet width to this number of pages (0 = use as many as needed)
8
2
Fit worksheet height to this number of pages (0 = use as many as needed)
10
2
Option flags:
Bit
Mask
Contents
0
0001H
0 = Print pages in columns
1 = Print pages in rows
1
0002H
0 = Landscape
1 = Portrait
2
0004H
1 = Paper size, scaling factor, and paper orientation
(portrait/landscape) are not initialised
3
0008H
0 = Print coloured
1 = Print black and white
192
5.73 PAGESETUP
Record PAGESETUP, BIFF5-BIFF8:
Offset
Size
Contents
0
10
Equal to BIFF4, see above
10
2
Option flags:
Bit
Mask
Contents
0
0001H
0 = Print pages in columns
1 = Print pages in rows
1
0002H
0 = Landscape
1 = Portrait
2
0004H
1 = Paper size, scaling factor, paper orientation (portrait/landscape),
print resolution and number of copies are not initialised
3
0008H
0 = Print coloured
1 = Print black and white
4
0010H
0 = Default print quality
1 = Draft quality
5
0020H
0 = Do not print cell notes
1 = Print cell notes
6
0040H
0 = Use paper orientation
1 = Use default paper orientation
(portrait/landscape) flag above
(landscape for chart sheets,
portrait otherwise)
7
0080H
0 = Automatic page numbers
1 = Use start page number above
The following flags are valid for BIFF8 only:
9
0200H
0 = Print notes as displayed
1 = Print notes at end of sheet
11-10
0C00H
002 = Print errors as displayed
102 = Print errors as â--â
012 = Do not print errors
112 = Print errors as â#N/Aâ
12
2
Print resolution in dpi
14
2
Vertical print resolution in dpi
16
8
Header margin (IEEE 754 floating-point value, 64-bit double precision)
24
8
Footer margin (IEEE 754 floating-point value, 64-bit double precision)
32
2
Number of copies to print
193
5 Worksheet/Workbook Records
⢠Paper Size Table
Index
Paper type
Paper size
Index
Paper type
Paper size
0
Undefined
48
Undefined
1
Letter
81/2Ë Ă 11Ë
49
Undefined
2
Letter small
81/2Ë Ă 11Ë
50
Letter Extra
91/2Ë Ă 12Ë
3
Tabloid
11Ë Ă 17Ë
51
Legal Extra
91/2Ë Ă 15Ë
4
Ledger
17Ë Ă 11Ë
52
Tabloid Extra
1111/16Ë Ă 18Ë
5
Legal
81/2Ë Ă 14Ë
53
A4 Extra
235mm Ă 322mm
6
Statement
51/2Ë Ă 81/2Ë
54
Letter Transverse
81/2Ë Ă 11Ë
7
Executive
71/4Ë Ă 101/2Ë
55
A4 Transverse
210mm Ă 297mm
8
A3
297mm Ă 420mm
56
Letter Extra Transv.
91/2Ë Ă 12Ë
9
A4
210mm Ă 297mm
57
Super A/A4
227mm Ă 356mm
10
A4 small
210mm Ă 297mm
58
Super B/A3
305mm Ă 487mm
11
A5
148mm Ă 210mm
59
Letter Plus
812Ë Ă 1211/16Ë
12
B4 (JIS)
257mm Ă 364mm
60
A4 Plus
210mm Ă 330mm
13
B5 (JIS)
182mm Ă 257mm
61
A5 Transverse
148mm Ă 210mm
14
Folio
81/2Ë Ă 13Ë
62
B5 (JIS) Transverse
182mm Ă 257mm
15
Quarto
215mm Ă 275mm
63
A3 Extra
322mm Ă 445mm
16
10Ă14
10Ë Ă 14Ë
64
A5 Extra
174mm Ă 235mm
17
11Ă17
11Ë Ă 17Ë
65
B5 (ISO) Extra
201mm Ă 276mm
18
Note
81/2Ë Ă 11Ë
66
A2
420mm Ă 594mm
19
Envelope #9
37/8Ë Ă 87/8Ë
67
A3 Transverse
297mm Ă 420mm
20
Envelope #10
41/8Ë Ă 91/2Ë
68
A3 Extra Transverse
322mm Ă 445mm
21
Envelope #11
41/2Ë Ă 103/8Ë
69
Dbl. Japanese Postcard
200mm Ă 148mm
22
Envelope #12
43/4Ë Ă 11Ë
70
A6
105mm Ă 148mm
23
Envelope #14
5Ë Ă 111/2Ë
71
24
C
17Ë Ă 22Ë
72
25
D
22Ë Ă 34Ë
73
26
E
34Ë Ă 44Ë
74
27
Envelope DL
110mm Ă 220mm
75
Letter Rotated
11Ë Ă 81/2Ë
28
Envelope C5
162mm Ă 229mm
76
A3 Rotated
420mm Ă 297mm
29
Envelope C3
324mm Ă 458mm
77
A4 Rotated
297mm Ă 210mm
30
Envelope C4
229mm Ă 324mm
78
A5 Rotated
210mm Ă 148mm
31
Envelope C6
114mm Ă 162mm
79
B4 (JIS) Rotated
364mm Ă 257mm
32
Envelope C6/C5
114mm Ă 229mm
80
B5 (JIS) Rotated
257mm Ă 182mm
33
B4 (ISO)
250mm Ă 353mm
81
Japanese Postcard Rot.
148mm Ă 100mm
34
B5 (ISO)
176mm Ă 250mm
82
Dbl. Jap. Postcard Rot.
148mm Ă 200mm
35
B6 (ISO)
125mm Ă 176mm
83
A6 Rotated
148mm Ă 105mm
36
Envelope Italy
110mm Ă 230mm
84
37
Envelope Monarch
37/8Ë Ă 71/2Ë
85
38
63/4 Envelope
35/8Ë Ă 61/2Ë
86
39
US Standard Fanfold
147/8Ë Ă 11Ë
87
40
German Std. Fanfold
81/2Ë Ă 12Ë
88
B6 (JIS)
128mm Ă 182mm
41
German Legal Fanfold
81/2Ë Ă 13Ë
89
B6 (JIS) Rotated
182mm Ă 128mm
42
B4 (ISO)
250mm Ă 353mm
90
12Ă11
12Ë Ă 11Ë
43
Japanese Postcard
100mm Ă 148mm
44
9Ă11
9Ë Ă 11Ë
45
10Ă11
10Ë Ă 11Ë
46
15Ă11
15Ë Ă 11Ë
47
Envelope Invite
220mm Ă 220mm
194
5.74 PALETTE
5.74 PALETTE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0092H
0092H
0092H
0092H
This record contains the definition of all user-defined colours available for cell and object formatting. This record is
optional. If it is omitted, a built-in default colour table will be used (see â5.74.3).
5.74.1 Record Contents
Record PALETTE, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Number of following colours (nm). Contains 16 in BIFF3-BIFF4 and 56 in BIFF5-BIFF8.
2
4ânm
List of nm RGB colours (â2.5.4)
5.74.2 Special Built-In Colours
Beside the colours described in a PALETTE record, Excel may use a couple of built-in colours:
Colour index
Resulting colour or internal list index
00H
000000H = EGA Black
01H
FFFFFFH = EGA White
02H
FF0000H = EGA Red
03H
00FF00H = EGA Green
04H
0000FFH = EGA Blue
05H
FFFF00H = EGA Yellow
06H
FF00FFH = EGA Magenta
07H
00FFFFH = EGA Cyan
08H
First colour from user-defined PALETTE record or from default colour table (â5.74.3)
âŽ
âŽ
17H (BIFF3-BIFF4)
Last colour from user-defined PALETTE record or from default colour table (â5.74.3)
3FH (BIFF5-BIFF8)
18H (BIFF3-BIFF4)
System window text colour for border lines (used in records XF â5.115, CFRULE â5.16, and
40H (BIFF5-BIFF8)
WINDOW2 (BIFF8 only), â5.110)
19H (BIFF3-BIFF4)
System window background colour for pattern background (used in records XF, and
41H (BIFF5-BIFF8)
CFRULE)
43H
System face colour (dialogue background colour)
4DH
System window text colour for chart border lines
4EH
System window background colour for chart areas
4FH
Automatic colour for chart border lines (seems to be always Black)
50H
System tool tip background colour (used in note objects)
51H
System tool tip text colour (used in note objects)
7FFFH
System window text colour for fonts (used in records FONT â5.45, FONTCOLOR â5.47,
and CFRULE)
195
5 Worksheet/Workbook Records
5.74.3 Built-In Default Colour Tables
If the workbook does not contain a PALETTE record, Excel uses a built-in colour table. The contents of this colour
table are dependent on the BIFF version.
Default colour table for BIFF3/BIFF4:
Colour Index
Colour
Colour Index
Colour
08H
000000H = EGA Black
10H
800000H = EGA Dark Red
09H
FFFFFFH = EGA White
11H
008000H = EGA Dark Green
0AH
FF0000H = EGA Red
12H
000080H = EGA Dark Blue
0BH
00FF00H = EGA Green
13H
808000H = EGA Olive
0CH
0000FFH = EGA Blue
14H
800080H = EGA Purple
0DH
FFFF00H = EGA Yellow
15H
008080H = EGA Teal
0EH
FF00FFH = EGA Magenta
16H
C0C0C0H = EGA Silver
0FH
00FFFFH = EGA Cyan
17H
808080H = EGA Grey
Default colour table for BIFF5 (colours 08Hâ17H are equal to the BIFF3/BIFF4 default colour table):
Index Colour
Index Colour
Index Colour
Index Colour
Index Colour
08H
000000H
14H
800080H
20H
000080H
2CH
A6CAF0H
38H
1D2FBEH
09H
FFFFFFH
15H
008080H
21H
FF00FFH
2DH
DD9CB3H
39H
286676H
0AH
FF0000H
16H
C0C0C0H
22H
FFFF00H
2EH
B38FEEH
3AH
004500H
0BH
00FF00H
17H
808080H
23H
00FFFFH
2FH
E3E3E3H
3BH
453E01H
0CH
0000FFH
18H
8080FFH
24H
800080H
30H
2A6FF9H
3CH
6A2813H
0DH
FFFF00H
19H
802060H
25H
800000H
31H
3FB8CDH
3DH
85396AH
0EH
FF00FFH
1AH
FFFFC0H
26H
008080H
32H
488436H
3EH
4A3285H
0FH
00FFFFH
1BH
A0E0F0H
27H
0000FFH
33H
958C41H
3FH
424242H
10H
800000H
1CH
600080H
28H
00CFFFH
34H
8E5E42H
11H
008000H
1DH
FF8080H
29H
69FFFFH
35H
A0627AH
12H
000080H
1EH
0080C0H
2AH
E0FFE0H
36H
624FACH
13H
808000H
1FH
C0C0FFH
2BH
FFFF80H
37H
969696H
Default colour table for BIFF8 (colours 08Hâ17H are equal to the BIFF3/BIFF4 default colour table):
Index Colour
Index Colour
Index Colour
Index Colour
Index Colour
08H
000000H
14H
800080H
20H
000080H
2CH
99CCFFH
38H
003366H
09H
FFFFFFH
15H
008080H
21H
FF00FFH
2DH
FF99CCH
39H
339966H
0AH
FF0000H
16H
C0C0C0H
22H
FFFF00H
2EH
CC99FFH
3AH
003300H
0BH
00FF00H
17H
808080H
23H
00FFFFH
2FH
FFCC99H
3BH
333300H
0CH
0000FFH
18H
9999FFH
24H
800080H
30H
3366FFH
3CH
993300H
0DH
FFFF00H
19H
993366H
25H
800000H
31H
33CCCCH
3DH
993366H
0EH
FF00FFH
1AH
FFFFCCH
26H
008080H
32H
99CC00H
3EH
333399H
0FH
00FFFFH
1BH
CCFFFFH
27H
0000FFH
33H
FFCC00H
3FH
333333H
10H
800000H
1CH
660066H
28H
00CCFFH
34H
FF9900H
11H
008000H
1DH
FF8080H
29H
CCFFFFH
35H
FF6600H
12H
000080H
1EH
0066CCH
2AH
CCFFCCH
36H
666699H
13H
808000H
1FH
CCCCFFH
2BH
FFFF99H
37H
969696H
196
5.75 PANE
5.75 PANE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0041H
0041H
0041H
0041H
0041H
This record stores the position of window panes. It is part of the Sheet View Settings Block (â4.5). If the sheet does not
contain any splits, this record will not occur.
A sheet can be split in two different ways, with unfrozen panes or with frozen panes. A flag in the WINDOW2 record
(â5.110) specifies, if the panes are frozen, which affects the contents of this record.
Record PANE, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Position of the vertical split (px, 0 = No vertical split):
Unfrozen pane: Width of the left pane(s) (in twips = 1/20 of a point)
Frozen pane: Number of visible columns in left pane(s)
2
2
Position of the horizontal split (py, 0 = No horizontal split):
Unfrozen pane: Height of the top pane(s) (in twips = 1/20 of a point)
Frozen pane: Number of visible rows in top pane(s)
4
2
Index to first visible row in bottom pane(s)
6
2
Index to first visible column in right pane(s)
8
1
Identifier of pane with active cell cursor (see below)
[9]
1
Not used (BIFF5-BIFF8 only, not written in BIFF2-BIFF4)
If panes are unfrozen, every visible pane may be active. The active pane shows the current selection (which may be
different in each pane) and reacts on cursor movement and other user input. If the panes are frozen, the bottom pane (if
no horizontal split present), right pane (if no vertical split present), or bottom-right pane is always active, regardless of
the cursor position. The correct identifiers for all possible combinations of visible panes are shown in the following
pictures.
px = 0, py = 0
px = 0, py > 0
px > 0, py = 0
px > 0, py > 0
3
3
1
3
3
1
2
2
0
5.76 PASSWORD
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0013H
0013H
0013H
0013H
0013H
This record is part of the worksheet/workbook protection (â4.18). It stores a 16-bit hash value, calculated from the
worksheet or workbook protection password.
Record PASSWORD, BIFF2-BIFF8:
Offset
Size
Contents
0
2
16-bit hash value of the password (â4.18.4)
197
5 Worksheet/Workbook Records
5.77 PHONETICPR
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00EFH
This record contains default settings for the âAsian Phonetic Settingsâ dialog and the addresses of all cells which show
Asian phonetic text.
Record PHONETICPR, BIFF8:
Offset
Size
Contents
0
2
Index to FONT record (â5.45) used for Asian phonetic text of new cells
2
2
Additional settings used for Asian phonetic text of new cells:
Bit
Mask
Contents
1-0
0003H
Type of Japanese phonetic text:
002 = Katakana (narrow)
102 = Hiragana
012 = Katakana (wide)
3-2
000CH
Alignment of all portions of the Asian phonetic text:
002 = Not specified (Japanese only)
102 = Centered
012 = Left (Top for vertical text)
112 = Distributed
5-4
0030H
112 (always set)
4
var.
Cell range address list (â2.5.15) with all cells with visible Asian phonetic text
5.78 PLS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
004DH
004DH
004DH
004DH
004DH
This record is part of the Page Settings Block (â4.4). It stores a binary blob containing internal settings for the current
printer. The binary data is dependent on the current printer and not documented. On import, this record can be ignored.
5.79 PRECISION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000EH
000EH
000EH
000EH
000EH
This record stores if formulas use the real cell values for calculation or the values displayed on the screen. In BIFF2-
BIFF4 this record is part of the Calculation Settings Block (â4.3). In BIFF5-BIFF8 it is stored in the Workbook
Globals Substream.
Record PRECISION, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Use displayed values; 1 = Use real cell values
198
5.80 PRINTGRIDLINES
5.80 PRINTGRIDLINES
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
002BH
002BH
002BH
002BH
002BH
This record stores if sheet grid lines will be printed.
Record PRINTGRIDLINES, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Do not print sheet grid lines; 1 = Print sheet grid lines
5.81 PRINTHEADERS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
002AH
002AH
002AH
002AH
002AH
This record stores if the row and column headers (the areas with row numbers and column letters) will be printed.
Record PRINTHEADERS, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Do not print row/column headers; 1 = Print row/column headers
199
5 Worksheet/Workbook Records
5.82 PROTECT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0012H
0012H
0012H
0012H
0012H
This record is part of the worksheet/workbook protection (â4.18). It specifies whether a worksheet or a workbook is
protected against modification. Protection is not active, if this record is omitted.
Record PROTECT, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Not protected; 1 = Protected
5.83 QUICKTIP
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0800H
This record contains the cell range and text for a tool tip. It occurs in conjunction with the HYPERLINK record for
hyperlinks (â5.58) in the Hyperlink Table (â4.13). This feature is only available in Excel 9.0 (Excel 2000) and later.
Record QUICKTIP, BIFF8:
Offset
Size
Contents
0
2
0800H (repeated record identifier)
2
8
Cell range address of all cells containing the tool tip (â2.5.14)
10
var.
Character array of the tool tip, no Unicode string header, always 16-bit characters, zero-
terminated
5.84 RANGEPROTECTION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0868H
This record is part of the worksheet/workbook protection (â4.18). It stores information about special protected ranges in
a protected sheet. This feature is only available in Excel 10.0 (Excel XP) and later.
Record RANGEPROTECTION, BIFF8:
Offset
Size
Contents
0
2
0868H (repeated record identifier)
2
2do
200
5.85 REFMODE
5.85 REFMODE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
000FH
000FH
000FH
000FH
000FH
This record is part of the Calculation Settings Block (â4.3). It stores which method is used to show cell addresses in
formulas.
⢠The âRCâ mode uses numeric indexes for rows and columns, for example âR(1)C(-1)â, or âR1C1:R2C2â.
⢠The âA1â mode uses characters for columns and numbers for rows, for example âB1â, or â$A$1:$B$2â.
Record REFMODE, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = RC mode; 1 = A1 mode
5.86 RIGHTMARGIN
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0027H
0027H
0027H
0027H
0027H
This record is part of the Page Settings Block (â4.4). It contains the right page margin of the current worksheet.
Record RIGHTMARGIN, BIFF2-BIFF8:
Offset
Size
Contents
0
8
Right page margin in inches (IEEE 754 floating-point value, 64-bit double precision)
5.87 RK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
027EH
027EH
027EH
027EH
This record represents a cell that contains an RK value (encoded integer or floating-point value). If a floating-point value
cannot be encoded to an RK value, a NUMBER record (â5.71) will be written. This record replaces the record
INTEGER (â5.60) written in BIFF2.
Record RK, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
4
RK value (â2.5.5)
201
5 Worksheet/Workbook Records
5.88 ROW
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0008H
0208H
0208H
0208H
0208H
This record contains the properties of a single row in a sheet. Rows and cells in a sheet are divided into blocks of 32
rows. For details about Row Blocks see â4.7.
Record ROW, BIFF2:
Offset
Size
Contents
0
2
Index of this row
2
2
Index to column of the first cell which is described by a cell record
4
2
Index to column of the last cell which is described by a cell record, increased by 1
6
2
Bit
Mask
Contents
14-0
7FFFH
Height of the row, in twips = 1/20 of a point
15
8000H
0 = Row has custom height; 1 = Row has default height
8
2
Not used
10
1
0 = No defaults written; 1 = Default row attribute field and XF index occur below (fl)
11
2
Relative offset to calculate stream position of the first cell record for this row (â4.7.2)
[13]
3
(written only if fl = 1) Default row attributes (â2.5.13)
[16]
2
(written only if fl = 1) Index to XF record (â5.115)
202
5.88 ROW
Record ROW, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Index of this row
2
2
Index to column of the first cell which is described by a cell record
4
2
Index to column of the last cell which is described by a cell record, increased by 1
6
2
Bit
Mask
Contents
14-0
7FFFH
Height of the row, in twips = 1/20 of a point
15
8000H
0 = Row has custom height; 1 = Row has default height
8
2
Not used
10
2
In BIFF3-BIFF4 this field contains a relative offset to calculate stream position of the first
cell record for this row (â4.7.2). In BIFF5-BIFF8 this field is not used anymore, but the
DBCELL record (â5.29) instead.
12
4
Option flags and default row formatting:
Bit
Mask
Contents
2-0
00000007H
Outline level of the row
4
00000010H
1 = Outline group starts or ends here (depending on where
the outline buttons are located, see SHEETPR record,
â5.97), and is collapsed
5
00000020H
1 = Row is hidden (manually, or by a filter or outline group)
6
00000040H
1 = Row height and default font height do not match
7
00000080H
1 = Row has explicit default format (fl)
8
00000100H
Always 1
27-16
0FFF0000H
If fl = 1: Index to default XF record (â5.115)
28
10000000H
1 = Additional space above the row. This flag is set, if the
upper border of at least one cell in this row or if the lower
border of at least one cell in the row above is formatted with
a thick line style. Thin and medium line styles are not taken
into account.
29
20000000H
1 = Additional space below the row. This flag is set, if the
lower border of at least one cell in this row or if the upper
border of at least one cell in the row below is formatted with
a medium or thick line style. Thin line styles are not taken
into account.
30
40000000H
1 = Show phonetic text for all cells in this row (BIFF8 only)
203
5 Worksheet/Workbook Records
5.89 RSTRING
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00D6H
00D6H
This record stores a formatted text cell (Rich-Text). In BIFF8 it is usually replaced by the LABELSST record (â5.100).
Excel still uses this record, if it copies formatted text cells to the clipboard.
Record RSTRING, BIFF5:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
sz
Byte string, 16-bit string length (â2.5.2)
6+sz
1
Number of Rich-Text formatting runs (rt)
7+sz
2¡rt
List of rt formatting runs (â2.5.1)
Record RSTRING, BIFF8:
Offset
Size
Contents
0
2
Index to row
2
2
Index to column
4
2
Index to XF record (â5.115)
6
sz
Unformatted Unicode string, 16-bit string length (â2.5.3)
6+sz
2
Number of Rich-Text formatting runs (rt)
8+sz
4¡rt
List of rt formatting runs (â2.5.1)
5.90 SAVERECALC
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
005FH
005FH
005FH
005FH
This record is part of the Calculation Settings Block (â4.3). It contains the âRecalculate before saveâ option in Excel's
calculation settings dialogue.
Record SAVERECALC, BIFF3-BIFF8:
Offset
Size
Contents
0
2
0 = Do not recalculate; 1 = Recalculate before saving the document
204
5.91 SCENPROTECT
5.91 SCENPROTECT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
00DDH
00DDH
This record is part of the worksheet/workbook protection (â4.18). It determines whether the scenarios of the current
sheet are protected. Scenario protection is not active, if this record is omitted.
Record SCENPROTECT, BIFF5-BIFF8:
Offset
Size
Contents
0
2
0 = Scenarios not protected; 1 = Scenarios protected
5.92 SCL
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
00A0H
00A0H
00A0H
This record stores the magnification of the active view of the current worksheet. In BIFF8 this can be either the normal
view or the page break preview. This is determined in the WINDOW2 record (â5.110). The SCL record is part of the
Sheet View Settings Block (â4.5).
Record SCL, BIFF4-BIFF8:
Offset
Size
Contents
0
2
Numerator of the view magnification fraction (num)
2
2
Denumerator of the view magnification fraction (den)
The magnification is stored as reduced fraction. The magnification results from num/den.
5.93 SELECTION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001DH
001DH
001DH
001DH
001DH
This record contains the addresses of all selected cell ranges and the position of the active cell for a pane in the current
sheet. It is part of the Sheet View Settings Block (â4.5). There is one SELECTION record for each pane in the sheet.
Record SELECTION, BIFF2-BIFF8:
Offset
Size
Contents
0
1
Pane identifier (see PANE record, â5.75)
1
2
Index to row of the active cell
3
2
Index to column of the active cell
5
2
Index into the following cell range list to the entry that contains the active cell
7
var.
Cell range address list containing all selected cell ranges (â2.5.15). Column indexes are
always 8-bit values, also in BIFF8.
205
5 Worksheet/Workbook Records
5.94 SHAREDFMLA â Shared Formula
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
04BCH
04BCH
This record stores the token array of a shared formula. Shared formulas are similar to array formulas, they store a formula
used in a range of cells. The SHAREDFMLA record is not a real cell record, but follows the first FORMULA record
(â5.50) of the cell range. For more information about shared formulas see â4.8.
Record SHAREDFMLA, BIFF5-BIFF8:
Offset
Size
Contents
0
6
Cell range address of the area used by the shared formula (â2.5.14). Column indexes are
always 8-bit values, also in BIFF8.
6
1
Not used
7
1
Number of existing FORMULA records for this shared formula
8
var.
Token array of the shared formula (â3)
5.95 SHEET
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
0085H
0085H
This record is located in the Workbook Globals Substream and represents a sheet inside the workbook. One SHEET
record is written for each sheet. It stores the sheet name and a stream offset to the BOF record (â5.8) of the respective
Sheet Substream within the Workbook Stream.
Record SHEET, BIFF5-BIFF8:
Offset
Size
Contents
0
4
Absolute stream position of the BOF record of the sheet represented by this record. This
field is never encrypted in protected files.
4
1
Sheet state:
0 = Visible
1 = Hidden
2 = âVery hiddenâ. Can only be set programmatically, e.g. with a
Visual Basic macro. It is not possible to make such a sheet visible via
the user interface.
5
1
Sheet type:
00H = Worksheet
02H = Chart
06H = Visual Basic module
6
var.
Sheet name:
BIFF5: Byte string, 8-bit string length (â2.5.2)
BIFF8: Unicode string, 8-bit string length (â2.5.3)
206
5.96 SHEETLAYOUT
5.96 SHEETLAYOUT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0862H
This record stores the colour of the tab below the sheet containing the sheet name. This feature is only available in Excel
10.0 (Excel XP) and later.
Record SHEETLAYOUT, BIFF8:
Offset
Size
Contents
0
2
0862H (repeated record identifier)
2
10
Not used
12
4
Unknown data: 14H 00H 00H 00H
16
2
Colour index (â5.74) for sheet name tab
18
2
Not used
5.97 SHEETPR
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0081H
0081H
0081H
0081H
This record stores a 16-bit value with Boolean options for the current sheet. From BIFF5 on the âSave external linked
valuesâ option is moved to the record BOOKBOOL (â5.9). This record is also used to distinguish standard sheets from
dialogue sheets.
Option flags of record SHEETPR, BIFF3-BIFF8:
Bit
Mask
Contents
0
0001H
0 = Do not show automatic page breaks
1 = Show automatic page breaks
4
0010H
0 = Standard sheet
1 = Dialogue sheet (BIFF5-BIFF8)
5
0020H
0 = No automatic styles in outlines
1 = Apply automatic styles to outlines
6
0040H
0 = Outline buttons above outline group
1 = Outline buttons below outline group
7
0080H
0 = Outline buttons left of outline group
1 = Outline buttons right of outline group
8
0100H
0 = Scale printout in percent (â5.73)
1 = Fit printout to number of pages (â5.73)
9
0200H
0 = Save external linked values
1 = Do not save external linked values
(BIFF3-BIFF4 only, â4.10)
(BIFF3-BIFF4 only, â4.10)
10
0400H
0 = Do not show row outline symbols
1 = Show row outline symbols
11
0800H
0 = Do not show column outline symbols
1 = Show column outline symbols
13-12
3000H
These flags specify the arrangement of windows. They are stored in BIFF4 only.
002 = Arrange windows tiled
012 = Arrange windows horizontal
102 = Arrange windows vertical
112 = Arrange windows cascaded
The following flags are valid for BIFF4-BIFF8 only:
14
4000H
0 = Excel like expression evaluation
1 = Lotus like expression evaluation
15
8000H
0 = Excel like formula editing
1 = Lotus like formula editing
207
5 Worksheet/Workbook Records
5.98 SHEETPROTECTION
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0867H
This record is part of the worksheet/workbook protection (â4.18). It stores additional options for sheet protection.
These settings are only available in Excel 10.0 (Excel XP) and later.
Record SHEETPROTECTION, BIFF8:
Offset
Size
Contents
0
2
0867H (repeated record identifier)
2
9
Not used
11
8
Unknown data: 02H 00H 01H 00H FFH FFH FFH FFH
19
2
Option flags, see below (default: 4400H)
21
2
Not used
The following flags specify, which actions are allowed while the sheet is protected. The state of object and scenario
protection is also contained in the records OBJECTPROTECT (â5.72) and SCENPROTECT (â5.91). These records
are stored for compatibility to Excel 97 and Excel 2000.
Option flags for sheet protection (a set bit specifies that the action is allowed):
Bit
Mask
Contents
Bit
Mask
Contents
0
0001H
Edit objects
8
0100H
Delete columns
1
0002H
Edit scenarios
9
0200H
Delete rows
2
0004H
Change cell formatting
10
0400H
Select locked cells
3
0008H
Change column formatting
11
0800H
Sort a cell range
4
0010H
Change row formatting
12
1000H
Edit auto filters
5
0020H
Insert columns
13
2000H
Edit PivotTables
6
0040H
Insert rows
14
4000H
Select unlocked cells
7
0080H
Insert hyperlinks
208
5.99 SORT
5.99 SORT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
0090H
0090H
This record stores the last settings from the âSortâ dialogue for each sheet. These settings are not attached to a cell range
in the sheet, that means, it is not possible to determine the cell range sorted with the settings of this record.
Record SORT, BIFF5:
Offset
Size
Contents
0
2
Option flags, see below
2
1
Length of first sort key (character count, l1)
3
1
Length of second sort key (character count, l2)
4
1
Length of third sort key (character count, l3)
5
l1
Character array of first sort key
[5+l1]
l2
(optional) Character array of description text
[5+l1+l2]
l3
(optional) Character array of help topic text
var.
1
Not used
Record SORT, BIFF8:
Offset
Size
Contents
0
2
Option flags, see below
2
1
Length of first sort key (character count, l1)
3
1
Length of second sort key (character count, l2)
4
1
Length of third sort key (character count, l3)
5
var.
First sort key (Unicode string without length field, â2.5.3)
[var.]
var.
(optional, only if l2 > 0) Second sort key (Unicode string without length field, â2.5.3)
[var.]
var.
(optional, only if l3 > 0) Third sort key (Unicode string without length field, â2.5.3)
var.
1
Not used
Option flags, BIFF5-BIFF8:
Bit
Mask
Contents
0
0001H
0 = Sort rows (top-to-bottom)
1 = Sort columns (left-to-right)
1
0002H
0 = Sort first key in ascending order
1 = Sort first key in descending order
2
0004H
0 = Sort second key in ascending order
1 = Sort second key in descending order
3
0008H
0 = Sort third key in ascending order
1 = Sort third key in descending order
4
0010H
0 = Sort case-insensitive
1 = Sort case-sensitive
9-5
03E0H
One-based index into the table of defined sort lists, or 0 for sorting without a list
209
5 Worksheet/Workbook Records
5.100 SST â Shared String Table
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
00FCH
This record contains a list of all strings used anywhere in the workbook. Each string occurs only once. The workbook
uses indexes into the list to reference the strings. See â4.11 for more information.
Record SST, BIFF8:
Offset
Size
Contents
0
4
Total number of strings in the workbook (see below)
4
4
Number of following strings (nm)
8
var.
List of nm Unicode strings, 16-bit string length (â2.5.3)
The first field of the SST record counts the total occurrence of strings in the workbook. For instance, the string âAAAâ
is used 3 times and the string âBBBâ is used 2 times. The first field contains 5 and the second field contains 2, followed
by the two strings.
5.101 STANDARDWIDTH
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
0099H
0099H
0099H
This record specifies the default column width for columns that have a set bit in the GCW record (BIFF4-BIFF5,
â5.51), or columns that do not have a corresponding COLINFO record (BIFF8, â5.18).
Record STANDARDWIDTH, BIFF4-BIFF8:
Offset
Size
Contents
4
2
Default width of the columns in 1/256 of the width of the zero character, using default font
(first FONT record in the file)
210
5.102 STRING
5.102 STRING
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0007H
0207H
0207H
0207H
0207H
This record stores the result of a string formula. It occurs directly after a string formula (â5.50).
Record STRING, BIFF2:
Offset
Size
Contents
0
var.
Byte string, 8-bit string length (â2.5.2)
Record STRING, BIFF3-BIFF5:
Offset
Size
Contents
0
var.
Byte string, 16-bit string length (â2.5.2)
In BIFF8 files no STRING record occurs, if the result string is empty.
Record STRING, BIFF8:
Offset
Size
Contents
0
var.
Non-empty Unicode string, 16-bit string length (â2.5.3)
211
5 Worksheet/Workbook Records
5.103 STYLE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0293H
0293H
0293H
0293H
This record stores the name of a user-defined cell style or specific options for a built-in cell style. All STYLE records
occur together behind the XF record list (â5.115). Each STYLE record refers to a style XF record, which contains the
formatting attributes for the cell style.
5.103.1 User-Defined Cell Styles
STYLE record for user-defined cell styles, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Bit
Mask
Contents
11-0
0FFFH
Index to style XF record (â5.115)
15
8000H
Always 0 for user-defined styles
2
var.
BIFF2-BIFF5:
Non-empty byte string, 8-bit string length (â2.5.2)
BIFF8:
Non-empty Unicode string, 16-bit string length (â2.5.3)
5.103.2 Built-In Cell Styles
STYLE record for built-in cell styles, BIFF3-BIFF8:
Offset
Size
Contents
0
2
Bit
Mask
Contents
11-0
0FFFH
Index to style XF record (â5.115)
15
8000H
Always 1 for built-in styles
2
1
Identifier of the built-in cell style:
00H = Normal
05H = Percent
01H = RowLevel_lv (see next field)
06H = Comma [0] (BIFF4-BIFF8)
02H = ColLevel_lv (see next field)
07H = Currency [0] (BIFF4-BIFF8)
03H = Comma
08H = Hyperlink (BIFF8)
04H = Currency
09H = Followed Hyperlink (BIFF8)
3
1
Level for RowLevel or ColLevel style (zero-based, lv), FFH otherwise
The RowLevel and ColLevel styles specify the formatting of subtotal cells in a specific outline level. The level is
specified by the last field in the STYLE record. Valid values are 0âŚ6 for the outline levels 1âŚ7.
212
5.104 TOPMARGIN
5.104 TOPMARGIN
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0028H
0028H
0028H
0028H
0028H
This record is part of the Page Settings Block (â4.4). It contains the top page margin of the current worksheet.
Record TOPMARGIN, BIFF2-BIFF8:
Offset
Size
Contents
0
8
Top page margin in inches (IEEE 754 floating-point value, 64-bit double precision)
5.105 UNCALCED
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
005EH
005EH
005EH
005EH
This record is part of the Calculation Settings Block (â4.3). If it occurs in the Sheet Substream, it indicates that the
formulas have not been recalculated before the document was saved.
Record UNCALCED, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Not used
5.106 USESELFS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
â
â
â
0160H
This record specifies if the formulas in the workbook can use ânatural language formulasâ. This type of formula can refer
to cells by its content or the content of the column or row header cell.
Record USESELFS, BIFF8:
Offset
Size
Contents
0
2
0 = Do not use natural language formulas
1 = Use natural language formulas
213
5 Worksheet/Workbook Records
5.107 VCENTER
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0084H
0084H
0084H
0084H
This record is part of the Page Settings Block (â4.4). It specifies if the sheet is centred vertically when printed.
Record VCENTER, BIFF3-BIFF8:
Offset
Size
Contents
0
2
0 = Print sheet aligned at top page border
1 = Print sheet vertically centred
5.108 VERTICALPAGEBREAKS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
001AH
001AH
001AH
001AH
001AH
This record is part of the Page Settings Block (â4.4). It contains all vertical manual page breaks.
Record VERTICALPAGEBREAKS, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Number of following column indexes (nm)
2
2ânm
List of nm column indexes. Each index specifies the first column after the page break.
Record VERTICALPAGEBREAKS, BIFF8:
Offset
Size
Contents
0
2
Number of following column index structures (nm)
2
6ânm
List of nm column index structures. Each column index structure contains:
Offset
Size
Contents
0
2
Index to first column following the page break
2
2
Index to first row of this page break
4
2
Index to last row of this page break
The column indexes in the lists must be ordered ascending. If in BIFF8 a column contains several page breaks, they must
be ordered ascending by start row index.
214
5.109 WINDOW1
5.109 WINDOW1
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
003DH
003DH
003DH
003DH
003DH
This record contains general settings for the document window and global workbook settings (BIFF5-BIFF8).
Record WINDOW1, BIFF2-BIFF4:
Offset
Size
Contents
0
2
Horizontal position of the document window (in twips = 1/20 of a point)
2
2
Vertical position of the document window (in twips = 1/20 of a point)
4
2
Width of the document window (in twips = 1/20 of a point)
6
2
Height of the document window (in twips = 1/20 of a point)
8
1
0 = Window is visible; 1 = Window is hidden
Record WINDOW1, BIFF5-BIFF8:
Offset
Size
Contents
0
2
Horizontal position of the document window (in twips = 1/20 of a point)
2
2
Vertical position of the document window (in twips = 1/20 of a point)
4
2
Width of the document window (in twips = 1/20 of a point)
6
2
Height of the document window (in twips = 1/20 of a point)
8
2
Option flags:
Bits
Mask
Contents
0
0001H
0 = Window is visible
1 = Window is hidden
1
0002H
0 = Window is open
1 = Window is minimised
3
0008H
0 = Horizontal scroll bar hidden 1 = Horizontal scroll bar visible
4
0010H
0 = Vertical scroll bar hidden
1 = Vertical scroll bar visible
5
0020H
0 = Worksheet tab bar hidden
1 = Worksheet tab bar visible
10
2
Index to active (displayed) worksheet
12
2
Index of first visible tab in the worksheet tab bar
14
2
Number of selected worksheets (highlighted in the worksheet tab bar)
16
2
Width of worksheet tab bar (in 1/1000 of window width). The remaining space is used by the
horizontal scrollbar.
215
5 Worksheet/Workbook Records
5.110 WINDOW2
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
003EH
023EH
023EH
023EH
023EH
This record contains additional settings for the document window (BIFF2-BIFF4) or for the window of a specific
worksheet (BIFF5-BIFF8). It is part of the Sheet View Settings Block (â4.5).
5.110.1 Contents of the WINDOW2 Record
Record WINDOW2, BIFF2:
Offset
Size
Contents
0
1
0 = Show formula results
1 = Show formulas
1
1
0 = Do not show grid lines
1 = Show grid lines
2
1
0 = Do not show sheet headers
1 = Show sheet headers
3
1
0 = Panes are not frozen
1 = Panes are frozen (freeze)
4
1
0 = Show zero values as empty cells
1 = Show zero values
5
2
Index to first visible row
7
2
Index to first visible column
9
1
0 = Use manual grid line colour (below)
1 = Use automatic grid line colour
10
4
Grid line RGB colour (â2.5.4)
Record WINDOW2, BIFF3-BIFF5:
Offset
Size
Contents
0
2
Option flags (see below)
2
2
Index to first visible row
4
2
Index to first visible column
6
4
Grid line RGB colour (â2.5.4)
Record WINDOW2, BIFF8:
Offset
Size
Contents
0
2
Option flags (see below)
2
2
Index to first visible row
4
2
Index to first visible column
6
2
Colour index of grid line colour (â5.74). Note that in BIFF2-BIFF5 an RGB colour is
written instead.
8
2
Not used
10
2
Cached magnification factor in page break preview (in percent); 0 = Default (60%)
12
2
Cached magnification factor in normal view (in percent); 0 = Default (100%)
14
4
Not used
In BIFF8 this record stores used magnification factors for page break preview and normal view. These values are used to
restore the magnification, when the view is changed. The real magnification of the currently active view is stored in the
SCL record (â5.92). The type of the active view is stored in the option flags field (see below).
216
5.110 WINDOW2
5.110.2 Option Flags
Option flags, BIFF3-BIFF8:
Bits
Mask
Contents
0
0001H
0 = Show formula results
1 = Show formulas
1
0002H
0 = Do not show grid lines
1 = Show grid lines
2
0004H
0 = Do not show sheet headers
1 = Show sheet headers
3
0008H
0 = Panes are not frozen
1 = Panes are frozen (freeze)
4
0010H
0 = Show zero values as empty cells
1 = Show zero values
5
0020H
0 = Manual grid line colour
1 = Automatic grid line colour
6
0040H
0 = Columns from left to right
1 = Columns from right to left
7
0080H
0 = Do not show outline symbols
1 = Show outline symbols
8
0100H
0 = Keep splits if pane freeze is removed
1 = Remove splits if pane freeze is removed
9
0200H
0 = Sheet not selected
1 = Sheet selected (BIFF5-BIFF8)
10
0400H
0 = Sheet not active
1 = Sheet active (BIFF5-BIFF8)
11
0800H
0 = Show in normal view
1 = Show in page break preview (BIFF8)
The freeze flag specifies, if a following PANE record (â5.75) describes unfrozen or frozen panes.
5.111 WINDOWPROTECT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0019H
0019H
0019H
0019H
0019H
This record is part of the worksheet/workbook protection (â4.18). It determines whether the window configuration of
this document is protected. Window protection is not active, if this record is omitted.
Record WINDOWPROTECT, BIFF2-BIFF8:
Offset
Size
Contents
0
2
0 = Window settings not protected; 1 = Window settings protected
217
5 Worksheet/Workbook Records
5.112 WRITEACCESS
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
005CH
005CH
005CH
005CH
This record is part of the File Protection Block (â4.19). It contains the name of the user that has saved the file. The user
name is always stored as an equal-sized string. All unused characters after the name are filled with space characters. It is
not required to write the mentioned string length. Every other length will be accepted too.
Record WRITEACCESS, BIFF3-BIFF4:
Offset
Size
Contents
0
32
User name, byte string, 8-bit string length, 31 characters (â2.5.2)
Record WRITEACCESS, BIFF5:
Offset
Size
Contents
0
54
User name, byte string, 8-bit string length, 53 characters (â2.5.2)
Record WRITEACCESS, BIFF8:
Offset
Size
Contents
0
var.
User name, Unicode string, 16-bit string length, 109 characters (â2.5.3)
5.113 WRITEPROT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0086H
0086H
0086H
0086H
This record is part of the File Protection Block (â4.19). It does not contain any data. If present it specifies that the file is
write protected. The write protection password is stored in the FILESHARING record (â5.44).
5.114 XCT â CRN Count
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
â
0059H
0059H
0059H
0059H
This record stores the number of immediately following CRN records. These records are used to store the cell contents
of external references. See â4.10 for details about external references.
Record XCT, BIFF3-BIFF5:
Offset
Size
Contents
0
2
Number of following CRN records (â5.23)
Record XCT, BIFF8:
Offset
Size
Contents
0
2
Number of following CRN records (â5.23)
2
2
Index into sheet table of the involved EXTERNALBOOK record (â5.38)
218
5.115 XF â Extended Format
5.115 XF â Extended Format
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
0043H
0243H
0443H
00E0H
00E0H
This record contains formatting information for cells, rows, columns or styles.
5.115.1 XF Substructures
From BIFF3 on, some of the elements occur unchanged in every BIFF version. These elements are described in the
following using a specific name for each element. In the description of the record structure the names are used to
reference to these tables.
⢠XF_TYPE_PROT â XF Type and Cell Protection (3 Bits), BIFF3-BIFF8
These 3 bits are part of a specific data byte.
Bit
Mask
Contents
0
01H
1 = Cell is locked
1
02H
1 = Formula is hidden
2
04H
0 = Cell XF; 1 = Style XF
⢠XF_USED_ATTRIB â Attributes Used from Parent Style XF (6 Bits), BIFF3-BIFF8
Each bit describes the validity of a specific group of attributes. In cell XFs a cleared bit means the attributes of the
parent style XF are used (but only if the attributes are valid there), a set bit means the attributes of this XF are used. In
style XFs a cleared bit means the attribute setting is valid, a set bit means the attribute should be ignored.
Bit
Mask
Contents
0
01H
Flag for number format
1
02H
Flag for font
04H
Flag for horizontal and vertical alignment, text wrap, indentation, orientation, rotation, and
2
text direction
3
08H
Flag for border lines
4
10H
Flag for background area style
5
20H
Flag for cell protection (cell locked and formula hidden)
⢠XF_HOR_ALIGN â Horizontal Alignment (3 Bits), BIFF2-BIFF8
The horizontal alignment consists of 3 bits and is part of a specific data byte.
Value
Horizontal alignment
0
General
1
Left
2
Centred
3
Right
4
Filled
5
Justified (BIFF4-BIFF8)
6
Centred across selection (BIFF4-BIFF8)
7
Distributed (BIFF8, available in Excel 10.0 (Excel XP) and later only)
219
5 Worksheet/Workbook Records
⢠XF_VERT_ALIGN â Vertical Alignment (2 or 3 Bits), BIFF4-BIFF8
The vertical alignment consists of 2 bits (BIFF4) or 3 bits (BIFF5-BIFF8) and is part of a specific data byte. Vertical
alignment is not available in BIFF2 and BIFF3.
Value
Vertical alignment
0
Top
1
Centred
2
Bottom
3
Justified (BIFF5-BIFF8)
4
Distributed (BIFF8, available in Excel 10.0 (Excel XP) and later only)
⢠XF_ORIENTATION â Text Orientation (2 Bits), BIFF4-BIFF5
In the BIFF versions BIFF4-BIFF5, text can be rotated in steps of 90 degrees or stacked. The orientation mode consists
of 2 bits and is part of a specific data byte. In BIFF8 a rotation angle occurs instead of these flags.
Value
Text orientation
0
Not rotated
1
Letters are stacked top-to-bottom, but not rotated
2
Text is rotated 90 degrees counterclockwise
3
Text is rotated 90 degrees clockwise
⢠XF_ROTATION â Text Rotation Angle (1 Byte), BIFF8
Value
Text rotation
0
Not rotated
1-90
1 to 90 degrees counterclockwise
91-180
1 to 90 degrees clockwise
255
Letters are stacked top-to-bottom, but not rotated
⢠XF_BORDER_34 â Cell Border Style (4 Bytes), BIFF3-BIFF4
Cell borders contain a line style and a line colour for each line of the border.
Bit
Mask
Contents
2-0
00000007H
Top line style (â2.5.11)
7-3
000000F8H
Colour index (â5.74) for top line colour
10-8
00000700H
Left line style (â2.5.11)
15-11
0000F800H
Colour index (â5.74) for left line colour
18-16
00070000H
Bottom line style (â2.5.11)
23-19
00F80000H
Colour index (â5.74) for bottom line colour
26-24
07000000H
Right line style (â2.5.11)
31-27
F8000000H
Colour index (â5.74) for right line colour
220
5.115 XF â Extended Format
⢠XF_AREA_34 â Cell Background Area Style (2 Bytes), BIFF3-BIFF4
A cell background area style contains an area pattern and a foreground and background colour.
Bit
Mask
Contents
5-0
003FH
Fill pattern (â2.5.12)
10-6
07C0H
Colour index (â5.74) for pattern colour
15-11
F800H
Colour index (â5.74) for pattern background
5.115.2 XF Record Contents
Record XF, BIFF2:
Offset
Size
Contents
0
1
Index to FONT record (â5.45)
1
1
Not used
2
1
Number format and cell flags:
Bit
Mask
Contents
5-0
3FH
Index to FORMAT record (â5.49)
6
40H
1 = Cell is locked
7
80H
1 = Formula is hidden
3
1
Horizontal alignment, border style, and background:
Bit
Mask
Contents
2-0
07H
XF_HOR_ALIGN â Horizontal alignment (see above)
3
08H
1 = Cell has left black border
4
10H
1 = Cell has right black border
5
20H
1 = Cell has top black border
6
40H
1 = Cell has bottom black border
7
80H
1 = Cell has shaded background
Record XF, BIFF3:
Offset
Size
Contents
0
1
Index to FONT record (â5.45)
1
1
Index to FORMAT record (â5.49)
2
1
XF_TYPE_PROT â XF type and cell protection (see above)
3
1
Flags for used attribute groups:
Bit
Mask
Contents
7-2
FCH
XF_USED_ATTRIB â Used attributes (see above)
4
2
Horizontal alignment, text break, parent style XF:
Bit
Mask
Contents
2-0
0007H
XF_HOR_ALIGN â Horizontal alignment (see above)
3
0008H
1 = Text is wrapped at right border
15-4
FFF0H
Index to parent style XF (always FFFH in style XFs)
6
2
XF_AREA_34 â Cell background area (see above)
8
4
XF_BORDER_34 â Cell border lines (see above)
221
5 Worksheet/Workbook Records
Record XF, BIFF4:
Offset
Size
Contents
0
1
Index to FONT record (â5.45)
1
1
Index to FORMAT record (â5.49)
2
2
XF type, cell protection, and parent style XF:
Bit
Mask
Contents
2-0
0007H
XF_TYPE_PROT â XF type, cell protection (see above)
15-4
FFF0H
Index to parent style XF (always FFFH in style XFs)
4
1
Alignment, text break, and text orientation:
Bit
Mask
Contents
2-0
07H
XF_HOR_ALIGN â Horizontal alignment (see above)
3
08H
1 = Text is wrapped at right border
5-4
30H
XF_VERT_ALIGN â Vertical alignment (see above)
7-6
C0H
XF_ORIENTATION â Text orientation (see above)
5
1
Flags for used attribute groups:
Bit
Mask
Contents
7-2
FCH
XF_USED_ATTRIB â Used attributes (see above)
6
2
XF_AREA_34 â Cell background area (see above)
8
4
XF_BORDER_34 â Cell border lines (see above)
222
5.115 XF â Extended Format
Record XF, BIFF5:
Offset
Size
Contents
0
2
Index to FONT record (â5.45)
2
2
Index to FORMAT record (â5.49)
4
2
XF type, cell protection, and parent style XF:
Bit
Mask
Contents
2-0
0007H
XF_TYPE_PROT â XF type, cell protection (see above)
15-4
FFF0H
Index to parent style XF (always FFFH in style XFs)
6
1
Alignment and text break:
Bit
Mask
Contents
2-0
07H
XF_HOR_ALIGN â Horizontal alignment (see above)
3
08H
1 = Text is wrapped at right border
6-4
70H
XF_VERT_ALIGN â Vertical alignment (see above)
7
1
Text orientation and flags for used attribute groups:
Bit
Mask
Contents
1-0
03H
XF_ORIENTATION â Text orientation (see above)
7-2
FCH
XF_USED_ATTRIB â Used attributes (see above)
8
4
Cell border lines and background area:
Bit
Mask
Contents
6-0
0000007FH
Colour index (â5.74) for pattern colour
13-7
00003F80H
Colour index (â5.74) for pattern background
21-16
003F0000H
Fill pattern (â2.5.12)
24-22
01C00000H
Bottom line style (â2.5.11)
31-25
FE000000H
Colour index (â5.74) for bottom line colour
12
4
Bit
Mask
Contents
2-0
00000007H
Top line style (â2.5.11)
5-3
00000038H
Left line style (â2.5.11)
8-6
000001C0H
Right line style (â2.5.11)
15-9
0000FE00H
Colour index (â5.74) for top line colour
22-16
007F0000H
Colour index (â5.74) for left line colour
29-23
3F800000H
Colour index (â5.74) for right line colour
223
5 Worksheet/Workbook Records
Record XF, BIFF8:
Offset
Size
Contents
0
2
Index to FONT record (â5.45)
2
2
Index to FORMAT record (â5.49)
4
2
XF type, cell protection, and parent style XF:
Bit
Mask
Contents
2-0
0007H
XF_TYPE_PROT â XF type, cell protection (see above)
15-4
FFF0H
Index to parent style XF (always FFFH in style XFs)
6
1
Alignment and text break:
Bit
Mask
Contents
2-0
07H
XF_HOR_ALIGN â Horizontal alignment (see above)
3
08H
1 = Text is wrapped at right border
6-4
70H
XF_VERT_ALIGN â Vertical alignment (see above)
7
80H
1 = Justify last line in justified or distibuted text
7
1
XF_ROTATION: Text rotation angle (see above)
8
1
Indentation, shrink to cell size, and text direction:
Bit
Mask
Contents
3-0
0FH
Indent level
4
10H
1 = Shrink content to fit into cell
7-6
C0H
Text direction:
0 = According to context35; 1 = Left-to-right; 2 = Right-to-left
9
1
Flags for used attribute groups:
Bit
Mask
Contents
7-2
FCH
XF_USED_ATTRIB â Used attributes (see above)
10
4
Cell border lines and background area:
Bit
Mask
Contents
3-0
0000000FH
Left line style (â2.5.11)
7-4
000000F0H
Right line style (â2.5.11)
11-8
00000F00H
Top line style (â2.5.11)
15-12
0000F000H
Bottom line style (â2.5.11)
22-16
007F0000H
Colour index (â5.74) for left line colour
29-23
3F800000H
Colour index (â5.74) for right line colour
30
40000000H
1 = Diagonal line from top left to right bottom
31
80000000H
1 = Diagonal line from bottom left to right top
14
4
Bit
Mask
Contents
6-0
0000007FH
Colour index (â5.74) for top line colour
13-7
00003F80H
Colour index (â5.74) for bottom line colour
20-14
001FC000H
Colour index (â5.74) for diagonal line colour
24-21
01E00000H
Diagonal line style (â2.5.11)
31-26
FC000000H
Fill pattern (â2.5.12)
18
2
Bit
Mask
Contents
6-0
007FH
Colour index (â5.74) for pattern colour
13-7
3F80H
Colour index (â5.74) for pattern background
35 Left-to-right, if the text starts with a character from a left-to-right script, or right-to-left, if the text starts with a character from a
right-to-left script.
224
6 Drawing Objects
6
Drawing Objects
2do
225
7 Charts
7
Charts
7.1 Document Integration
This chapter describes how a chart is integrated into a spreadsheet document.
7.1.1 Chart Document (BIFF2-BIFF4)
Definition: Chart document
A BIFF2-BIFF4 chart document is a special type of a worksheet document (â2.1.2) that contains exactly one
chart. The default file extension of chart documents is âXLCâ.
The source data may be embedded in the chart or linked to another worksheet document.
Definition: Chart Stream
The entire chart document consists of the Chart Stream (similar to the Worksheet Stream in a regular worksheet
document, â2.3.3, â4.1.1). The BOF record of the stream contains the type identifier of a chart stream.
Records in the Chart Stream, BIFF2-BIFF4:
â
BOF
Type = chart (â5.8)
Chart records
â
EOF
â5.37
226
7.1 Document Integration
7.1.2 Chart Sheet in Workbook Document (BIFF5-BIFF8)
Besides other sheets, a workbook document (â2.1.3) may contain several chart sheets.
Definition: Chart Substream
Each chart sheet is stored in a Chart Substream. This is a special type of a Sheet Substream (â2.3.4, â4.1.2)
with a BOF record containing the type identifier for a chart.
Records in the Workbook Stream (â2.3.3) containing a Chart Substream, BIFF5-BIFF8:
â
BOF
Type = workbook globals (â5.8)
Global workbook records
â
EOF
â5.37
ââ
Other Sheet Substreams (or Chart Substreams)
â
BOF
Type = chart (â5.8)
Chart records
â
EOF
â5.37
ââ
Other Sheet Substreams (or Chart Substreams)
BIFF2-BIFF4 Chart Streams and BIFF5-BIFF8 Chart Substreams are nearly identical in their internal structure.
7.1.3 Embedded Chart Object (BIFF3-BIFF8)
From BIFF3 on, all types of sheets (including chart sheets) may contain embedded chart objects. The chart is described
by a Chart Substream (â7.1.2) which is embedded into another Sheet Substream or Worksheet Stream and follows an
OBJ record.
Records in the Worksheet Stream containing a Chart Substream of an embedded chart object, BIFF3-BIFF4:
â
BOF
Type = sheet, dialogue, chart, macro sheet (â5.8)
Sheet records
â
OBJ
Object description for the chart
â
BOF
Type = chart (â5.8)
Chart records
â
EOF
End of the Chart Substream of the chart object (â5.37)
Sheet records
â
EOF
End of the Sheet Substream (â5.37)
227
7 Charts
Records in the Workbook Stream containing a Chart Substream of an embedded chart object, BIFF5-BIFF8:
â
Workbook Globals Substream
ââ
Other Sheet Substreams (or Chart Substreams)
â
BOF
Type = sheet, dialogue, chart, macro sheet (â5.8)
Sheet records
â
OBJ
Object description for the chart
â
BOF
Type = chart (â5.8)
Chart records
â
EOF
End of the Chart Substream of the chart object (â5.37)
Sheet records
â
EOF
End of the Sheet Substream (â5.37)
ââ
Other Sheet Substreams (or Chart Substreams)
In BIFF5-BIFF8, simple drawing objects may be embedded into chart objects. In that case, the records describing the
drawing objects are embedded into the Chart Substream of the chart object. It is not possible to embed charts and OLE
objects into chart objects (this includes ActiveX form controls).
228
7.2 General Chart Structure
7.2 General Chart Structure
7.2.1 Chart Stream or Substream
All objects a chart is made of are organised in a strict hierarchy which is also reflected in the file format. The Chart
(Sub)stream consists of page settings (similar to a regular Sheet Substream) followed by the chart description. Each
chart contains a list of data series information (a list of values for the data points, and formatting information for the
series and the data points), and additional information about all axes, series groupings, chart type, legend, data table, and
so on.
Structure of the Chart Substream, BIFF5-BIFF8:
â
BOF
Type = chart (â5.8)
â
Page Settings Block
â4.4
â
Worksheet Protection Block
â4.18 (without SCENPROTECT record)
â
Global Chart Block
â7.2.3
â
DIMENSION
â5.35
â
Worksheet View Settings Block
â4.5 (WINDOW2 and SCL records only)
â
EOF
â5.37
7.2.2 Chart Record Block
The chart stream contains blocks of records describing specific details of the chart. All record blocks are embedded into
other record blocks up to and including the Global Chart Block (â7.2.3) which represents the entire chart and is stored
in the Chart (Sub)stream (â7.2.1).
Definition: Chart record block
A chart record block is a group of records in the Chart (Sub)stream that describes a specific object or other
specific data in the chart. A block consists of one or more header records (in a fixed order) and the inner block
records which are enclosed into special block-start and block-end records. A chart record block may contain
other embedded chart record blocks.
Structure of a chart record block:
ââ
Block header record(s)
â
CHBEGIN
Begin of chart record block (â7.8)
â
Embedded block records
â
CHEND
End of chart record block (â7.9)
It is possible to have an empty block that consists of the header records only, or that consists of the header records
followed by an empty pair of CHBEGIN and CHEND records.
Chart record blocks are named according to their (first) header record.
Example: The chart record block that describes a text object is led by a CHTEXT record. Therefore the chart
record block is called âCHTEXT Blockâ.
229
7 Charts
7.2.3 Global Chart Block
2do
230
7.3 Common Record Blocks
7.3 Common Record Blocks
7.3.1 CHPICFORMAT Block (BIFF5)
The CHPICFORMAT Block describes a bitmap texture used to fill the area of a chart object.
Structure of the CHPICFORMAT Block, BIFF5:
â
CHPICFORMAT
â
CHBEGIN
â7.8
â
â
IMDATA
â
CHEND
â7.9
7.3.2 CHESCHERFORMAT Block (BIFF8)
The CHESCHERFORMAT Block describes a complex area format (colour gradients with and without transparence,
hatches, or bitmap textures).
Structure of the CHESCHERFORMAT Block, BIFF8:
â
CHESCHERFORMAT
â
CHBEGIN
â7.8
â
â
CHPICFORMAT
â
CHEND
â7.9
7.3.3 CHFRAME Block
The CHFRAME Block describes the border and area formatting of a frame. A frame is a rectangular object in the chart,
for instance a text object, the legend, or even the chart itself. The CHFRAME Block does not include positioning infor-
mation for the frame.
Structure of the CHFRAME Block:
â
CHFRAME
â7.10
â
CHBEGIN
â7.8
â
CHLINEFORMAT
â7.11
â
CHAREAFORMAT
â7.6
â
CHPICFORMAT Block
BIFF5 only, â7.3.1
â
CHESCHERFORMAT Block BIFF8 only, â7.3.2
â
CHEND
â7.9
231
7 Charts
7.3.4 CHSOURCELINK Block
The CHSOURCELINK Block contains the link to source data in a sheet. It is used to specify the source data for data
series (values, category names, series title, bubble sizes), to specify a fixed string for a text box (chart title, axis titles),
or to link such a text box to a cell in the document.
⢠Linked Cell Range or Cell Range List
Structure of the CHSOURCELINK Block for linked ranges:
â
CHSOURCELINK
â7.12
â
CHBEGIN
(BIFF3-BIFF4 only) â7.8
â
ââ CHMULTILINK
(BIFF3-BIFF4 only)
â
CHEND
(BIFF3-BIFF4 only) â7.9
⢠Text Box or Series Title
If this block is used for a text box or series title, the CHSTRING record contains the fixed string data, if not linked, or
the last received string data from the link. The block block does not contain CHBEGIN and CHEND records. If there is
no text, the CHSTRING record will be omitted.
Structure of the CHSOURCELINK Block for a fixed text or a link to a single text cell:
â
CHSOURCELINK
â7.12
â
CHSTRING
â7.13
7.3.5 CHTEXT Block
The CHTEXT Block describes position, formatting, and contents of a text box in the chart, for instance the chart title,
axis titles, the legend, or data point labels.
Structure of the CHTEXT Block:
â
CHTEXT
â
CHBEGIN
â7.8
â
CHPOS
â
CHFONT
â
CHFORMATRUNS
â
CHSOURCELINK Block
â7.3.4
â
CHFRAME Block
â7.3.3
â
CHOBJECTLINK
â
CHEND
â7.9
232
7.3 Common Record Blocks
7.3.6 CHDEFAULTTEXT Block
The CHDEFAULTTEXT Block defines default formatting attributes for specific text boxes in the chart. The formatting
information from this block is used if no CHTEXT Block exists for a text box. This block contains two header records,
the CHDEFAULTTEXT record and the CHTEXT record.
Structure of the CHDEFAULTTEXT Block:
â
CHDEFAULTTEXT
â
CHTEXT Block
â7.3.5
7.3.7 CHAXISLINE Block
2do
233
7 Charts
7.4 Record Overview, Ordered by Identifier
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
1004H
CHSOURCELINK
â
â
â
1007H
CHLINEFORMAT
â
â
â
â
â
100DH
CHSTRING
â
â
â
â
â
100AH
CHAREAFORMAT
â
â
â
â
â
1021H
CHAXISLINE
â
â
â
â
â
1032H
CHFRAME
â
â
â
â
â
1033H
CHBEGIN
â
â
â
â
â
1034H
CHEND
â
â
â
â
â
103BH
CHMULTILINK
â
â
1051H
CHSOURCELINK
â
â
234
7.5 Record Overview, Ordered by Name
7.5 Record Overview, Ordered by Name
Occurs in BIFF versions
Record ID
Record name
2
3
4
5
8
100AH
CHAREAFORMAT
â
â
â
â
â
1021H
CHAXISLINE
â
â
â
â
â
1033H
CHBEGIN
â
â
â
â
â
1034H
CHEND
â
â
â
â
â
1032H
CHFRAME
â
â
â
â
â
1007H
CHLINEFORMAT
â
â
â
â
â
103BH
CHMULTILINK
â
â
1004H 1051H
CHSOURCELINK
â
â
â
â
â
100DH
CHSTRING
â
â
â
â
â
235
7 Charts
7.6 CHAREAFORMAT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
100AH
100AH
100AH
100AH
100AH
This record describes the formatting attributes of the area of a chart object.
Record CHAREAFORMAT, BIFF2-BIFF5:
Offset
Size
Contents
0
4
RGB colour of the pattern (â2.5.4)
4
4
RGB colour of the pattern background (â2.5.4)
8
2
Fill pattern (â2.5.12)
10
2
Additional flags:
Bit
Mask
Contents
0
0001H
1 = Automatic area format, ignore all other fields above
1
0002H
1 = Exchange pattern colours for negative data points
Record CHAREAFORMAT, BIFF8:
Offset
Size
Contents
0
4
Not used (Excel writes RGB colour of the pattern, but ignores it on import)
4
4
Not used (Excel writes RGB colour of the pattern background, but ignores it on import)
8
2
Fill pattern (â2.5.12)
10
2
Additional flags (see above)
12
2
Colour index (â5.74) for pattern colour
14
2
Colour index (â5.74) for pattern background
236
7.7 CHAXISLINE
7.7 CHAXISLINE
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1021H
1021H
1021H
1021H
1021H
2do
237
7 Charts
7.8 CHBEGIN â Begin of Block
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1033H
1033H
1033H
1033H
1033H
This record has no content. It indicates the begin of a chart record block (â7.2.2).
238
7.9 CHEND â End of Block
7.9 CHEND â End of Block
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1034H
1034H
1034H
1034H
1034H
This record has no content. It indicates the end of a chart record block (â7.2.2).
239
7 Charts
7.10 CHFRAME
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1032H
1032H
1032H
1032H
1032H
This record is the header record of a CHFRAME Block (â7.3.3) that describes the border and area formatting of a chart
object.
Record CHFRAME, BIFF2-BIFF8:
Offset
Size
Contents
0
2
Frame format: 0 = Standard, 4 = Shadowed
2
2
Option flags:
Bit
Mask
Contents
0
0001H
1 = Frame size is calculated automatically
1
0002H
1 = Frame position is calculated automatically
240
7.11 CHLINEFORMAT
7.11 CHLINEFORMAT
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1007H
1007H
1007H
1007H
1007H
This record describes the formatting attributes of a line or a border.
Record CHLINEFORMAT, BIFF2-BIFF5:
Offset
Size
Contents
0
4
RGB colour of the line (â2.5.4)
4
2
Line pattern:
0000H = Solid
0005H = None (invisible)
0001H = Dashed
0006H = 25% grey pattern
0002H = Dotted
0007H = 50% grey pattern
0003H = Dash-dotted
0008H = 75% grey pattern
0004H = Dash-dot-dotted
6
2
Line weight:
FFFFH = Hairline (BIFF3-BIFF8 only)
0000H = Thin
0001H = Medium
0002H = Thick
8
2
Additional flags:
Bit
Mask
Contents
0
0001H
1 = Automatic line format, ignore all other fields above
2
0004H
1 = Axis is enabled (only used in CHAXISLINE Block, â7.3.7)
Record CHLINEFORMAT, BIFF8:
Offset
Size
Contents
0
4
Not used (Excel writes RGB colour of the line, but ignores it on import)
4
2
Line pattern (see above)
6
2
Line weight (see above)
8
2
Additional flags (see above)
10
2
Colour index (â5.74) for line colour
241
7 Charts
7.12 CHSOURCELINK
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
1004H
1004H
1004H
1051H
1051H
This record links a chart object to cells in a sheet. It is used to specify the source of data series or to link text boxes (for
instance the chart title) to a cell. The record is always part of a CHSOURCELINK Block (â7.3.4).
Record CHSOURCELINK, BIFF2-BIFF4:
2do
Record CHSOURCELINK, BIFF5-BIFF8:
Offset
Size
Contents
0
1
Link target:
0 = Series title or text box
2 = Category names for a series
1 = Values for a series
3 = Bubble size values (BIFF8)
1
1
Link type:
0 = No link present, use generated default values
1 = Constant text or values
2 = Linked to worksheet
2
2
Option flags:
Flag
Mask
Contents
0
0001H
0 = Number format linked to data source
1 = Custom number format (see number format field below)
4
2
Index to NUMBER record (â5.49), if target does not use the number format from source
6
var.
Formula data for the link (RPN token array, â3)
242
7.13 CHSTRING
7.13 CHSTRING
BIFF2
BIFF3
BIFF4
BIFF5
BIFF8
100DH
100DH
100DH
100DH
100DH
This record contains the category name of a series, or the text for a text box in the chart, for instance the chart title, axis
titles, or data point labels. It is always part of a CHSOURCELINK Block (â7.3.4).
Record CHSTRING, BIFF2-BIFF5:
Offset
Size
Contents
0
2
Not used
2
var.
Non-empty byte string, 8-bit string length (â2.5.2)
Record CHSTRING, BIFF8:
Offset
Size
Contents
0
2
Not used
2
var.
Non-empty Unicode string, 8-bit string length (â2.5.3)
243
8 PivotTables
8
PivotTables
2do
8.0.1 Record Order in a PivotTable Cache Stream
â
SXDB
â
SXDBEX
â
SXFIELD
â
SXDBTYPE
SXDOUBLE
SXBOOLEAN
ââ
SXERROR
ââ SXSTRING
SXDATETIME
SXEMPTY
ââ SXINDEXLIST
â
EOF
8.0.2 Record Order in a PivotTable
â
SXVIEW
â
SXVD
ââ ââ SXVI
â
SXVDEX
â
SXIVD
â
SXIVD
â
SXPI
ââ SXDI
â
SXLI
â
SXLI
â
SXEX
244
9 Change Tracking
9
Change Tracking
2do
245
10 Workspace Documents
10
Workspace Documents
2do
10.1 Workspace Stream
10.1.1 Workbook Stream (BIFF4W)
The whole BIFF4W workbook file consists of the Workbook Stream. It contains the global workbook data in the
Workbook Globals Substream, and a list of worksheets, the Sheet Substreams.
The Workbook Globals Substream contains common information about the workbook, for instance text encoding, global
view settings or a list of all sheet names. Additionally each workbook holds a SHEETSOFFSET record.
The data of the sheets is stored in Sheet Substreams, which are embedded in the Workbook Globals Substream. Each
substream is preceded with a SHEETHDR record which contains the name of the sheet and the size of the following
substream. The SHEETSOFFSET record mentioned above contains the stream position of the first SHEETHDR record.
Each substream is a complete BIFF4 Worksheet Stream (â4.1.1).
Common structure of the Workspace Stream, BIFF4W:
â
BOF
Type = workbook globals
Global workbook records
â
SHEETSOFFSET
Position of the first SHEETHDR record (â10.5)
Global workbook records
â
SHEETHDR Sheet name, length of following substream (â10.4)
â
BOF
Type = sheet, chart, macro sheet
ââ ââ
Embedded BIFF4 Sheet Substream, â4.1.1
â
EOF
â
EOF
Structure of the Worksheet Protection Block, BIFF4W:
â
PROTECT
Worksheet contents: 1 = protected (â5.82)
â
WINDOWPROTECT
Window settings: 1 = protected (â5.111)
â
OBJECTPROTECT
Embedded objects: 1 = protected (â5.72)
â
SCENPROTECT
Scenarios: 1 = protected (â5.91)
â
PASSWORD
Hash value of the password; 0 = no password (â5.76)
246
10.1 Workspace Stream
Structure of the Workbook Protection Block, BIFF4W:
â
WINDOWPROTECT
Window settings: 1 = protected (â5.111)
â
PROTECT
Workbook contents: 1 = protected (â5.82)
â
OBJECTPROTECT
Embedded objects: 1 = protected (â5.72)
â
PASSWORD
Hash value of the password; 0 = no password (â5.76)
â
PROT4REV
Shared workbook: 1 = protected
â
PROT4REVPASS
Hash value of the shared password; 0 = no password
247
10 Workspace Documents
10.2 Overview, Ordered by Record Identifier
Occurs in BIFF versions
Record ID
Record name
3W
4W
5W
7W
8W
0085H
SHEET
â
008EH
SHEETSOFFSET
â
008FH
SHEETHDR
â
248
10.3 INDEX
10.3 INDEX
BIFF3W BIFF4W BIFF5W BIFF8W
â
020BH
???
???
2do
This record stores the range of used rows and stream positions of several records of the current sheet. In particular the
position of the first DEFINEDNAME record and XF record is stored (BIFF2-BIFF4) and the position of a specific
record in each Row Block (the first ROW record in BIFF2-BIFF4, and the DBCELL record in BIFF5-BIFF8). This
stream position array also contains stream offsets to empty Row Blocks, they will point to the next extant Row Block.
The number of entries nm in this array can be calculated from the row range given in this record (rf is the index to the
first used row, rl is the index to the first row of unused tail of sheet): nm = (rl â rf â 1) / 32 + 1 (using integer
division).
For details about Row Blocks in a worksheet see â4.7.
Record INDEX, BIFF4W:
Offset
Size
Contents
0
4
Stream position of the first DEFINEDNAME record (â5.33). The offset is relative to the
starting position of the SHEETHDR record (â10.4) of the current sheet.
4
2
Index to first used row (rf, 0-based)
6
2
Index to first row of unused tail of sheet (rl, last used row + 1, 0-based)
8
4
Stream position of the first XF record (â5.115). The offset is relative to the starting
position of the SHEETHDR record (â10.4) of the current sheet.
12
4ânm
Array of nm stream positions to first ROW record (â5.88) of each Row Block. The offsets
are relative to the starting position of the SHEETHDR record (â10.4) of the current sheet.
249
10 Workspace Documents
10.4 SHEETHDR
BIFF3W BIFF4W BIFF5W BIFF8W
â
008FH
â
â
This record occurs only in BIFF4W workbook files. It precedes a BIFF4 Sheet Substream that describes a single sheet in
the BIFF4W workbook. It contains the sheet name and the byte length of the following substream data. Adding this
substream length to the stream position of the following BOF record gives the position of the next SHEETHDR record.
See â10.1.1 for details about the BIFF4W Workbook Stream.
Record SHEETHDR, BIFF4W:
Offset
Size
Contents
0
4
Byte length of the following BIFF4 Sheet Substream
4
var.
Name of the sheet (byte string, 8-bit string length, â2.5.2)
10.5 SHEETSOFFSET
BIFF3W BIFF4W BIFF5W BIFF8W
â
008EH
â
â
This record occurs only in BIFF4W workbook files. It is located in the Workbook Globals Substream and contains the
stream position of the first SHEETHDR record (â10.4). See â10.1.1 for details about the BIFF4W Workbook Stream.
Record SHEETSOFFSET, BIFF4W:
Offset
Size
Contents
0
4
Absolute stream position of the first SHEETHDR record (from beginning of the stream)
250
Document Outline
