Τηλεκατευθυνόμενο αυτοκίνητο

Συναρτήσεις

Μπορείς να ορίσεις τις δικές σου προσαρμοσμένες συναρτήσεις στο jq για να ενσωματώσεις όποια λογική χρειάζεσαι. Οι συναρτήσεις λειτουργούν ακριβώς όπως οι ενσωματωμένες: παίρνουν μια είσοδο και παράγουν μηδέν, μία ή περισσότερες εξόδους.

Ορισμός συνάρτησης

Μπορείς να ορίσεις μια συνάρτηση jq χρησιμοποιώντας την εξής σύνταξη:

# no arguments
def funcname: expression;

# or with arguments
def funcname(args): expression;

• ξεκινάει με τη λέξη-κλειδί def,
• άνω κάτω τελεία πριν από το σώμα της συνάρτησης,
• το σώμα αποτελείται από μία μόνο έκφραση,
• τελειώνει με ερωτηματικό,
• όπως και στην υπόλοιπη σύνταξη του jq, μπορείς να χρησιμοποιήσεις όποια κενά θέλεις για ευαναγνωσιμότητα.

Πού να βάζεις τις συναρτήσεις

Οι συναρτήσεις πρέπει να ορίζονται πριν χρησιμοποιηθούν: αυτό είναι σφάλμα:

def A: B(10);
def B(n): n + 1;
A
# => error: B/1 is not defined

Αυτό σημαίνει ότι πρέπει να τοποθετείς τις συναρτήσεις στην αρχή του κώδικα jq, πριν από την "κύρια" έκφραση.

Εμφωλευμένες συναρτήσεις

Οι συναρτήσεις μπορούν να είναι εμφωλευμένες:

def A:
    def B(n): n + 1;
    B(10)
    ;
A
# => 11

Εδώ, η συνάρτηση B είναι ορατή μόνο στο σώμα της A.

Εμβέλεια

Μια συνάρτηση εισάγει μια νέα εμβέλεια για μεταβλητές και εμφωλευμένες συναρτήσεις.

Ορίσματα

Τα ορίσματα συνάρτησης χωρίζονται με ερωτηματικά και όχι με κόμματα. Για παράδειγμα, μια συνάρτηση που παίρνει έναν αριθμό, και μετά προσθέτει έναν αριθμό και πολλαπλασιάζει με έναν αριθμό:

def add_mul(adder; multiplier): (. + adder) * multiplier;

10 | add_mul(5; 4)    # => 60

10 | add_mul(5, 4)
# error: add_mul/1 is not defined

Τα ορίσματα είναι εκφράσεις

Τα ορίσματα συνάρτησης είναι φίλτρα, όχι τιμές. Με αυτή την έννοια, λειτουργούν όπως αυτό που άλλες γλώσσες περιγράφουν ως callbacks:

Χρησιμοποιώντας τη συνάρτηση add_mul ως παράδειγμα:

10 | add_mul(. + 5; . - 2)    # => 200

Τι συμβαίνει εδώ;

• το όρισμα adder παίρνει την έκφραση . + 5
  • όταν η συνάρτηση κάνει . + adder, αυτό γίνεται . + . + 5
  • αυτό αξιολογείται σε 25 αφού . == 10
• παρομοίως, το όρισμα multiplier είναι η έκφραση . - 2
  • αυτό αξιολογείται σε 8
  • μετά το αποτέλεσμα είναι 25 * 8 == 200

Ορίσματα ως τιμές

Μερικές φορές θα θέλεις να "υλοποιήσεις" ένα όρισμα σε μια μεταβλητή:

def my_func(arg):
    arg as $arg
    | other stuff ...
;

Υπάρχει μια συντομογραφία για αυτό:

def my_func($arg):
    other stuff ...
;

Σημείωσε ότι αυτό είναι απλώς "συντακτική ζάχαρη": το όνομα arg χωρίς $ είναι ακόμα στην εμβέλεια της συνάρτησης.

Πλήθος ορισμάτων

Οι συναρτήσεις έχουν ένα πλήθος ορισμάτων: τον αριθμό των ορισμάτων που δέχονται.

Οι συναρτήσεις μπορούν να χρησιμοποιήσουν το ίδιο όνομα με διαφορετικά πλήθη ορισμάτων. Η ενσωματωμένη συνάρτηση range το δείχνει αυτό: τα range/1, range/2 και range/3 συνυπάρχουν.

Αυτό μπορεί να είναι χρήσιμο για τον ορισμό αναδρομικών συναρτήσεων που μεταφέρουν κατάσταση μέσω ορισμάτων. Για παράδειγμα, η map θα μπορούσε να υλοποιηθεί ως εξής:

def my_map($accumulator; func):
    if length == 0
        then $accumulator
        else first as $elem | .[1:] | my_map($accumulator + [$elem | func]; func)
    end
    ;

def my_map(func):
    my_map([]; func)
    ;

[1, 2, 3, 4] | my_map(. * 10)   # => [10, 20, 30, 40]

Αναδρομή

Το jq θα εκτελέσει βελτιστοποίηση ουράς, αλλά μόνο για συναρτήσεις με 0 ορίσματα.

Ενότητες

Μια ενότητα jq είναι ένα αρχείο που περιέχει μόνο συναρτήσεις. Οι ενότητες συμπεριλαμβάνονται σε ένα πρόγραμμα jq με τις εντολές include ή import.