Religion::Islam::Quran - Holy Quran book searchable database multi-lingual in utf-8 unicode format
#--------------------------------------------------------------- use Religion::Islam::Quran; #--------------------------------------------------------------- #create new object with default options, Arabic language my $quran = Religion::Islam::Quran->new(); # or select the English Language: my $quran = Religion::Islam::Quran->new(Language=>'English'); # you can also specifiy your own database files path: my $quran = Religion::Islam::Quran->new(DatabasePath => './Quran/mydatabase'); #--------------------------------------------------------------- #Returns the available Quran databases @Languages = $quran->GetLanguages(); #--------------------------------------------------------------- # returns all the quran surahs count. $surahs = $quran->SurahCount; # returns 114 #--------------------------------------------------------------- # returns all the quran ayats count. $ayats = $quran->AyahCount; # returns 6236 #--------------------------------------------------------------- #returns all surah ayats Quran in an array. @surah = $quran->Surah(1); #--------------------------------------------------------------- #returns the number of surah ayats. $surah_number = 1; # 1 to 114 $surah_ayats = $quran->SurahAyahCount($surah_number); #--------------------------------------------------------------- # returns the surah name using the surah number from 1 to 114. $surah_name = $quran->SurahName($surah_number, $optional_language); #--------------------------------------------------------------- # returns Quran text of specific surah ayah. $ayah = $quran->Ayah($surah_number, $ayah_number); #--------------------------------------------------------------- # returns Quran text of specific surah ayah range in an array . @ayats = $quran->Ayats($surah_number, $from_ayah, $to_ayah); #--------------------------------------------------------------- # returns all the Quran text of specific surah in an array. @ayats = $quran->Surah($surah_number); #--------------------------------------------------------------- # returns the names of each surah in the Quran sort order. @surahs_name = $quran->SurahsNames(); #--------------------------------------------------------------- # returns the ayats number for each surah in the Quran sort order. @surahs_ayats = $quran->SurahsAyats(); #--------------------------------------------------------------- # search specific Surah for specific text and returns the ayahs numbers @ayats = $quran->SearchSurah($surah, $findwhat); #--------------------------------------------------------------- #Remove Diacritic from Arabic Text $TextWithoutDiacritic = $quran->RemoveDiacritic($TextWithDiacritic); #--------------------------------------------------------------- #The Wajib Sajdah of the Qur'an #In four Surahs of the Qur'an there are ayats of sajdah that if a person reads one #of these ayats, or if he hears someone else recite one of these ayats, once the #ayat is finished, one must immediately go into sajdah. #Returns the Surah=>Ayah pairs %SajdahCompulsaryAyats = $quran->SajdahCompulsaryAyats(); print $quran->IsSajdahCompulsaryAyah($surah, $ayah); #The recommended (mustahab) Sajdah of the Qur'an #Returns the Surah=>Ayah pairs %SajdahRecommendedAyats = $quran->SajdahRecommendedAyats(); print $quran->IsSajdahRecommendedAyah($surah, $ayah); #Surah Number Order of Revelation #Returns surah number=>order of revelation pairs %OrderOfRevelation = $quran->OrderOfRevelation(); print "Surah Order Of Revelation: " . $quran->SurahOrderOfRevelation($surah); #Where each surah revealed, Mekkah or Medianh #Return 1 for Medinah and 0 for Mekkah print $quran->SurahRevelation($surah);
This module contains the full Holy Quran Book database searchable and provides many methods for retriving whole quran, specific surahs, or specific ayats and information about Quran and each surah in different languages and transliterations. Quran database files are simply text files pipe separated each line is formated as:
<SurahNumber>|<AyahNumber>|<AyahText><CRLF>
Example of Arabic database file first Surah QuranArabic.txt:
1|1|بِسْمِ اللّهِ الرَّحْمَنِ الرَّحِيمِ 1|2|الْحَمْدُ للّهِ رَبِّ الْعَالَمِينَ 1|3|الرَّحْمنِ الرَّحِيمِ 1|4|مَلِكِ يَوْمِ الدِّينِ 1|5|إِيَّاكَ نَعْبُدُ وإِيَّاكَ نَسْتَعِينُ 1|6|اهدِنَا الصِّرَاطَ المُستَقِيمَ 1|7|صِرَاطَ الَّذِينَ أَنعَمتَ عَلَيهِمْ غَيرِ المَغضُوبِ عَلَيهِمْ وَلاَ الضَّالِّينَ
and the 112th Surah in QuranEnglish.txt:
112|1|Say: He is Allah, the One and Only; 112|2|Allah, the Eternal, Absolute; 112|3|He begetteth not, nor is He begotten; 112|4|And there is none like unto Him.
Database text files located in the module directory /Religion/Islam/Quran. Default module comes with the Quran Arabic and some other translations. You can download more quran translations and transliterations from www.islamware.com.
Languages and databases included with the module are:
Albanian Arabic Azerbaijani Chinese Dutch English EnglishUS Finnish French German Harun Indonesian Italian Japanese Latin Malaysian Mexican Persian Poland Portuguese Russian Spanish Swahili Tamil Thai Turkish EnglishTransliteration
Surah names are only available in English and Arabic languages.
Date::HijriDate Religion::Islam::Qibla Religion::Islam::PrayTime Religion::Islam::PrayerTimes
Ahmed Amin Elsheshtawy, <support@islamware.com> <support@mewsoft.com> Website: http://www.islamware.com http://www.mewsoft.com
Copyright (C) 2006-2013 by Ahmed Amin Elsheshtawy support@islamware.com, support@mewsoft.com http://www.islamware.com http://www.mewsoft.com
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Religion::Islam::Quran, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Religion::Islam::Quran
CPAN shell
perl -MCPAN -e shell install Religion::Islam::Quran
For more information on module installation, please visit the detailed CPAN module installation guide.