about me



< June 2005 >
    1 2 3 4
5 6 7 8 91011

past articles »

Click for San Francisco, California Forecast

San Francisco, USA


Python's half open index notation

Beginner programmers often wonder about Python's sequence indexing and slicing notation. Array index starts from 0. Slicing uses half open notations, where L[a:b] is a subsequence with index x where a <= x < b.

Why is the endpoint excluded? Isn't it more intuitive if array index starts from 1 and the endpoint is included, so that a 3 elements array is referenced as L[1:3] with items L[1], L[2], L[3]?

It turns out this notation is an elegant and deliberate design and it has some excellent properties.

We write programs to operate on arrays, to find their length, traverse the subsequences, split them or join them. The half open notation always show a simple pattern. But the inclusive notation often requires adding 1 or substracting 1 to the indexes in many operations. Thus it is more vulnerable to off-by-one-error. This article One True Way of array indexing discuss this at length. I have reproduce its example (with corrections) below:

Operation Half open Inclusive
length of a slice L[a:b] b-a (b-a+1)
first n characters of L L[:n] L[1:n]
last n characters of L L[-n:] L[len(L)-n+1:]
The identity slice L == L[0:len(L)] == L[:] L[1:len(L)]
The empty slice L[a:a] is empty for any a. perhaps L[a:a-1]?
A slice of length n, from point a L[a:a+n] L[a:a+n-1]
Split L[a:b] at index c L[a:b] == L[a:c]+L[c:b] L[a:c-1]+L[c:b]

Another important property is an empty sequence can be expressed by L[a:a], while there is no natural way to express an empty sequence with the inclusive notation. But do we really need to care about a special case? Absolutely! In fact failure to account for empty input is one of the most common error. Just like zero is a fundamental concept in mathematics, always think how you program can handle null input. An inferior approach is to represent empty sequence by None or null pointer. This creates a special case so that a variable need to be tested before dereferencing. Failure to do so contributes to unexpected exceptions. It is an elegant design that L[a:b] can also represent sequences with 0 length.

C++'s STL also choose this notation to represent a range. According to the literature this is crucial because "algorithms that operate on n things frequently require n+1 positions. Linear search, for example (find) must be able to return some value to indicate that the search was unsuccessful." I have seen so many people flunked link list or data structure exercises because they have trouble dealing with the end of a list. Often a good solution is shift the focus beyond the n concrete objects to the n+1 positions around them. I hope this help to make sense of the half open notation.

2005.06.16 [, ] - comments



blog comments powered by Disqus

past articles »


BBC News


India monsoon floods 'kill more than 300' in Kerala (17 Aug 2018)


Rescue mission amid India flood alert (17 Aug 2018)


'I met my IS captor on a German street' (17 Aug 2018)


Aretha Franklin: Stevie Wonder on last meeting with soul singer (17 Aug 2018)


Low-carb diets could shorten life, study suggests (17 Aug 2018)


Washington bridge plunge teenager 'asked for a push' (17 Aug 2018)


China, Taiwan and a bakery: How a coffee sparked a diplomatic row (17 Aug 2018)


Imran Khan confirmed as Pakistan prime minister (17 Aug 2018)


Serena Williams learned just before Johanna Konta loss that half-sister's killer had been freed (17 Aug 2018)


Trump cancels Washington DC's military parade over high costs (17 Aug 2018)

more »


SF Gate


A generation grows up in China without Google, Facebook or Twitter (17 Aug 2018)


Google employees protest secret work on censored search engine for China (16 Aug 2018)


Ship traffic, August 17 (16 Aug 2018)


Twitter muzzles conspiracy theorist Alex Jones for a week (15 Aug 2018)


Tesla directors do damage control after Elon Musk tweets (15 Aug 2018)


Cisco gives bullish outlook helped by new products, software (15 Aug 2018)

more »

Site feed Updated: 2018-Aug-17 12:00