/* SwordBible.mm - Sword API wrapper for Biblical Texts. Copyright 2008 Manfred Bergmann Based on code by Will Thimbleby This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation version 2. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. (http://www.gnu.org/licenses/gpl.html) */ #import using sword::AttributeTypeList; using sword::AttributeList; using sword::AttributeValue; @interface SwordBible () - (void)buildBookList; - (BOOL)containsBookNumber:(int)aBookNum; - (NSArray *)textEntriesForReference:(NSString *)aReference context:(int)context textType:(TextPullType)textType; @end @implementation SwordBible @dynamic books; #pragma mark - class methods NSLock *bibleLock = nil; // changes an abbreviated reference into a full // eg. Dan4:5-7 => Daniel4:5 + (void)decodeRef:(NSString *)ref intoBook:(NSString **)bookName book:(int *)book chapter:(int *)chapter verse:(int *)verse { if(!bibleLock) bibleLock = [[NSLock alloc] init]; [bibleLock lock]; SwordVerseKey *key = [SwordVerseKey verseKeyWithRef:ref]; if(bookName != NULL) { *bookName = [key bookName]; } if(book != NULL) { *book = [key book]; } if(chapter != NULL) { *chapter = [key chapter]; } if(verse != NULL) { *verse = [key verse]; } [bibleLock unlock]; } + (NSString *)firstRefName:(NSString *)abbr { if(!bibleLock) bibleLock = [[NSLock alloc] init]; [bibleLock lock]; sword::VerseKey vk([abbr UTF8String]); NSString *result = [NSString stringWithUTF8String:vk]; [bibleLock unlock]; return result; } + (NSString *)context:(NSString *)abbr { //get parsed simple ref NSString *first = [SwordBible firstRefName:abbr]; NSArray *firstBits = [first componentsSeparatedByString:@":"]; //if abbr contains : or . then we are a verse so return a chapter if([abbr rangeOfString:@":"].location != NSNotFound || [abbr rangeOfString:@"."].location != NSNotFound) { return [firstBits objectAtIndex:0]; } //otherwise return a book firstBits = [first componentsSeparatedByString:@" "]; if([firstBits count] > 0) { return [firstBits objectAtIndex:0]; } return abbr; } /** get book index for verseKey that is: book number + testament * 100 */ + (int)bookIndexForSWKey:(sword::VerseKey *)key { return key->Book() + key->Testament() * 100; } #pragma mark - Initializers - (id)initWithName:(NSString *)aName swordManager:(SwordManager *)aManager { self = [super initWithName:aName swordManager:aManager]; if(self) { [self setBooks:nil]; } return self; } - (id)initWithSWModule:(sword::SWModule *)aModule swordManager:(SwordManager *)aManager { self = [super initWithSWModule:aModule swordManager:aManager]; if(self) { [self setBooks:nil]; } return self; } - (void)finalize { [super finalize]; } - (void)dealloc { [books release]; [super dealloc]; } #pragma mark - Bible information - (void)buildBookList { [moduleLock lock]; sword::VersificationMgr *vmgr = sword::VersificationMgr::getSystemVersificationMgr(); const sword::VersificationMgr::System *system = vmgr->getVersificationSystem([[self versification] UTF8String]); NSMutableDictionary *buf = [NSMutableDictionary dictionary]; int bookCount = system->getBookCount(); for(int i = 0;i < bookCount;i++) { sword::VersificationMgr::Book *book = (sword::VersificationMgr::Book *)system->getBook(i); SwordBibleBook *bb = [[[SwordBibleBook alloc] initWithBook:book] autorelease]; [bb setNumber:i+1]; NSString *bookName = [bb name]; [buf setObject:bb forKey:bookName]; } self.books = buf; [moduleLock unlock]; } - (BOOL)containsBookNumber:(int)aBookNum { for(SwordBibleBook *bb in [self books]) { if([bb number] == aBookNum) { return YES; } } return NO; } - (NSMutableDictionary *)books { if(books == nil) { [self buildBookList]; } return books; } - (void)setBooks:(NSMutableDictionary *)aBooks { [aBooks retain]; [books release]; books = aBooks; } - (NSArray *)bookList { NSDictionary *b = [self books]; NSArray *bl = [[b allValues] sortedArrayUsingSelector:@selector(compare:)]; return bl; } - (BOOL)hasReference:(NSString *)ref { [moduleLock lock]; sword::VerseKey *key = (sword::VerseKey *)(swModule->CreateKey()); (*key) = [ref UTF8String]; NSString *bookName = [NSString stringWithUTF8String:key->getBookName()]; int chapter = key->Chapter(); int verse = key->Verse(); SwordBibleBook *bb = [[self books] objectForKey:bookName]; if(bb) { if(chapter > 0 && chapter < [bb numberOfChapters]) { if(verse > 0 && verse < [bb numberOfVersesForChapter:chapter]) { return YES; } } } [moduleLock unlock]; return NO; } - (int)numberOfVerseKeysForReference:(NSString *)aReference { int ret = 0; if(aReference && [aReference length] > 0) { sword::VerseKey vk; sword::ListKey listKey = vk.ParseVerseList([aReference UTF8String], "Gen1", true); // unfortunately there is no other way then loop though all verses to know how many for(listKey = sword::TOP; !listKey.Error(); listKey++) ret++; } return ret; } - (int)chaptersForBookName:(NSString *)bookName { [moduleLock lock]; int maxChapters; sword::VerseKey *key = (sword::VerseKey *)swModule->CreateKey(); (*key) = [bookName UTF8String]; maxChapters = key->getChapterMax(); delete key; [moduleLock unlock]; return maxChapters; } - (int)versesForChapter:(int)chapter bookName:(NSString *)bookName { int ret = -1; [moduleLock lock]; SwordBibleBook *bb = [[self books] objectForKey:bookName]; if(bb) { ret = [bb numberOfVersesForChapter:chapter]; } [moduleLock unlock]; return ret; } - (int)versesForBible { int ret = 0; for(SwordBibleBook *bb in [self books]) { int chapters = [bb numberOfChapters]; int verses = 0; for(int j = 1;j <= chapters;j++) { verses += [bb numberOfVersesForChapter:j]; } ret += verses; } return ret; } - (SwordBibleBook *)bookForLocalizedName:(NSString *)bookName { for(SwordBibleBook *book in [[self books] allValues]) { if([[book localizedName] isEqualToString:bookName]) { return book; } } return nil; } - (NSString *)moduleIntroduction { NSString *ret; // save key SwordVerseKey *save = [(SwordVerseKey *)[self getKeyCopy] autorelease]; SwordVerseKey *key = [SwordVerseKey verseKeyWithVersification:[self versification]]; [key setHeadings:YES]; [key setPosition:0]; [self setSwordKey:key]; ret = [self renderedText]; // restore old key [self setSwordKey:save]; return ret; } - (NSString *)bookIntroductionFor:(SwordBibleBook *)aBook { NSString *ret; // save key SwordVerseKey *save = [(SwordVerseKey *)[self getKeyCopy] autorelease]; SwordVerseKey *key = [SwordVerseKey verseKeyWithVersification:[self versification]]; [key setHeadings:YES]; [key setAutoNormalize:NO]; [key setTestament:[aBook testament]]; [key setBook:[aBook numberInTestament]]; [key setChapter:0]; [key setVerse:0]; [self setSwordKey:key]; ret = [self renderedText]; // restore old key [self setSwordKey:save]; return ret; } - (NSString *)chapterIntroductionFor:(SwordBibleBook *)aBook chapter:(int)chapter { NSString *ret; // save key SwordVerseKey *save = [(SwordVerseKey *)[self getKeyCopy] autorelease]; SwordVerseKey *key = [SwordVerseKey verseKeyWithVersification:[self versification]]; [key setHeadings:YES]; [key setAutoNormalize:NO]; [key setTestament:[aBook testament]]; [key setBook:[aBook numberInTestament]]; [key setChapter:chapter]; [key setVerse:0]; [self setSwordKey:key]; ret = [self renderedText]; // restore old key [self setSwordKey:save]; return ret; } - (SwordModuleTextEntry *)textEntryForKey:(SwordKey *)aKey textType:(TextPullType)aType { SwordBibleTextEntry *ret = nil; if(aKey) { [moduleLock lock]; [self setSwordKey:aKey]; if(![self error]) { NSString *txt; if(aType == TextTypeRendered) { txt = [self renderedText]; } else { txt = [self strippedText]; } if(txt) { ret = [SwordBibleTextEntry textEntryForKey:[aKey keyText] andText:txt]; } else { ALog(@"nil key"); } if([swManager globalOption:SW_OPTION_HEADINGS] && [self hasFeature:SWMOD_FEATURE_HEADINGS]) { NSString *preverseHeading = [self entryAttributeValuePreverse]; if(preverseHeading && [preverseHeading length] > 0) { [ret setPreVerseHeading:preverseHeading]; } } } [moduleLock unlock]; } return ret; } - (NSString *)versification { NSString *versification = [configEntries objectForKey:SWMOD_CONFENTRY_VERSIFICATION]; if(versification == nil) { versification = [self configFileEntryForConfigKey:SWMOD_CONFENTRY_VERSIFICATION]; if(versification != nil) { [configEntries setObject:versification forKey:SWMOD_CONFENTRY_VERSIFICATION]; } } // if still nil, use KJV versification if(versification == nil) { versification = @"KJV"; [configEntries setObject:versification forKey:SWMOD_CONFENTRY_VERSIFICATION]; } return versification; } #pragma mark - SwordModuleAccess - (SwordKey *)createKey { sword::VerseKey *vk = (sword::VerseKey *)swModule->CreateKey(); SwordVerseKey *newKey = [SwordVerseKey verseKeyWithSWVerseKey:vk makeCopy:YES]; delete vk; return newKey; } - (SwordKey *)getKey { return [SwordVerseKey verseKeyWithSWVerseKey:(sword::VerseKey *)swModule->getKey()]; } - (SwordKey *)getKeyCopy { return [SwordVerseKey verseKeyWithSWVerseKey:(sword::VerseKey *)swModule->getKey() makeCopy:YES]; } - (long)entryCount { swModule->setPosition(sword::TOP); long verseLowIndex = swModule->Index(); swModule->setPosition(sword::BOTTOM); long verseHighIndex = swModule->Index(); return verseHighIndex - verseLowIndex; } - (NSArray *)strippedTextEntriesForRef:(NSString *)reference { return [self strippedTextEntriesForRef:reference context:0]; } - (NSArray *)strippedTextEntriesForRef:(NSString *)reference context:(int)context { return [self textEntriesForReference:reference context:context textType:TextTypeStripped]; } - (NSArray *)renderedTextEntriesForRef:(NSString *)reference { return [self renderedTextEntriesForRef:reference context:0]; } - (NSArray *)renderedTextEntriesForRef:(NSString *)reference context:(int)context { return [self textEntriesForReference:reference context:context textType:TextTypeRendered]; } - (NSArray *)textEntriesForReference:(NSString *)aReference textType:(TextPullType)textType { return [self textEntriesForReference:aReference context:0 textType:textType]; } - (NSArray *)textEntriesForReference:(NSString *)aReference context:(int)context textType:(TextPullType)textType { NSMutableArray *ret = [NSMutableArray array]; SwordListKey *lk = [SwordListKey listKeyWithRef:aReference v11n:[self versification]]; [lk setPosition:SWPOS_TOP]; [lk setPersist:NO]; SwordVerseKey *vk = [SwordVerseKey verseKeyWithRef:[lk keyText] v11n:[self versification]]; while(![lk error]) { // set current key to vk [vk setKeyText:[lk keyText]]; if(context != 0) { long lowVerse = [vk verse] - context; long highVerse = lowVerse + (context * 2); for(;lowVerse <= highVerse;lowVerse++) { [vk setVerse:lowVerse]; SwordBibleTextEntry *entry = (SwordBibleTextEntry *) [self textEntryForKey:vk textType:textType]; if(entry) { [ret addObject:entry]; } [vk increment]; } } else { SwordBibleTextEntry *entry = (SwordBibleTextEntry *) [self textEntryForKey:vk textType:textType]; if(entry) { [ret addObject:entry]; } } [lk increment]; } return ret; } - (void)writeEntry:(SwordModuleTextEntry *)anEntry { const char *data = [[anEntry text] UTF8String]; int dLen = strlen(data); [moduleLock lock]; [self setKeyString:[anEntry key]]; if(![self error]) { swModule->setEntry(data, dLen); // save text to module at current position } else { ALog(@"error at positioning module!"); } [moduleLock unlock]; } @end