C ++ snprintf () - Βασική βιβλιοθήκη C ++

Η συνάρτηση snprintf () στο C ++ χρησιμοποιείται για την εγγραφή μιας μορφοποιημένης συμβολοσειράς σε buffer συμβολοσειράς χαρακτήρων.

Σε αντίθεση με το sprintf (), ο μέγιστος αριθμός χαρακτήρων που μπορούν να γραφτούν στο buffer καθορίζεται στο snprintf().

πρωτότυπο snprintf ()

 int snprintf (char * buffer, size_t buf_size, const char * format,…);

Η snprintf()συνάρτηση γράφει τη συμβολοσειρά που επισημαίνεται με μορφή προς αποθήκευση. Ο μέγιστος αριθμός χαρακτήρων που μπορούν να γραφτούν είναι (buf_size-1).

Μετά τη σύνταξη των χαρακτήρων, προστίθεται ένας τελικός μηδενικός χαρακτήρας. Εάν το buf_size είναι μηδέν, τίποτα δεν γράφεται και το buffer μπορεί να είναι μηδενικός δείκτης.

Ορίζεται στο αρχείο κεφαλίδας.

παράμετροι snprintf ()

  • buffer: Δείκτης στο buffer συμβολοσειράς για να γράψετε το αποτέλεσμα.
  • buf_size: Καθορίστε τον μέγιστο αριθμό χαρακτήρων που θα γραφτούν στο buffer που είναι buf_size-1.
  • μορφή: Δείκτης σε μηδενική τερματική συμβολοσειρά που είναι γραμμένη στη ροή αρχείων. Αποτελείται από χαρακτήρες μαζί με προαιρετικούς προσδιοριστές μορφής ξεκινώντας από%.

    Οι προσδιοριστές μορφής αντικαθίστανται από τις τιμές των αντίστοιχων μεταβλητών που ακολουθούν τη συμβολοσειρά μορφής.

    Ο προσδιοριστής μορφής έχει τα ακόλουθα μέρη:

    • Ένα κορυφαίο σύμβολο%
    • Σημαίες: Προαιρετική μία ή περισσότερες σημαίες που τροποποιούν τη συμπεριφορά μετατροπής.
      • -: Αριστερά αιτιολογήστε το αποτέλεσμα στο πεδίο. Από προεπιλογή, δικαιολογείται σωστά.
      • +: Το σύμβολο του αποτελέσματος επισυνάπτεται στην αρχή της τιμής, ακόμη και για θετικά αποτελέσματα.
      • Space: Εάν δεν υπάρχει σημάδι, ένα κενό είναι προσαρτημένο στην αρχή του αποτελέσματος.
      • #: Εκτελείται μια εναλλακτική μορφή μετατροπής.
      • 0: Χρησιμοποιείται για ακέραιο και κυμαινόμενο αριθμό. Τα κορυφαία μηδενικά χρησιμοποιούνται για να γεμίσουν τους αριθμούς αντί για κενό.
    • Πλάτος: Μια προαιρετική * ή ακέραια τιμή που χρησιμοποιείται για τον καθορισμό του πεδίου ελάχιστου πλάτους.
    • Ακρίβεια: Ένα προαιρετικό πεδίο που αποτελείται από ακολουθούμενο από * ή ακέραιο ή τίποτα για να καθορίσετε την ακρίβεια.
    • Μήκος: Ένας προαιρετικός τροποποιητής μήκους που καθορίζει το μέγεθος του ορίσματος.
    • Καθορισμός: Ένας προσδιοριστής μορφής μετατροπής. Οι διαθέσιμοι προσδιοριστές μορφής είναι οι εξής:
      Προσδιοριστής μορφής Περιγραφή
      % Εκτυπώσεις%
      ντο Γράφει έναν μόνο χαρακτήρα
      μικρό Γράφει μια συμβολοσειρά χαρακτήρων
      δ ή ι Μετατρέπει έναν υπογεγραμμένο ακέραιο σε δεκαδική αναπαράσταση
      ο Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε οκταδική αναπαράσταση
      X ή x Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε δεκαεξαδική αναπαράσταση
      εσύ Μετατρέπει έναν μη υπογεγραμμένο ακέραιο σε δεκαδική αναπαράσταση
      F ή f Μετατρέπει τον αριθμό κυμαινόμενου σημείου στην δεκαδική αναπαράσταση
      Ε ή ε Μετατρέπει τον αριθμό κυμαινόμενου σημείου στην υποδιαστολή του δεκαδικού εκθετικού
      Α ή α Μετατρέπει τον αριθμό κυμαινόμενου σημείου στον δεκαεξαδικό εκθέτη
      G ή g Μετατρέπει τον αριθμό κυμαινόμενου σημείου σε δεκαδικό ή δεκαδικό εκθετικό συμβολισμό
      ν Επιστρέφει τον αριθμό των χαρακτήρων που έχουν γραφτεί μέχρι στιγμής από αυτήν την κλήση στη συνάρτηση. Το αποτέλεσμα γράφεται στην τιμή που δείχνει το όρισμα
      Π Γράφει μια ακολουθία χαρακτήρων που καθορίζεται από την εφαρμογή και καθορίζει έναν δείκτη.

      Έτσι, η γενική μορφή του προσδιοριστή μορφής είναι: %(flags)(width)(.precision)(length)specifier

  • …: Άλλα πρόσθετα επιχειρήματα που καθορίζουν τα δεδομένα που θα εκτυπωθούν. Εμφανίζονται σε μια ακολουθία σύμφωνα με τον προσδιοριστή μορφής.

snprintf () Επιστροφή τιμή

Εάν είναι επιτυχής, η snprintf()συνάρτηση επιστρέφει αριθμό χαρακτήρων που θα είχαν γραφτεί για αρκετά μεγάλο buffer, εξαιρουμένου του μηδενικού χαρακτήρα τερματισμού. Σε αποτυχία επιστρέφει μια αρνητική τιμή.

Η έξοδος θεωρείται ότι έχει γραφτεί εντελώς εάν και μόνο εάν η επιστρεφόμενη τιμή είναι μη αρνητική και μικρότερη από το buf_size.

Παράδειγμα: Πώς λειτουργεί η λειτουργία snprintf ()

 #include #include using namespace std; int main() ( char buffer(100); int retVal, buf_size = 100; char name() = "Max"; int age = 23; retVal = snprintf(buffer, buf_size, "Hi, I am %s and I am %d years old", name, age); if (retVal> 0 && retVal < buf_size) ( cout << buffer << endl; cout << "Number of characters written = " << retVal << endl; ) else cout << "Error writing to buffer" << endl; return 0; )

Όταν εκτελείτε το πρόγραμμα, η έξοδος θα είναι:

 Γεια, είμαι ο Max και είμαι 23 ετών Αριθμός χαρακτήρων που γράφτηκαν = 34

ενδιαφέροντα άρθρα...