शहर का दफ्तर

defmodule String do
  @moduledoc """
  Strings in Elixir are UTF-8 encoded binaries.
  """

  @doc """
  Converts all characters in the given string to uppercase according to `mode`.

  ## Examples

      iex> String.upcase("abcd")
      "ABCD"

      iex> String.upcase("olá")
      "OLÁ"
  """
  def upcase(string, mode \\ :default)
end

@spec longer_than?(String.t(), non_neg_integer()) :: boolean()
def longer_than?(string, length), do: String.length(string) > length

@spec to_hex({hue :: integer, saturation :: integer, lightness :: integer}) :: String.t()

@type color :: {hue :: integer, saturation :: integer, lightness :: integer}

@spec to_hex(color()) :: String.t()

निर्देश

आप कुछ समय से शहर के ऑफिस में काम कर रहे हैं। इस दौरान आपने ऐसे कई टूल बनाए हैं जो आपका रोज़मर्रा का काम तेज़ कर देते हैं, जैसे फॉर्म भरना।

अब आपके साथ एक नया साथी जुड़ रहा है, और आपको लगा कि आपके टूल देखते ही सब कुछ अपने आप समझ में आ जाए, ऐसा ज़रूरी नहीं। आपके ऑफिस में कई अजीब परंपराएँ हैं, जैसे फॉर्म हमेशा बड़े अक्षरों में भरना और किसी फील्ड को खाली न छोड़ना।

आप तय करते हैं कि आप थोड़ा डॉक्युमेंटेशन लिखेंगे, ताकि आपके नए साथी के लिए तुरंत शुरू करना और आपके टूल इस्तेमाल करना आसान हो जाए।

1. फॉर्म टूल के उद्देश्य का डॉक्युमेंटेशन लिखिए

Form मॉड्यूल में ऐसा डॉक्युमेंटेशन जोड़िए जिसमें उसका उद्देश्य बताया गया हो। उसमें यह लिखा होना चाहिए:

A collection of loosely related functions helpful for filling out various forms at the city office.

2. खाली वैल्यू वाले फील्ड भरने का डॉक्युमेंटेशन लिखिए

Form.blanks/1 फंक्शन में डॉक्युमेंटेशन और एक टाइपस्पेक जोड़िए। डॉक्युमेंटेशन में यह लिखा होना चाहिए:

Generates a string of a given length.

This string can be used to fill out a form field that is supposed to have no value.
Such fields cannot be left empty because a malicious third party could fill them out with false data.

टाइपस्पेक से यह साफ होना चाहिए कि यह फंक्शन एक ही आर्गुमेंट लेता है, जो ऋणात्मक न होने वाला पूर्णांक है, और एक स्ट्रिंग लौटाता है।

3. वैल्यू को बड़े अक्षरों के ऐरे में बाँटने का डॉक्युमेंटेशन लिखिए

Form.letters/1 फंक्शन में डॉक्युमेंटेशन और एक टाइपस्पेक जोड़िए। डॉक्युमेंटेशन में यह लिखा होना चाहिए:

Splits the string into a list of uppercase letters.

This is needed for form fields that don't offer a single input for the whole string,
but instead require splitting the string into a predefined number of single-letter inputs.

टाइपस्पेक से यह साफ होना चाहिए कि यह फंक्शन एक ही आर्गुमेंट लेता है, जो एक स्ट्रिंग है, और स्ट्रिंग का ऐरे लौटाता है।

4. अधिकतम लंबाई वाले फील्ड में वैल्यू फिट बैठती है या नहीं, इसकी जाँच का डॉक्युमेंटेशन लिखिए

Form.check_length/2 फंक्शन में डॉक्युमेंटेशन और एक टाइपस्पेक जोड़िए। डॉक्युमेंटेशन में यह लिखा होना चाहिए:

Checks if the value has no more than the maximum allowed number of letters.

This is needed to check that the values of fields do not exceed the maximum allowed length.
It also tells you by how much the value exceeds the maximum.

टाइपस्पेक से यह साफ होना चाहिए कि यह फंक्शन दो आर्गुमेंट लेता है, एक स्ट्रिंग और एक ऋणात्मक न होने वाला पूर्णांक, और दो संभावित वैल्यू में से एक लौटाता है। यह या तो :ok एटम लौटाता है या ऐसा 2-टपल लौटाता है जिसका पहला एलिमेंट :error एटम और दूसरा एक धनात्मक पूर्णांक होता है।

5. पते के अलग-अलग फॉर्मैट का डॉक्युमेंटेशन लिखिए

किसी ऐसे कारण से, जो आपको नहीं पता, शहर के ऑफिस का अंदरूनी सिस्टम पता दिखाने के दो अलग-अलग तरीके इस्तेमाल करता है, कभी मैप के रूप में और कभी टपल के रूप में।

तीन कस्टम पब्लिक टाइप बनाकर इस बात का डॉक्युमेंटेशन कीजिए:

• address_map - एक मैप जिसमें :street, :postal_code और :city की होती हैं। हर की के अंदर स्ट्रिंग टाइप की वैल्यू रखी जाती है।
• address_tuple - तीन वैल्यू वाला टपल: street, postal_code और city। हर वैल्यू स्ट्रिंग टाइप की होती है। टाइपस्पेक में इन वैल्यू को नाम दीजिए, जिससे वे एक-दूसरे से अलग पहचानी जाएँ।
• address - यह address_map या address_tuple, दोनों में से कोई भी हो सकता है।

6. पता फॉर्मैट करने का डॉक्युमेंटेशन लिखिए

Form.format_address/1 फंक्शन में डॉक्युमेंटेशन और एक टाइपस्पेक जोड़िए। डॉक्युमेंटेशन में यह लिखा होना चाहिए:

Formats the address as an uppercase multiline string.

टाइपस्पेक से यह साफ होना चाहिए कि यह फंक्शन एक आर्गुमेंट लेता है, एक पता, और एक स्ट्रिंग लौटाता है।