রেগুলার এক্সপ্রেশন মধ্যে

রেগুলার এক্সপ্রেশন সম্পর্কে

রেগুলার এক্সপ্রেশন (রেজেক্স) হলো এমন কিছু অক্ষরের ক্রম, যা টেক্সটে খোঁজার একটি প্যাটার্ন নির্দিষ্ট করে।

রেগুলার এক্সপ্রেশনের সিনট্যাক্স শেখা এই টপিকের আলোচনার বাইরে। আমরা এখানে jq রেজেক্স ব্যবহারের জন্য যে এক্সপ্রেশনগুলো সরবরাহ করে, সেগুলোতেই মন দেব।

রেজেক্সের ধরন

ভিন্ন ভিন্ন টুল রেগুলার এক্সপ্রেশনের ভিন্ন ভিন্ন সংস্করণ তৈরি করে। jq ব্যবহার করে Oniguruma রেজেক্স লাইব্রেরি, যা Perl v5.8-এর রেজেক্সের সাথে বেশিরভাগ ক্ষেত্রেই সামঞ্জস্যপূর্ণ।

jq যে নির্দিষ্ট সিনট্যাক্স ব্যবহার করে, তা Oniguruma-র GitHub রিপোতে পাওয়া যাবে।

রেজেক্স ফাংশন

jq-এ রেগুলার এক্সপ্রেশন ব্যবহার সীমাবদ্ধ কিছু ফিল্টারের মধ্যে।

সাধারণ ম্যাচিং

একটি স্ট্রিং কোনো প্যাটার্নের সাথে মিলছে কি না জানতে চাইলে test ফিল্টার ব্যবহার করুন।

STRING | test(REGEX)
STRING | test(REGEX; FLAGS)
STRING | test([REGEX, FLAGS])

এই ফিল্টারটি একটি বুলিয়ান ফলাফল আউটপুট দেয়।

"Hello World!" | test("W")    # => true
"Goodbye Mars" | test("W")    # => false

ম্যাচ সম্পর্কে তথ্য

প্যাটার্নের সাথে আসলে যে সাবস্ট্রিংটি মিলেছে তা বের করতে চাইলে match ফিল্টার ব্যবহার করুন।

STRING | match(REGEX)
STRING | match(REGEX; FLAGS)
STRING | match([REGEX, FLAGS])

এই ফিল্টারটি আউটপুট দেয়:

• কোনো ম্যাচ না থাকলে কিছুই না, অথবা
• ম্যাচ থাকলে বিভিন্ন প্রোপার্টি-সহ একটি অবজেক্ট।

এই উদাহরণটি ব্যাকরেফ সিনট্যাক্স \1 ব্যবহার করে পরপর দুটি একই স্বরবর্ণ খুঁজে বের করে।

"Hello World!" | match("([aeiou])\\1")
# => empty

"Goodbye Mars" | match("([aeiou])\\1")
# => {
#      "offset": 1,
#      "length": 2,
#      "string": "oo",
#      "captures": [
#        {
#          "offset": 1,
#          "length": 1,
#          "string": "o",
#          "name": null
#        }
#      ]
#    }

match ফিল্টার প্রতিটি ম্যাচের জন্য একটি অবজেক্ট রিটার্ন করে। এই উদাহরণে সব স্বরবর্ণ খুঁজে বের করতে "g" ফ্ল্যাগটি কাজে লাগানো হয়েছে।

"Goodbye Mars" | match("[aeiou]"; "g")
# => { "offset": 1, "length": 1, "string": "o", "captures": [] }
#    { "offset": 2, "length": 1, "string": "o", "captures": [] }
#    { "offset": 6, "length": 1, "string": "e", "captures": [] }
#    { "offset": 9, "length": 1, "string": "a", "captures": [] }

ক্যাপচার করা সাবস্ট্রিংগুলো

match ফিল্টারের মতোই, ম্যাচ থাকলে capture ফিল্টার একটি অবজেক্ট রিটার্ন করে।

STRING | capture(REGEX)
STRING | capture(REGEX; FLAGS)
STRING | capture([REGEX, FLAGS])

রিটার্ন করা অবজেক্টটি হলো নেমড ক্যাপচারগুলোর একটি ম্যাপিং।

"JIRAISSUE-1234" | capture("(?<project>\\w+)-(?<issue_num>\\d+)")
# => {
#      "project": "JIRAISSUE",
#      "issue_num": "1234"
#    }

কেবল সাবস্ট্রিংগুলো

scan ফিল্টারটি "g" ফ্ল্যাগসহ match-এর মতোই।

STRING | scan(REGEX)
STRING | scan(REGEX; FLAGS)

# note, there is no scan([REGEX, FLAGS]) version, unlike other filters

scan সাবস্ট্রিংগুলোর একটি স্ট্রিম আউটপুট দেবে।

"Goodbye Mars" | scan("[aeiou]")
# => "o"
#    "o"
#    "e"
#    "a"

সাবস্ট্রিংগুলো ক্যাপচার করতে [...] অ্যারে কনস্ট্রাক্টর ব্যবহার করুন।

"Goodbye Mars" | [ scan("[aeiou]") ]
# => ["o", "o", "e", "a"]

একটি স্ট্রিং ভাগ করা

স্ট্রিংয়ের যে অংশগুলো আপনি রাখতে চান সেগুলো জানা থাকলে match বা scan ব্যবহার করুন। আর যে অংশগুলো বাদ দিতে চান সেগুলো জানা থাকলে split ব্যবহার করুন।

STRING | split(REGEX; FLAGS)

নিচের উদাহরণটি যেকোনো রকম হোয়াইটস্পেসে একটি স্ট্রিং ভাগ করে।

"first   second           third fourth" | split("\\s+"; "")
# => ["first", "second", "third", "fourth"]

"first   second           third fourth" | split("\\s+")
# => ["first   second           third fourth"]

"first   second           third fourth" | split(" ")
# => ["first", "", "", "second", "", "", "", "",
#     "", "", "", "", "", "", "third", "fourth" ]

সাবস্টিটিউশন

sub ও gsub ফিল্টার ইনপুট স্ট্রিংটিকে রূপান্তর করতে পারে, ইনপুটের মিলে যাওয়া অংশগুলোর জায়গায় একটি রিপ্লেসমেন্ট স্ট্রিং বসিয়ে দিয়ে।

কেবল প্রথম ম্যাচটি বদলাতে চাইলে sub ব্যবহার করুন। সব ম্যাচ বদলাতে চাইলে gsub ব্যবহার করুন।

STRING | sub(REGEX; REPLACEMENT)
STRING | sub(REGEX; REPLACEMENT; FLAGS)
STRING | gsub(REGEX; REPLACEMENT)
STRING | gsub(REGEX; REPLACEMENT; FLAGS)

"Goodnight kittens. Goodnight mittens." | sub("night"; " morning")
# => "Good morning kittens. Goodnight mittens."

"Goodnight kittens. Goodnight mittens." | gsub("night"; " morning")
# => "Good morning kittens. Good morning mittens."

রিপ্লেসমেন্ট টেক্সটে মিলে যাওয়া সাবস্ট্রিংগুলো উল্লেখ করা যায়; এর জন্য নেমড ক্যাপচার ও স্ট্রিং ইন্টারপোলেশন ব্যবহার করুন।

"Some 3-letter acronyms: gnu, csv, png"
| gsub( "\\b(?<tla>[[:alpha:]]{3})\\b";     # find words 3 letters long
        "\(.tla | ascii_upcase)" )          # upper-case the match
# => "Some 3-letter acronyms: GNU, CSV, PNG"

ফ্ল্যাগ

উপরের সব ফিল্টারেই FLAGS হলো একটি স্ট্রিং, যাতে সমর্থিত ফ্ল্যাগগুলোর শূন্য বা তার বেশি সংখ্যক থাকতে পারে।

• g - গ্লোবাল সার্চ (কেবল প্রথমটি নয়, সব ম্যাচ খুঁজে বের করে)
• i - কেস-ইনসেনসিটিভ সার্চ
• m - মাল্টি লাইন মোড ('.' নিউলাইনও ম্যাচ করবে)
• n - খালি ম্যাচ উপেক্ষা করে
• p - s ও m দুটি মোডই চালু থাকে
• s - সিঙ্গল লাইন মোড ('^' -> '\A', '$' -> '\Z')
• l - সম্ভাব্য সবচেয়ে লম্বা ম্যাচ খুঁজে বের করে
• x - এক্সটেন্ডেড রেজেক্স ফরম্যাট (হোয়াইটস্পেস ও কমেন্ট উপেক্ষা করে)

উদাহরণস্বরূপ

"JIRAISSUE-1234" | capture("(?<project>\\w+)-(?<issue_num>\\d+)")

# or with Extended formatting

"JIRAISSUE-1234" | capture("
                     (?<project>   \\w+ )  # the Jira project
                     -                     # followed by a hyphen
                     (?<issue_num> \\d+ )  # followed by digits
                   "; "x")