Path: csiph.com!usenet.pasdenom.info!news.albasani.net!newsfeed.freenet.ag!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <python@mrabarnett.plus.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.003
X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'binary': 0.05; 'mrab': 0.05; 'raises': 0.07; 'subject:question': 0.08; 'indexes': 0.09; 'subject:()': 0.09; 'aug': 0.13; 'index': 0.13; "'index'": 0.16; 'from:addr:mrabarnett.plus.com': 0.16; 'from:addr:python': 0.16; 'from:name:mrab': 0.16; 'message-id:@mrabarnett.plus.com': 0.16; 'received:84.93': 0.16; 'received:84.93.230': 0.16; 'subject:API': 0.16; 'tables,': 0.16; 'thought.': 0.16; 'wed,': 0.16; 'wrote:': 0.17; 'exists': 0.17; '>>>': 0.18; 'are:': 0.20; 'matching': 0.23; 'header:In-Reply-To:1': 0.25; 'header:User-Agent:1': 0.26; 'supported': 0.26; '-0700,': 0.29; '>>>>': 0.29; "d'aprano": 0.29; 'index,': 0.29; 'received:192.168.1.3': 0.29; 'steven': 0.29; 'table,': 0.29; 'error': 0.30; '(and': 0.32; 'received:84': 0.32; 'to:addr:python-list': 0.33; 'there': 0.35; 'method': 0.36; 'one,': 0.37; 'why': 0.37; 'rather': 0.37; 'data': 0.37; 'subject:: ': 0.38; 'to:addr:python.org': 0.39; 'received:192': 0.39; 'called': 0.39; 'skip:" 10': 0.40; 'received:192.168': 0.40; 'between': 0.63; 'skip:n 10': 0.63; 'records.': 0.65; 'search,': 0.65; 'header:Reply-To:1': 0.68; 'records': 0.68; 'reply-to:no real name:2**0': 0.72; 'furman': 0.84; 'reply-to:addr:python.org': 0.84; 'ethan': 0.91
X-CM-Score: 0.00
X-CNFS-Analysis: v=2.0 cv=IekFqBWa c=1 sm=1 a=0nF1XD0wxitMEM03M9B4ZQ==:17 a=DKcI9XZsuF4A:10 a=xb2YPhB8IJoA:10 a=ihvODaAuJD4A:10 a=OUOv7kDek9cA:10 a=8nJEP1OIZ-IA:10 a=EBOSESyhAAAA:8 a=8AHkEIZyAAAA:8 a=sUy49W4grkkA:10 a=Hcb5dcFHA9_aPxSHHLIA:9 a=wPNLvfGTeEIA:10 a=0nF1XD0wxitMEM03M9B4ZQ==:117
X-AUTH: mrabarnett:2500
Date: Thu, 16 Aug 2012 17:43:13 +0100
From: MRAB <python@mrabarnett.plus.com>
User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:14.0) Gecko/20120713 Thunderbird/14.0
MIME-Version: 1.0
To: python-list@python.org
Subject: Re: dbf.py API question concerning Index.index_search()
References: <mailman.3329.1345072870.4697.python-list@python.org>	<502c4439$0$29978$c3e8da3$5496439d@news.astraweb.com>	<502C4B3A.6000603@stoneleaf.us> <502C591E.2060700@mrabarnett.plus.com> <502D1C27.5050108@stoneleaf.us>
In-Reply-To: <502D1C27.5050108@stoneleaf.us>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.12
Precedence: list
Reply-To: python-list@python.org
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.3380.1345135396.4697.python-list@python.org>
Lines: 37
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1345135396 news.xs4all.nl 6932 [2001:888:2000:d::a6]:46100
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:27179

On 16/08/2012 17:13, Ethan Furman wrote:
> MRAB wrote:
>> On 16/08/2012 02:22, Ethan Furman wrote:
>>> Steven D'Aprano wrote:
>>>> On Wed, 15 Aug 2012 16:26:09 -0700, Ethan Furman wrote:
>>>>
>>>>> Indexes have a new method (rebirth of an old one, really):
>>>>>
>>>>>    .index_search(
>>>>>       match,
>>>>>       start=None,
>>>>>       stop=None,
>>>>>       nearest=False,
>>>>>       partial=False )
>>>> [...]
>>>>
>>>> Why "index_search" rather than just "search"?
>>>
>>> Because "search" already exists and returns a dbf.List of all matching
>>> records.
>>>
>> Perhaps that should've been called "find_all"!
>
> In interesting thought.
>
> Currently there are:
>
>     .index(data)   --> returns index of data in Index, or raises error
>     .query(string) --> brute force search, returns all matching records
>     .search(match) --> binary search through table, returns all matching
>                        records
>
> 'index' and 'query' are supported by Tables, Lists, and Indexes; search
> (and now index_search) are only supported on Indexes.
>
What exactly is the difference between .index and .index_search with
the default arguments?