Counters

LaTeX · Wikibooks

0%

Contents

    Text

    Size
    100%
    Theme
    Typeface
    Line length
    Spacing

    Read aloud

    How

    Speed: 1×
    Light up
    Highlight

    Symbols: Mulberry Symbols, © 2018–2026 Steve Lee, CC BY-SA 4.0 (licence, the set), the site's own copies.

    From Wikibooks, under CC BY-SA 4.0, as the source states it. This page at Wikibooks.

    Counters
    Illustration

    LaTeX

    Getting Started
    1. Introduction
    2. Installation
    3. Installing Extra Packages
    4. Basics
    5. How to get help

    Common Elements

    1. Document Structure
    2. Text Formatting
    3. Paragraph Formatting
    4. Colors
    5. Fonts
    6. List Structures
    7. Special Characters
    8. Internationalization
    9. Rotations
    10. Tables
    11. Title creation
    12. Page Layout
    13. Customizing Page Headers and Footers‎
    14. Importing Graphics
    15. Floats, Figures and Captions
    16. Footnotes and Margin Notes
    17. Hyperlinks
    18. Labels and Cross-referencing
    19. Initials

    Mechanics

    1. Errors and Warnings
    2. Lengths
    3. Counters
    4. Boxes
    5. Rules and Struts

    Technical Text

    1. Mathematics
    2. Advanced Mathematics
    3. Theorems
    4. Chemical Graphics
    5. Algorithms
    6. Source Code Listings
    7. Linguistics

    Special Pages

    1. Indexing
    2. Glossary
    3. Bibliography Management
    4. More Bibliographies

    Special Documents

    1. Scientific Reports (Bachelor Report, Master Thesis, Dissertation)
    2. Letters
    3. Presentations
    4. Teacher's Corner
    5. Curriculum Vitae
    6. Academic Journals (MLA, APA, etc.)

    Creating Graphics

    1. Introducing Procedural Graphics
    2. MetaPost
    3. Picture
    4. PGF/TikZ
    5. PSTricks
    6. Xy-pic
    7. Creating 3D graphics

    Programming

    1. Macros
    2. Plain TeX
    3. Creating Packages
    4. Creating Package Documentation
    5. Themes

    Miscellaneous

    1. Modular Documents
    2. Collaborative Writing of LaTeX Documents
    3. Export To Other Formats

    Help and Recommendations

    1. FAQ
    2. Tips and Tricks

    Appendices

    1. Authors
    2. Links
    3. Package Reference
    4. Sample LaTeX documents
    5. Index
    6. Command Glossary

    edit this box • edit the TOC

    Counters are an essential part of LaTeX: they allow you to control the numbering mechanism of everything (sections, lists, captions, etc.). To that end each counter stores an integer value in the range of long integer, i.e., from to . [1]

    Counter manipulation

    In LaTeX it is fairly easy to create new counters and even counters that reset automatically when another counter is increased (think subsection in a section for example). With the command

    \newcounter{NameOfTheNewCounter}
    

    you create a new counter that is automatically set to zero. If you want the counter to be reset to zero every time another counter is increased, use:

    \newcounter{NameOfTheNewCounter}[NameOfTheOtherCounter]
    

    For example, if you want to enumerate the equations in each chapter independently, you can create something like an "equationschapter" counter that will be automatically reset at the begin of each section.

    \newcounter{equationschapter}[section]
    	
        \section{First Section}
        I present one equation:
        
        \stepcounter{equationschapter} $a=b+c$ (Eq. \arabic{section}.\arabic{equationschapter})
        
        \section{Second Section}
        I present more equations:
        
        \stepcounter{equationschapter} $a=c+d$ (Eq. \arabic{section}.\arabic{equationschapter})
          
        \stepcounter{equationschapter} $d=e$ (Eq. \arabic{section}.\arabic{equationschapter})
    


    To add to an existing counter another counter causing a reset when increased, use:

    \counterwithin*{NameOfTheCounter}{NameOfTheOtherCounter}
    

    If this doesn't work it might be because of an old LaTeX version, the following should work in that case:

    \makeatletter
    \@addtoreset{NameOfTheCounter}{NameOfTheOtherCounter}
    \makeatother
    

    To undo this effect one can use:

    \counterwithout*{NameOfTheCounter}{NameOfTheOtherCounter}
    

    or:

    \makeatletter
    \@removefromreset{NameOfTheCounter}{NameOfTheOtherCounter}
    \makeatother
    

    To increase the counter, either use

    \stepcounter{NameOfTheNewCounter}
    

    or

    \refstepcounter{NameOfTheNewCounter} % used for labels and cross referencing
    

    or

    \addtocounter{NameOfTheNewCounter}{number}
    

    here the number can also be negative. For automatic resetting you need to use \stepcounter.

    To set the counter value explicitly, use

    \setcounter{NameOfTheNewCounter}{number}
    

    Counter access

    There are several ways to get access to a counter.

    • \theNameOfTheNewCounter will print the formatted string related to the counter (note the "the" before the actual name of the counter).
    • \value{NameOfTheNewCounter} will return the counter value which can be used by other counters or for calculations. It is not a formatted string, so it cannot be used in text.
    • \arabic{NameOfTheNewCounter} will print the formatted counter using arabic numbers.

    Note that \arabic{NameOfTheNewCounter} may be used as a value too, but not the others.

    Strangely enough, LaTeX counters are not introduced by a backslash in any case, even with the \the command. plainTeX equivalents \count and \newcount\mycounter do abide by the backslash rule.

    Counter style

    The following internal LaTeX commands will convert numeric value of specified counter into printable string and insert string into document:

    \arabic
    Numbers from to inclusive converted to strings «-2147483648», «-2147483647», …, «-1», «0», «1», …, «2147483646», «2147483647».
    Example: 1, 2, 3, …
    \alph
    Numbers from 1 to 26 inclusive converted to strings «a», «b», …, «z». Other numbers (negative numbers, zero, 27, 28, …, ) converted to empty string.
    Example: a, b, c, …
    \Alph
    Same as \alph, but upper case letters used.
    Example: A, B, C, …
    \roman
    Numbers from 1 to 4999 inclusive converted to strings «i» (1), «ii» (2), …, «mmmmcmxcix» (4999), where «i» — 1, «v» — 5, «x» — 10, «l» — 50, «c» — 100, «d» — 500, «m» — 1000. Numbers from 5000 to inclusive converted to strings «mmmmm» (5000), «mmmmmi» (5001), …. Other numbers (negative numbers, zero) converted to empty string.
    Example: i, ii, iii, …
    \Roman
    Same as \roman, but upper case letters used.
    Example: I, II, III, …
    \fnsymbol
    Aimed at footnotes; prints a sequence of symbols.
    Number Symbol(s)
    1 ∗
    2 †
    3 ‡
    4 §
    5
    6 ∥
    7 ∗∗
    8 ††
    9 ‡‡
    Other numbers Empty string
    Example: ∗, †, ‡, …

    LaTeX default counters

    • part
    • chapter
    • section
    • subsection
    • subsubsection
    • paragraph
    • subparagraph
    • page
    • figure
    • table
    • footnote
    • mpfootnote

    For the enumerate environment:

    • enumi
    • enumii
    • enumiii
    • enumiv

    For the eqnarray environment:

    • equation

    Book with parts, sections, but no chapters

    Here follows an example where we want to use parts and sections, but no chapters in the book class :

    \renewcommand{\thesection}{\thepart .\arabic{section}}
    
    \part{My Part}                                                                
    \section{My Section}
    \subsection{My Subsection}
    

    Tables numbered in uppercase Roman characters

    Here follows an example where we want to have tables numbered in uppercase Roman characters :

    \renewcommand{\thetable}{\Roman{table}}
    
    \begin{table}
    \caption{Title of table IX} \label{tab:IX}
    ...
    \end{table}
    

    Custom enumerate

    See the List Structures chapter.

    Custom sectioning

    Here is an example for recreating something similar to a section and subsection counter that already exist in LaTeX:

    \newcounter{mysection}
    \newcounter{mysubsection}[mysection]
    \addtocounter{mysection}{2} % set them to some other numbers than 0
    \addtocounter{mysubsection}{10} % same
    %
    \arabic{mysection}.\arabic{mysubsection}
    Blah blah
    
    \stepcounter{mysection}
    \arabic{mysection}.\arabic{mysubsection}
    Blah blah
    
    \stepcounter{mysubsection}
    \arabic{mysection}.\arabic{mysubsection}
    Blah blah
    
    \addtocounter{mysubsection}{25}
    \arabic{mysection}.\arabic{mysubsection}
    Blah blah and more blah blah
    


    Previous: Lengths Index Next: Boxes