Wikifunctions:Suggest a function

Do you have an idea for a new function? Suggest it here! It may help to refer to our glossary.

You can create a function right away if you have the user-rights.

If a function requires a new type, consider proposing it.

Note that for now we only support a limited number of types as input and output types of functions. More types are coming in the next few months. For the full list, see WF:Type.

Once created, consider adding new Functions to the catalogue.

Proposed functions requiring only available types

String

String character discard functions

• remove stereochemical specificity in SMILES string, like e/z isomers
  • already fulfilled by someone else at: remove stereochemical specificity at tetrahedral sites in SMILES string (Z11815): minimal removal of @ or @@ leaving everything else intact, even if it can then be simplified
• simplify SMILES string according to some basic simplifications
  •  Partly done, see simplify SMILES string (Z19380): Simplify a SMILES (Simplified Molecular Input Line Entry System) string by removing unnecessary parentheses, reducing redundancy, and simplifying chains.. There's testcases, and I (or someone else) can get around to the coding later. MolecularPilot (talk) 10:21, 26 October 2024 (UTC)
    • Done completely, still at simplify SMILES string (Z19380): Simplify a SMILES (Simplified Molecular Input Line Entry System) string by removing unnecessary parentheses, reducing redundancy, and simplifying chains.. Another user helpfully wrote a python script that passed 1 of my test cases between October and now. I just re-wrote the script to pass all 3 test cases, and also created a JavaScript version. MolecularPilot (talk) 03:43, 10 January 2025 (UTC)

String encoding and decoding functions

• Unicode normalising functions (there are several types of normalisation)
• Backslash-U with delimiters ASCII encoding of Unicode encode
  • Can someone elaborate on this? No example cases were given on the document, and backslash-U with delimiters is anyway not that prevalent as far as I have seen. BrightSunMan (talk) 15:24, 26 December 2023 (UTC)
  • Done, see \u with delimiters ASCII encoding of Unicode (Z21486): Follow RFC 5137 encoding of Unicode text using only ASCII through the use of \u delimiters.. I've made 5 test cases (achieving 100% coverage) and implementations in both JavaScript and Python, which passes all test cases. Support for both the Basic Multilingual Plane (BMP) and supplementary characters (using surrogate pairs). MolecularPilot (talk) 02:49, 10 January 2025 (UTC)
• XML and HTML ASCII encoding of Unicode encode
  • Done, see HTML/XML ASCII encoding of unicode string (Z21503): Encode a unicode string in ASCII, using the HTML encoding format.. Again, I've also made 5 test cases which cover a wide variety of Unicode characters, and implementations in JS and Python (which pass all the tests). As before successful support for both the Basic Multilingual Plane (BMP) and supplementary characters (this time not using surrogate pairs, as is customary for HTML/XML encoding). MolecularPilot (talk) 05:30, 10 January 2025 (UTC)
• HTML named character encode
• Punycode encode - Punycode encode (Z10178): Description missing (part only, not whole url); see also IDNA encode (Z10185): Description missing
• Unified English Braille encode (discarding invalid characters?)
  • Done, see Unified English Braille encode (Z21514): Encodes latin letters into .. 6 test cases this time, and support for both letters and numbers, with implementations in JS and Python (both passing all the tests). MolecularPilot (talk) 06:00, 10 January 2025 (UTC)

String presentation functions

• add locale-specific quotation marks to string
  • Shouldn't the output depend on the locale? See mw.language:formatNum. —Dexxor (talk) 17:15, 4 September 2023 (UTC)

String colour notation functions

• complementary colour in RGB colour model ("#FF0000" ⇒ "#00FFFF")
  • Any specification on invalid inputs? MilkyDefer 11:22, 5 August 2023 (UTC)

  Great question. I don't think there is a position documented on Wikifunctions for how to handle invalid input to a function. Can we throw exceptions? Return null? Dhx1 (talk) 13:23, 6 August 2023 (UTC)

  This shouldn't be a string function. This should be a type that represents a RGB color (with corresponding validation function (hopefully it can just be three unsigned 8bit integers)) and a function that returns the complementary color. 0xDeadbeef (talk) 12:38, 7 August 2023 (UTC)

  • Work on the color type has been stalled for over a year. But this task is Done, I have made Complementary colour (Z21554): Get the complementary colour of a given hex code (i.e. #FFFFFF), as a hex code., that uses string hex codes (with or without the initial # and supporting short hex format). This is probably the most optimal format, as I can imagine this function being used on-wiki for thing like the style parameter (CSS) of MediaWiki tags, or of templates etc. There's 5 testcases I've made, which are passed by both my JS and Python versions. :) MolecularPilot (talk) 03:39, 11 January 2025 (UTC)

String notation validation checks

• check if string is an en:International_Chemical_Identifier
  •  Partly done see Validate International Chemical Identifier (Z21539): State whether a given International Chemical Identifier is valid or not.. Supports the verification of the chemical formula and the stereochemical layer. There are 13 testcaes that I've written, all of which are passed by my JavaScript implementation. Note that a python implementation is not possible as the regex module is not available in Wikifunctions. MolecularPilot (talk) 03:09, 11 January 2025 (UTC)
  • To do:
    • Needs to verify the hydrogen and connection sections of the main layer
    • Support the charge layer
    • Support the isotopic layer
  • MolecularPilot (talk) 03:09, 11 January 2025 (UTC)
    • @MolecularPilot: A python impl. is infact possible. I created a basic direct translation at International Chemical Identifier validation, py (Z22823): Description missing. Some tests are failing as the regex needs a bit of sorting out, out of scope for me, but you can give it a try! Keep in mind that you need to escape any \ with a \\ just before saving per Wikifunctions:Python_implementations#Known_limitations_as_of_October_2024. ~/Bunnypranav:<ping> 06:14, 26 February 2025 (UTC)
• check if string is a SMILES arbitrary target specification (SMARTS) notation
• check if string is an ABC notation
• check if string is a LilyPond notation
• Doing... check if string is a portable game notation for a chess game (is portable game notation (Z15867): checks if string is valid Portable Game Notation, figuring out how to add newlines to the test input)
• Done - is Forsyth–Edwards Notation (Z14643): true if the string represents a valid FEN check if string is Forsyth–Edwards Notation for a chess position
• check if string is a UIC classification of locomotive axle arrangements notation
• check if a string is a valid ISBN-13 (probably just a simple variant of is EAN (Z10821): Checks whether the given string is a valid EAN-8, EAN-13, EAN-14, or EAN-18 identifier (with a correct check digit). The function does not validate EAN-2 or EAN-5., dropping/validating the hyphens)
  • Done at is ISBN-13 (Z23561): Check if a given ISBN-13 string is valid. Catch-all ISBN validator at Z16834. Note than ISBN-13 starts with only 978/979, a differing factor from EAN. I have added that in the func and tests as well. ~/Bunnypranav:<ping> 12:53, 26 March 2025 (UTC)
• check if a string is a valid DOI
  • Something about implementation difficulties: https://stackoverflow.com/questions/27910/finding-a-doi-in-a-document-or-page Alexander-Mart-Earth (talk) 14:28, 21 December 2023 (UTC)
• check if a string is a valid ISWN
  • Done, see ISWN validator (Z21562): Check if a number is a valid International Standard Wine Number (ISWN), supports both just the straight up number or a number containing the separator characters (/, . and -).. Contains 6 test cases that I made, all of which are passed by my Python and JavaScript implementations. It supports both just numbers, and a string containing the "separator" symbols (like ., - and /). MolecularPilot (talk) 07:32, 11 January 2025 (UTC)

String validation checks

• check if string is a valid ISO 3166 country code
• check if string is a valid EDTF date/time
• Doing... check if string is a valid email address (watch out, see this list of falsehoods about email addresses to create unit tests - email addresses are more complicated than they seem) — is valid email address (Z10410): Check whether a given string is a valid email address creating test cases in progress. Currently it is stuck on figuring out what exactly is a valid emaill address. Nearly every errata for RFC:3696 is about that.
• Doing... check if string is a valid Wikidata item — is it a valid Qid? (Z10696): Checks if a given string is a valid Qid in Wikidata i.e. if it resolves to an item. (possibly stuck on phab:T343593?)

String analysis functions

• Word frequency counting. Provide a list of words and their frequencies.
  • Done, see Word frequency (Z21593): Count the occurrences of a word in a given sentence. Hyphenated words only count as an occurrence of the full word, i.e. "Wikipedia-isms" isn't an occurrence of "Wikipedia".. Providing a list of words and frequencies would require a new type, so instead it requires the sentence and the word you want to count, and returns the occurrences. Hyphenated words are not considered a match of their components, i.e. "fast-forward" is a match of "fast-forward" but nether "fast" nor "forward", I think this is the optimal behaviour but if someone disagrees we can change it. There is a JS implementation that I made which bases all of my 4 test cases. MolecularPilot (talk) 05:41, 12 January 2025 (UTC)

  @MolecularPilot And I have added a Python implementation at Word frequency counter, python (Z22473): Description missing. I would appreciate if you could attach it! ~/Bunnypranav:<ping> 08:13, 15 February 2025 (UTC)

  Cool, thank you so much for doing it! Someone's already beat me to it re attaching it, but great work! :) MolecularPilot (talk) 21:33, 16 February 2025 (UTC)

String Wikitext operations

...

Natural number

• rectified linear unit (ReLU) - https://www.wikifunctions.org/view/en/Z13909

Integer

• Done - multiply vectors (get cross product (Z21903): Finds the cross product of two integer vectors, get dot product (integer vectors) (Z20659): Finds the dot product of two integer vectors)

Byte

See existing Byte functions in catalogue.

• next byte without overflow: byte → byte
• previous byte without overflow: byte → byte
• next byte by Gray code: byte → byte
• previous byte by Gray code: byte → byte
• get nth bit as Boolean: byte, natural number → boolean

Done at get nth bit as Boolean (Z25426): Get n-th bit of a byte n=0 is the least significant bit.

• highest bit set: byte → boolean

Done at is highest bit set (Z25540): Description missing.

• lowest bit set: byte → boolean

Done at is lowest bit set (Z25548): Description missing

• all bits set: byte → boolean
• no bits set: byte → boolean
• set nth bit: byte, natural number → byte

Done at set nth bit (Z25462): Description missing.

• clear nth bit: byte, natural number → byte

Done at clear nth bit (Z25472): Description missing.

• switch nth bit: byte, natural number → byte

Done at switch nth bit (Z25467): Description missing.

• add bytes without overflow: byte, byte → byte
• subtract bytes without overflow: byte, byte → byte
• multiply bytes without overflow: byte, byte → byte
• clamped add bytes: byte, byte → byte
  • Done at clamped add bytes (Z30275): Description missing.
• clamped subtract bytes: byte, byte → byte
  • Done at clamped subtract bytes (Z30290): Description missing
• clamped multiply bytes: byte, byte → byte
  • Done at clamped multiply bytes (Z30294): Description missing
• add bytes with overflow: byte, byte → byte
• subtract bytes with overflow: byte, byte → byte
• multiply bytes with overflow: byte, byte → byte
• modulo bytes: byte, byte → byte
• byte division: byte, byte → byte
• reverse: byte → byte

Done at reverse byte (Z25585): Reverses a byte.

• right shift: byte → byte
• left shift: byte → byte
• right shift by n: byte, natural number → byte
• left shift by n: byte, natural number → byte
• right shift as ring: byte → byte
• left shift as ring: byte → byte
• right shift by n as ring: byte, natural number → byte
• left shift by n as ring: byte, natural number → byte
• how many bits set: byte → natural number

Done at how many bits set (Z25503): Returns the number of bits set to 1 in a byte.

Unicode code point

See existing code point functions in catalogue.

• Codepoint to list of bytes for UTF-8
• Codepoint to list of bytes for UTF-16
• Codepoint to list of bytes for UTF-32

List

Basic list/iterable functions

• group
• w:Circular shift

Done for shifting by 1 at Circular shift left (Z25526): moves the first element of the list to the end, and moves the remaining elements one position to the left and Circular shift right (Z22179): move the last element of the list to the start, and move all the rest one to the right

Complex list functions

• zip lists together: for [ A .. Z ] and [ 1 .. 26 ] return [ [ A, 1 ], [ B, 2 ], .. ]
  • Unsure what happens if input lists are of different lengths.
  • If possible this function should be able to zip more than 2 lists together... 3, 4, n? Perhaps the input should be list(list, list, list, list, ..).
    • Done zip multiple lists (Z29791): result will be as long as the shortest input list
• remove elements common to second list (Z19198): return the first list with any elements common to the second list removed

CSV list operations

• list of strings to csv
  • Done at list of strings to csv (Z25510): Description missing
• number -> list of decimal digits
  • Done at list of decimal digits in a number (Z25520): returns a list of the decimal digits of a number in starting from the most-significant digit
• number -> list of binary digits
• number -> list of digits in base provided Well very well (talk) 11:20, 18 May 2024 (UTC)

Functions with functions as arguments

• sort, by a given function
  • Done sort list by increasing metric function (Z19510): The metric function should take each object in the list and return a natural number.
    • also order list with comparing function (Z27612): Description missing
• test whether certain functions have specific properties of homogeneous relations for particular lists/sets
• remove first element matching filter from list
  • remove first matching element from list (Z12856), but I think this was meant to be 'filter' as in a predicate, so... compose Z13429(list, Z19602(Z873(pred, list)))

Gregorian calendar date

See catalogue of calendar date functions for existing functions.

• Create a reading function for Dagbani that handles all the possible formats (both the English-linke and the traditional ones, both the Gregorian and the Hijra calendars). Dv103 (talk) 15:43, 31 May 2025 (UTC)
• date before (Z25271): false if equal: date, date → boolean
• later date (Z25276): Description missing: date, date → boolean
• Gregorian dates have same month (Z28570): returns True if the months in two Gregorian dates are the same (ignoring the year): date, date → boolean
• Gregorian dates are same day of month (Z28595): Two Gregorian dates fall on the same day of the month: date, date → boolean
• same day of the year: date, date → boolean
• same calendar year (Z25820): returns true if the two dates are in the same year: date, date → boolean
• same day of the week: date, date → boolean
• within a year: date, date → boolean
• within a week: date, date → boolean
• within n days: date, date → boolean
• years between (Z24918): How many years between two dates?: date, date → natural number
• months between: date, date → natural number
• weeks between: date, date → natural number
• previous calendar day (Z24968): Returns the date of the previous day in the Gregorian proleptic calendar.: date → date
• n days later: date, natural number → date
• n days earlier: date, natural number → date
• n weeks later (Z25907): Description missing: date, natural number → date
• n weeks earlier: date, natural number → date
• n months later: date, natural number → date
• n months earlier: date, natural number → date
• n years later: date, natural number → date
• n years earlier: date, natural number → date
• Julian day number to date: integer → date
• how many leap days passed between two dates: date, date → natural number
• how many weekdays between two dates: date, date, day of the week → natural number
• is Catholic Easter (Z25266): Checks whether a date is Catholic Easter.: date → boolean
• days until next Easter (Z28495): calculate days remaining until next Catholic Easter: date → natural number
• days since last Easter (Z28498): calculating days passed since last Easter: date → natural number
• day of the year (Z25768): returns the number of the days passed from the beginning of the year to this date: date → natural number
• days until the end of the year (Z25775): Description missing: date → natural number
• is proleptic? (Z25280): Returns true if the date is expressed in proleptic Gregorian calendar, i.e. if it is before 15 October 1582: date → boolean
• is valid python datetime date? (Z26369): As described in https://docs.python.org/3/library/datetime.html#date-objects: date → boolean
• within JavaScript's date implementation: date → boolean
• next day with weekday (Z20816): the next day after a date (or that date) with the given weekday.: date, day of the week → date
• next time a day of the month is on a specific weekday: date, natural number, day of the week → date
• next Friday the 13th: date → date
• first weekday of the month (Z25897): Description missing: date, day of the week → date
• last weekday of the month (Z25901): Description missing: date, day of the week → date
• nth weekday of the month: date, day of the week, natural number → date
• nth working days after: date, list of wikidata item references (list of holidays), wikidata item reference (place) → date

Gregorian year

See catalogue of year functions for existing functions.

• display simplified Gregorian year (Z28818): Gregorian year (Z20159), Natural language (Z60) → String (Z6) via Configuration of functions for given languages (Z14294): should avoid negative values by default, so 500 BC is 500, not -499 (designed for contexts where the era is elided, like the first year in “538 to 487 BC”)

Morphological functions

morphology is the part of linguistics that studies how language parts are 'shaped' and change diachronically and when inflected. Hausa, Igbo, Malayalam, Bangla/Bengali and Dagbani are focus languages for Wikidata's lexicographic dataset, which is an important aspect of Abstract Wikipedia.

mul - Multiple languages

• inputs: natural number (new numeric type) and language Z-number; output: 'singular', 'dual', 'paucal', 'plural', etc. as string

  Doing...: (!) return grammatical number for an integer and language (Z15977): Given an integer, what would the grammatical number be when we talk about how often something occurs? (result currently an English string)

ase - American Sign Language

• string: Stokoe to ase-Sgnw and vice-versa (consult @Slevinski: as to best approach)

bzs - Brazilian Sign Language

• SignWriting
• sample text

cy - Welsh

w:en:colloquial Welsh morphology

de - German

• tense * person * number for each verb
  • tenses: present, past, ...?
  • person: first, second, third
  • number: singular, plural
  • Doing... third person singular present
  • second person singular preterite

en - English

• English verb to agent noun (Z11390): morpheme which takes a verb and returns the agent that does that verb Verb -> agent noun, e.g. "dance"->"dancer"
• Join English morphemes (extends suffix English word (Z13254): add any suffix to an English word with regular changes to spelling (monosyllabic or final-syllable stress is generally assumed) to cases like re + en + able + er + s → re-enablers. suffix English word (Z13254): add any suffix to an English word with regular changes to spelling (monosyllabic or final-syllable stress is generally assumed) will correctly join re-enable + ers or re- + enablers, but re + enablers → “renablers” (incorrect). English morpheme agglutination (Z13275): Repeated suffixing of initially empty string tests the Reduce function to produce “detoxification” from a list of four morphemes (orchestrator limit exceeded with five). I doubt we’ll want to derive “toxify” from “toxic”, however.
• Derive lemmas from a form. This is envisaged as the converse of Join English morphemes. The focus would be identifying the base form (the lexeme’s lemma) rather than further segmenting the lemma. For example, “underlay” should return “underlie” (for which it is the past participle) and the noun “underlay” (for which it is the lemma) and (perhaps) the verb “underlay”, which might be the tendency of an unproductive hen or the activity of a carpet-fitter. As this is a purely functional converse, every string will have itself as a possible lemma.
• Generate Numerical prefixes of various kinds from a natural number input.
• sort English adjectives (Z19499): Sort a list of English adjectives into the correct order: quantity, opinion, size, physical quality, shape, age, colour, origin, material, type, purpose. Where equal, leave in original order.

eu - Basque

• Basque language declension system in rather regular based on suffixes.
  • Here a few examples for Basque declension:
    • Basque plural noun (Z18541): This function creates the plural for a noun in Basque
    • Basque ergative singular case declension (Z18670): This function returns the singular ergative case for a noun (proper or not) in Basque language
  • Before implementing all of them, we may propose an overall classification that eases both the implementation and the future usage of the functions. Here a first try based on bibliography from the Basque Language Academy:
    • Personal pronouns: they can be treated as exceptions (e.g. "zuek -> zuei", etc.) together with proper noun declension, or as a separate case.
    • Determiners: they can be treated as exceptions (e.g. "hau" -> "honek", etc) together with common noun declension, or as a separated case
    • Grammatical cases:
      • Absolutive ("Nor"): indefinite, singular and plural
      • Ergative ("Nork"): indefinite, singular and plural
      • Dative ("Nori"): indefinite, singular and plural
    • Place and Time: we must distinguish animate (AN) and inanimate (IN)
      • Inessive IN ("Non"): indefinite, singular and plural
      • Inessive AN ("Norengan"): indefinite, singular and plural - It could be a composition of "Noren" + "-gan"
      • Place and time ("Nongo"): indefinite, singular and plural
      • Allative IN ("Nora"): indefinite, singular and plural
      • Allative AN ("Norengana"): indefinite, singular and plural - It could be a composition of "Noren/Norengan" + "-gan/-a"
      • Finished Allative AN ("Noraino"): indefinite, singular and plural - It could be a composition of "Nora" + "-ino"
      • Finished Allative AN ("Norengainaino"): indefinite, singular and plural - It could be a composition of "Noregana" + "-ino"
      • Right way Allative IN ("Noratz"): indefinite, singular and plural - It could be a composition of "Nora" + "-ntz"
      • Right way Allative AN ("Norenganantz"): indefinite, singular and plural - It could be a composition of "Norengana" + "-ntz"
      • Ablative IN ("Nondik"): indefinite, singular and plural
      • Ablative AN ("Norengandik"): indefinite, singular and plural
    • Rest of the cases:
      • Partitive ("Zerik"): indefinite
      • Possessive ("Noren"): indefinite, singular and plural
      • Sociative ("Norekin"): indefinite, singular and plural
      • Instrumental ("Zerez"): indefinite, singular and plural
      • Motivative ("Zerengatik"): indefinite, singular and plural
      • Destinative ("Norentzat"): indefinite, singular and plural - It could be a composition of "Noren" + "-tzat"
    • Special case:
      • Prolative ("Nortzat"): indefinite
    • To take into consideration:
      • Together with animate and inanimate classification, we should also consider if the noun is a proper noun ("izen berezia"). We can identify that automatically (e.g. check if written in Title case, but this may not be always possible like in the beginning of sentences), but a dedicated function may be preferred (or a boolean to the generic function saying it is a proper noun).
      • The main distinction is between noun ending by vowel or consonant that can be easily computed

fr - French

• French masculine adjective to feminine (Z11590): converts the masculine form of a French adjective to its equivalent feminine form (pre-1990 traditional orthography) Masculine adjective -> feminine, e.g. "exact"->"exacte"
• Conjugated verb => Infinitive, e.g. "alla" => "aller", "mordit" => "mordre"

ha - Hausa

A notated demo sentence ("Aishà taa jeefar dà kàren Indoo" ― "Aisha threw away Indo's dog") is available at http://intent.xigt.org

ldn - Láadan

section moved to WF:human languages/Z1882

kcg - Tyap

• Tyap has six determiners/definite articles which determine the pronoun, number (1-5), etc. forms used.
  • ka & wu (basically for singular nouns and adjectives with a few exceptions)
  • hu & ji (for singular and plural nouns and adjectives)
  • ba & na (mainly for plural nouns.
    • Determiners come after nouns.
    • When an adjective comes before a noun, the determiner used is that of the adjective. E.g., a̱sham (ka) - (the) beautiful, kyang (hu) - (the) thing = a̱sham kyang (ka) - (the) beautiful thing.
• Tyap has a non-uniform noun class system used for noun pluralization and conversion from one part of speech to another. E.g., a̱bwom (song) and bwom (to sing), a̱fufwuo (ears) and fufwuo (ear).
• Affixation: Prefixes exist but suffixes hardly are found.

Proposed functions requiring future types

Note these functions cannot be implemented properly until the needed types are requested and approved.

If one wishes to nevertheless attempt to define and implement them,

• the functions and implementations should indicate prominently in their labels that their input/output types must be adjusted once support for the appropriate replacement types become available; and
• the functions should not be used in the implementations of any other functions, as the later adjustment of input/output types to appropriate replacements will break those implementations.

String analysis functions

• count distance between two letters in given alphabet (default to 26-charcater western alphabet. case insensitive. e.g. "a" & "A" ⇒ 0; "K" & "N" ⇒ 3)

String encoding and decoding functions

(would be better with types representing a stream of bytes)

• BASE45 encode
• BASE45 decode
• Hexadecimal UTF-8 encode ("ABC ₤" ⇒ "41 42 43 20 E2 82 A4")
• Hexadecimal UTF-8 decode ("41 42 43 20 E2 82 A4" ⇒ "ABC ₤")
• Decimal UTF-8 encode ("ABC ₤" ⇒ "65 66 67 32 226 130 164")
• Decimal UTF-8 decode ("65 66 67 32 226 130 164" ⇒ "ABC ₤")
• Octal UTF-8 encode ("ABC ₤" ⇒ "101 102 103 40 342 202 244")
• Octal UTF-8 decode ("101 102 103 40 342 202 244" ⇒ "ABC ₤")
• Binary UTF-8 encode ("ABC ₤" ⇒ "01000001 01000010 01000011 00100000 11100010 10000010 10100100")
• Binary UTF-8 decode ("01000001 01000010 01000011 00100000 11100010 10000010 10100100" ⇒ "ABC ₤")
• Unicode code point encode ("ABC ₤" ⇒ "41 42 43 20 20A4") - Unicode code point encode hex (Z10785): Takes a Unicode string and returns a space-separated list of hexadecimal Unicode code points.
• Unicode code point decode ("41 42 43 20 20A4" ⇒ "ABC ₤")
• Create regular expression object/string (i.e: "test" & "i" to /test/i)

Natural language functions

• Choose singular or plural based on number (e.g. singularOrPlural("person",6") -> "people")
  • Note that there are also dual and other grammatical numbers in other languages. 魔琴 (talk) 18:54, 26 October 2023 (UTC)
  • relevant interwiki link: d:WD:property proposal/plural forms Arlo Barnes (talk) 04:15, 9 February 2024 (UTC)

    Was rejected.

    The similar proposal has grammatical number (P13986) was accepted, but per the comments on your proposal, just having that set (and mapping it to one of our enums) isn't sufficient since a language might have exceptions to its conjugation rules, or handle rational/real numbers in different ways.

    Being able to make use of CLDR data might still be desirable to avoid hardcoding rules and exceptions into Functions. YoshiRulz (talk) 02:16, 18 December 2025 (UTC)

  • This is duplicated with a suggestion above. There's some work done already: Z15977. We also have lightweight enums like Grammatical number (singular / dual / plural) (Z28215) now. YoshiRulz (talk) 21:11, 30 November 2025 (UTC)

Cryptographic functions

(would be better with types representing a stream of bytes)

• To do MD2 - MD2 Hashing (Z10135): Description missing
• To do MD4 - MD4 (Z10136): Description missing
• To do MD5 - MD5 (Z10137): calculate Message Digest 5 (MD5) hash for given string
• To do RIPEMD-128 - RIPEMD-128 (Z10138): Description missing
• To do RIPEMD-160 - RIPEMD-160 (Z10139): Description missing
• To do BLAKE2b-160 - BLAKE2b-160 (Z10140): Description missing
• To do BLAKE2b-256 - BLAKE2b-256 (Z10141): Description missing
• To do BLAKE2b-384 - BLAKE2b-384 (Z10142): Description missing
• To do BLAKE2b-512 - BLAKE2b-512 (Z10143): Description missing
• To do BLAKE2s-128 - BLAKE2s-128 (Z10144): Description missing
• To do BLAKE2s-160 - BLAKE2s-160 (Z10145): Description missing
• To do BLAKE2s-224 - BLAKE2s-224 (Z10146): Description missing
• To do BLAKE2s-256 - BLAKE2s-256 (Z10147): Description missing
• To do SHA-224 - SHA-224 (Z10149): Description missing
• To do HMAC-SHA-256
• To do SHAKE-128 - SHAKE128 (Z10150): expandable output function (XOF) specified by NIST FIPS 202
• To do SHAKE-256 - SHAKE256 (Z10151): expandable output function (XOF) specified by NIST FIPS 202
• To do ChaCha20 - ChaCha20 (Z25376): Generate a ChaCha20 block from a key, a counter and a nonce value. The key is a 64 character hex string and both the counter and nonce are 64 bit integers that will be encoded as little-endian.
• To do X25519 - X25519 (Z25393): Multiply a point on Curve25519 by a scalar
• To do Keccak-f[1600] - Keccak-f[1600] (Z25399): Keccak-f[1600] permutation specified in FIPS 202.

Colour functions

• return colour contrast ratio (per ) of two RGB colours (provided as strings e.g. "#FF0000")
  • Done at colour contrast ratio (Z13028): returns colour contrast ratio 'X:1' for given hex colours

Date, time, and calendric functions

Discussion of types: WF:type#Calendar types

Bengali calendar

Gregorian to Bengali date (Bangladesh) (Z12926): Converts a Gregorian date to Bangla date per Bangladeshi calendar. Inputs: Year, Month, Day.

French Republican Calendar

decimalises and secularises the Gregorian

• day names: is the day name part of the French Republican Calendar 'rural' naming? (Z13006): tests if input is one of the French-language names for days in the FRC Not done yet

Gregorian

widely used calendar derived from the Julian, basis for ISO 8601

• date to ISO week number ISO week date (Q2110154)
• string to date
• date to ISO 8601 string

  Done, see date string (English) to ISO 8601 (Z21842): Converts a date string in a non-ISO 8601 format to its equivalent ISO 8601 string. Input must use English or other format. --Sbb1413 (talk) 18:47, 21 January 2025 (UTC)

• date to year (yyyy)
• date to month of the year (1-12)
• date to month name (January-December)
• date to day of the month (1-31)
• date to hour of the day (0-23)
• date to minutes (0-59)
• date to seconds (0-59)

Named Day from Date or day of year ; Input type : Date ; Output Type : String. ; The initial use case was automated population of On The Day, based on various collections of Holidays, festival days and observances. ? ShakespeareFan00 (talk) 19:35, 26 March 2025 (UTC)

So If you gave it 2025-05-01 It said "All Fools Day" etc.. Possibly an additional input of enumrated type to indicate which data set to pull holidays, fesitvals and observances from.

ShakespeareFan00 (talk) 19:35, 26 March 2025 (UTC)

Diary/calander Header function - Using the above and other date functions, generates a data set from a given date. Hence if you give it 2003-05-01 you get back a JOSN set contianing the {Day of week:String, Day in the Month, Observances} etc. ShakespeareFan00 (talk) 19:35, 26 March 2025 (UTC)

Holocene calendar

• w:en:Holocene calendar#Conversion

  Done, see Gregorian to Holocene year (Z21913): Converts a given Gregorian year to Holocene year.. --Sbb1413 (talk) 13:30, 25 January 2025 (UTC)

Islamic

a Lunar calendar, also called Hijri

Julian

mostly used by astronomers, some historians, and some Orthodox Christian denominations

Mesoamerican calendars

including civil and clerical forms

Persian

also called Jalali

Darian calendar

Proposed time-keeping system for Mars, requires Julian Date/Time to calculate and a month enumeration: WF:type proposals#Something to think about

Basic numerical functions

• round up ("1.289" & "2" ⇒ "1.29"; "5678" & "2" ⇒ "5700")

  So if the number is floating point, round to n decimal places, and if not, round to n significant figures. Is that right? BrightSunMan (talk) 19:36, 24 December 2023 (UTC)

  Done ceiling of rational number (Z20053)/ceiling (float64 to float64) (Z21043) and round rational to fixed decimal places, simplified (Z27705)/round to decimal places (float64) (Z21047)

• round down
  • Done floor of rational number (Z20032)/floor (float64 to integer) (Z20841)
• return integer value (5678.678 ⇒ 5678)
  • Done rational to nearest integer, even integer tiebreak (Z19841)/round float64 (ties to even, as Integer) (Z26315)
• English cardinal (Z13587): expresses a natural number in English words (23 ⇒ "twenty-three")
• Convert money from US$ to anything else
  • requires source of conversion rates, which is a hole in function-likeness
• Arabic numeral to Etruscan numeral
• Etruscan numeral to Arabic numeral

Data serialization functions

• parse a string as JSON
• extract string from JSON object based on JSONPath ({"name":"Alice"}, "$.name" ⇒ "Alice")

  Why not first convert a JSON string to an object, and then have a function that extracts fields based on JSONPath? Doing Stringly-typed things like this proposal as defined isn't a good idea. 0xDeadbeef (talk) 16:16, 5 August 2023 (UTC)

  This seems to be a good idea, thanks! I moved and splitted the proposal accordingly. --1-Byte (talk) 09:51, 6 August 2023 (UTC)

  is it okay to go ahead to create this 'extract string from JSON object based on JSONPath' as a function ? Dolphyb (talk) 16:14, 15 February 2024 (UTC)

Basic list/iterable functions requiring numeric types

• Sum the elements of a numeric list - sum the elements of a list of natural numbers (Z14038): given a list of numeric values return the sum of all the values in the list otherwise return 0 when list is empty
• Product of the elements of a numeric list
  • Done product of list (Rational numbers) (Z23909)/product of list (natural numbers) (Z13558)
• flatten untyped list (Z12676): flatten an (untyped) list to limited depth
• Slice of list elements: for the supplied list, return a list of elements that are at indexes between a supplied range n:m
  • Zero indexing is used (first element is index 0)?
  • n and m are are included in the range?
  • What happens if n and/or m are invalid indexes?
  • Done take sub-sequence of list (Z26556): clamps indices to valid range (1..=N); returns empty if end < start
• Remove slice of elements from list: return the supplied list with elements between a supplied range of indexes removed
  • Zero indexing is used (first element is index 0)?
  • n and m are are included in the range?
  • What happens if n and/or m are invalid indexes?
• Every nth element of list: returns every nth element of the supplied list
  • Done every nth item of list (Z28735): Returns every nth item of a list. For example, "3" and a list of 10 items would return the 3rd, 6th, and 9th item.
• Remove every nth element of list: removes every nth element of the supplied list -
• sample n objects from list (return up to n random objects from the list)
• Jaccard similarity coefficient (see https://en.wikipedia.org/wiki/Jaccard_index)
• Weighted average. Supply a list of values, and a second list of the same length of their weights. Returns a weighted average
  • Example Input: values = [10, 20, 30], weights = [1, 2, 3]
  • Output: 23.33
  • Done weighted average (floating point values) (Z28066): Weighted Average = sum(value * weight) / sum(weight) Lists must be equal length.

Geodetics functions

w:en:planetary coordinate system, w:en:well-known text representation of coordinate reference systems

Earth

• convert coordinates outside of the ranges (-180, 180) for longitude and (-90, 90) for latitude to a canonical form
• Plus Codes to/from geocoordinates
  • functions should match the semantics of the expected API: is valid Plus Code?, is shortened Plus Code?, is full Plus Code?, Plus Code from co-ordinates (Z25963): only works with WGS84, co-ordinates from Plus Code (SW corner), shorten Plus Code, recover nearest Plus Code
  • implementations for JS and Python are provided, Apache 2.0 licenced, not sure how self-contained they are
  • most of the functions could also be implemented by composition
  • sample data is provided for testing (it's ~500 cases for each of encode/decode and ~50 cases for each of the others, but they're grouped nicely so maybe take 1 from each)

Mars

w:en:areography#Cartography and geodesy

• convert coordinates outside of the ranges [0, 360) for longitude and (-90, 90) for latitude to a canonical form

Moon

w:en:selenography#Lunar cartography and toponymy

Unit conversion functions

• Fahrenheit to Celsius (Z15560): Converts Fahrenheit (°F) to Celsius (°C)

Conversion function : 2D Cartesian to 2D Polar

Input : matrix [x,y] Output: matrix [θ,r] Short text : Polar conversion of x,y to a polar space centred at 0,0 in the Cartesian. Constraints: x,y,r are reals (float64), θ lies in the range -π<0<π (Sign determined in relation to standards used in STEM applications. ShakespeareFan00 (talk) 14:30, 26 March 2025 (UTC)

The companion could also be provided. As I never did Geodetic functions, I am not sure how Lat, Long to map projection would work , but useful. ShakespeareFan00 (talk) 14:30, 26 March 2025 (UTC)

See also WF:Type proposals/complex128. YoshiRulz (talk) 10:17, 1 December 2025 (UTC)

Trigonometric functions

• sine (float64, rad) (Z16463), cosine (Z12473),

  Input : float64 Angle in radians.

  Output : float64 desired trignometric value

ShakespeareFan00 (talk) 19:40, 26 March 2025 (UTC)

• Rotate a 2D point about origin (Z29125)

  Inputs: 2D Point (float64s, Reals, or perhaps a single complex number), angle (float64 or Real)

  Output: 2D Point (matching the input type)

  Not necessarily one single function; one can be created for each input type

WrenFalcon (talk) 22:05, 31 July 2025 (UTC)

Function proposal : Decimalise angle of the form ('1:x' or '1 in x') to % (in 100) or ‰ (in 1000)

• Suggested name: gardient_decimal.
• Input type: Integer ( The 1 is implied.). Lower Bound +1: Upper Bound: 1000 (for most practical situations?)
• Output type: Real/float 64.

Proposer: ShakespeareFan00 (talk) 19:05, 28 March 2025 (UTC)

Color Functions

Colorspace Conversion

x,y,Y to sRGB (Illuminant D65). Input : 3tuple of float64, Output: 3 tuple of integer, where 0>=r<=255, 0>=g<=255 0>=b<=255.

Convert a color specfied as 3 float64 values, from x,y,Y colorspace to sRGB or raise an "Out of Gaumt" exception. ShakespeareFan00 (talk) 19:09, 7 April 2025 (UTC)

Spectral Approximate from sRGB or XYZ values.

I'd like to see the techniques detailed here: http://scottburns.us/reflectance-curves-from-srgb/ implemented in Wikifunctions as the provided spreadhseet later in the paper doesn't appear to work with Libre Office. ShakespeareFan00 (talk) 19:32, 2 June 2025 (UTC)

Subtractive color mix (Pigment style)

Implement the mixing function from Spectral.js (https://github.com/rvanwijnen/spectral.js/blob/3.0.0/spectral.js )(MIT license), to allow 2 or more sRGB triplets to be mixed like pigment colors. This is different from the subtract colors function implemented previously.

Music Functions

It would be nice to have 12 equal temperament pitch class and 12 equal temperament pitch types, as they would be useful for calculating harmonies and melodies. The pitch classes could be stored as natural numbers from 0 to 11, and represented with symbols C, C♯, D, ..., B. The pitches could be stored as integers with -1 being B3, 0 being C4, 1 being C♯4, etc. Over time, we could expand the pitch class and pitch types to other temperaments and just intonation. As I'm new to Wikifunctions and my coding skills are next to zero, this is just a suggestion to the community. (edited) CaffeineP (talk) 14:48, 9 April 2025 (UTC)

Yes… There are some notational challenges because of enharmonics as well as naming conventions varying by language/culture, so English A♯ is equivalent to German B and English B♭, for example. Ideally, I would want the (English) pitch class that is five semitones higher than G♭ to be displayed as C♭ rather than B.

Also, given some reference pitch like A4 = 440 Hz, we should be able to return the frequency in hertz of a given pitch and, conversely, the nearest pitch for a given frequency and its offset in cents (or whatever). The computation is a lot simpler than representing the result (or capturing how the result should be represented)! GrounderUK (talk) 20:08, 9 April 2025 (UTC)

If you use the cardinal values for the pitches from the MIDI standard (or an extension to such, since they're limited to 0..<128) then you could make some of these functions already, no type proposal needed. Granted a lot of them would just be addition/subtraction. And if you semi-arbitrarily map A = 0, A# = 1, etc. then you could do all of them. YoshiRulz (talk) 10:33, 1 December 2025 (UTC)

• 12-ET Pitch Class of a Pitch: Return the 12 equal temperament pitch class of a given 12 equal temperament pitch. For example, C4 returns C.
• 12-ET Pitch based on Pitch Class: Return a 12 equal temperament pitch based on a given 12 equal temperament pitch class and a given integer. For example, C and 4 return C4.
• Interval between 12-ET Pitch Classes in Semitones: Get the interval in semitones between two 12 equal temperament pitch classes, always assuming that the first is lower than (or the same as) the second, and the interval is less than an octave. For example, C and B return 11, while B and C return 1.
• Interval between 12-ET Pitches in Semitones: Get the interval in semitones between two 12 equal temperament pitches. For example, C4 and B3 return -1, while C3 and B4 return 23.
• Raise 12-ET Pitch Class by Semitones: Get a new 12 equal temperament pitch class through raising a given pitch class by the provided number of semitones. For example, raising B by 1 semitone returns C.
• Lower 12-ET Pitch Class by Semitones: Same as above, but lower the pitch class instead of raising it.
• Raise 12-ET Pitch by Semitones: Get a new 12 equal temperament pitch through raising a given pitch by the provided number of semitones. For example, raising B3 by 1 semitone returns C4.
• Lower 12-ET Pitch by Semitones: Same as above, but lower the pitch instead of raising it.
• Frequency of a 12-ET Pitch: Return a float64 frequency in Hz based on the provided 12 equal temperament pitch (and possibly a reference pitch with its frequency; if not provided, take default A4 = 440 Hz).
• Approximate 12-ET Pitch Class based on Frequency: Return a 12 equal temperament pitch class approximately based on the provided frequency in Hz.
• Approximate 12-ET Pitch based on Frequency: Return a 12 equal temperament pitch approximately based on the provided frequency in Hz.

SVG Functions

I would be nice to generate SVG (a XML-based vector image format which is basically a long string), it could allow to replace a lot of images on Commons or templates/tools. Here some examples:

• create simple forms,
• create graphs (line graph/bar graph for population or for production, elections diagrams like File:1900Hawaii.svg, etc.),
• create more complex visualisation like genealogical trees,
• create coat of arms (?),
• etc.

Cheers, VIGNERON (talk) 10:47, 23 April 2025 (UTC)

@VIGNERON: Eventually that is something we might support, but there'll be nothing any time soon. It has a number of complex security and scalability concerns, sadly. Jdforrester (WMF) (talk) 13:21, 23 April 2025 (UTC)

@Jdforrester (WMF): thanks. I talked about it for the last Corner but I wanted to leave a record here, if we have time, maybe I'll use that time to write some things to prepare (like listing templates and tools on the Wikimedia projects that generate SVG or visualisations). Cheers, VIGNERON (talk) 15:28, 23 April 2025 (UTC)

Of course! I've explicitly added a section on this here: Wikifunctions:Embedded function calls#Non-text output — hope that helps assure you that we're thinking about it. Jdforrester (WMF) (talk) 21:40, 23 April 2025 (UTC)

Biology

Taxon functions

A taxon type could be useful, as could a taxon rank enum (instance of (P31) taxonomic rank (Q427626)). --WrenFalcon (talk) 16:49, 22 September 2025 (UTC)

• Wikidata item representing taxon rank (instance of (P31) taxonomic rank (Q427626)) is at genus level or below
  • Should(?) be possible with the current Wikidata functionality, from what I understand. See Wikifunctions:Project chat#Taxon rank function(s) for a more detailed explanation. --WrenFalcon (talk) 23:27, 16 May 2025 (UTC)
• compare taxon ranks
  • Cases: a < b, a == b, a > b, undetermined/incomparable (if a or b are clades, this should be returned/used)
• get taxon code of nomenclature (code of nomenclature (P944))
• is parent taxon of / is child taxon of
  • is parent taxon of(Taxon a, Taxon b) => b.parent == a OR is parent taxon of(a, b.parent)
• format taxon name (according to relevant rules of nomenclature)
  • Include author and year citation? Maybe page too, if present?

Object / type / function functions

• ZID of object type (Z17893): returns a string with the ZID of the type of the object passed in
• function call of test case (Z21180): returns the function call (Z20K2) that the test case performs
• function called by test case (Z21182): get the function called (Z20K1) from the test case
• function this implementation is implementing (Z21193): Description missing

External function lists

• WF:importing